Semrush API: List top websites

Returns the 100 most visited websites for a country and industry, with visits, desktop and mobile split, month-on-month and year-on-year change and the leading traffic source. Defaults to every industry worldwide.

1 credit / requestBilled only on success

Authorization

ApiKeyAuth

x-api-key<token>

In: header

Query Parameters

country?string

Two-letter lowercase country code (e.g. us, de) or global. Every response lists valid codes in available_countries. An unknown code returns null.

Lengthlength <= 20

Default"global"

category?string

An industry slug, e.g. finance, travel-and-tourism, retail, or all for every industry. Semrush publishes 111 of them and every response lists the whole set in available_categories. An unknown slug has no page and returns null.

Lengthlength <= 80

Default"all"

curl -X GET "https://example.com/v1/semrush/trending" \  -H "x-api-key: YOUR_API_KEY"

{  "data": {    "requested_country": "us",    "requested_category": "finance",    "country": "us",    "category": "finance",    "category_id": 35,    "url": "https://www.semrush.com/trending-websites/us/finance",    "as_of": "2026-07-01",    "items": [      {        "rank": 1,        "domain": "yahoo.com",        "visits": 1246948154,        "desktop_visits": 0,        "mobile_visits": 0,        "desktop_share": 42.1,        "mobile_share": 0,        "change_month_percent": 9.225444,        "change_year_percent": -1.5,        "top_traffic_source": "direct"      }    ],    "count": 100,    "total_traffic": 4038663770,    "total_traffic_change_percent": 1.39,    "total_traffic_history": [      {        "date": "2025-08-01",        "traffic": 250427787239      }    ],    "available_countries": [      "ad",      "ae",      "af"    ],    "available_categories": [      "accounting-and-auditing",      "adult",      "advertising-and-marketing"    ],    "usage_note": "A fixed top 100. There is no page 2: page, p, offset and limit were each sent and each returned the same 100 domains in the same order. available_countries and available_categories are Semrush's own vocabularies, read off the page, so the valid inputs are always current."  }}