Top Sites - Total (Desktop & Mobile Web)

get https://api.similarweb.com/v4/website/${category}/topsites/total

Returns last month's top websites in a given category. Based on desktop and mobile web traffic.

Device	Granularity	Metrics
total: desktop and mobile combined	previous month only	domain

📘
Price
1 hit per request or 100 data credits (each request to this endpoint will return 100 results). Scrolling this data is available via the "page" parameter.

This endpoint can return up to 10,000 results but may be limited by the number of results included in your package.

Path Params

category

string

required

Defaults to all

Category can be either "$All" or "${Category}", where {Category} is one value from the list available here: https://api.similarweb.com/v1/TopSites/categories.

Query Params

api_key

string

required

Defaults to Add_Your_API_KEY

Your Similarweb API key.

start_date

string

required

Defaults to Last_Month

Must be set to the last month of available data, in the YYYY-MM format. To retrieve, use the Check Capabilities endpoint and get the value returned in web_desktop_data/snapshot_interval/end_date.

end_date

string

required

Defaults to Last_Month

Must be set to the last month of available data, in the YYYY-MM format. To retrieve, use the Check Capabilities endpoint and get the value returned in web_desktop_data/snapshot_interval/end_date.

country

string

required

Defaults to us

Country filter, as a 2-letter ISO country code, or "world" for worldwide. To see the country filters you have access to, please refer to the Check Capabilities endpoint.

format

string

Defaults to json

[optional] Format in which the reply should be returned. Possible values: 'json' (default) or 'xml'.

limit

string

Defaults to 100

[optional] Select the number of results that are returned. Default: 100.

offset

string

[optional] Specify an offset from where to start returning data.

sort

string

[optional] The metric you'd like the results to be ordered by.

asc

string

[optional] The order of results. Enter "true" for ascending, or "false" for descending.

Response

Language


xxxxxxxxxx
1
curl --request GET \
2
     --url 'https://api.similarweb.com/v4/website/$all/topsites/total?api_key=Add_Your_API_KEY&start_date=Last_Month&end_date=Last_Month&country=us&format=json&limit=100' \
3
     --header 'accept: application/json'


xxxxxxxxxx
44
}
1
{
2
  "meta": {
3
    "query": {
4
      "limit": 5,
5
      "offset": 0,
6
      "asc": null,
7
      "sort": null
8
    },
9
    "request": {
10
      "main_domain_only": false,
11
      "show_verified": false,
12
      "state": null,
13
      "format": "json",
14
      "domain": "$Arts_and_Entertainment~Music",
15
      "start_date": "2022-09-01",
16
      "end_date": "2022-09-30",
17
      "country": "gb"
18
    },
19
    "status": "Success",
20
    "last_updated": "2022-09-30"
21
  },
22
  "top_sites": [
23
    {
24
      "rank": 1,
25
      "domain": "spotify.com"

📘Price

200200

📘
Price