# Semrush Trending Websites

Returns the 100 trending websites Semrush ranks for one country and category facet pair, with traffic, device split, month-over-month and year-over-year change, plus the aggregated 12-month traffic series. Country and category slugs are validated against the facets endpoint enumerations.

- **Documentation:** [https://scrappa.co/docs/semrush-api/semrush_trending](https://scrappa.co/docs/semrush-api/semrush_trending)
- **API group:** Semrush API
- **Endpoint:** `GET https://scrappa.co/api/semrush/trending`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `country` | string | No | Trending country code (e.g. us, de, global). Defaults to us. See the facets endpoint for the full list. |
| `category` | string | No | Trending category slug (e.g. all, arts_and_entertainment). Defaults to all. See the facets endpoint for the full list. |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/semrush/trending?country=global&category=all"
```

## Example response

```json
{
    "search_parameters": {
        "engine": "semrush_trending",
        "country": "global",
        "category": "all"
    },
    "country": "global",
    "category": "all",
    "domains": [
        {
            "domain": "example.com",
            "total_traffic": 12800000,
            "mom": 0.42,
            "yoy": 3.1,
            "top_source": "search"
        }
    ],
    "traffic_series": [
        {
            "date": "2026-06",
            "traffic": 41200000000
        }
    ]
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A parameter failed validation. |
| 503 | Semrush Upstream Unavailable | Semrush could not be fetched through the configured proxy pool after the full attempt budget. Never charged. |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)