Getting Started

Sections

Theme switcher

Top Sites Ranking

Returns last month's top websites in a given category.

Output Fields:

  • domain: The domain of the ranked website in a given category
  • category_rank: Rank of the website within its industry category (1 is best)

This endpoint uses data credits. Read the following guide to estimate the credit costs.

Constraints:

  • Returns current top sites data (no time series) for up to the last 3 months
  • Only monthly granularity is supported
  • Data is limited to 1 last month for specific desktop/mobile web channel and up to 3 months for the 'total' channel

Header Parameters

api-keystring

Query Parameters

categorystring Required

Website industry category identifier

start_datestring Required

Start date in 'YYYY-MM'

end_datestring Required

End date in 'YYYY-MM'

granularitystring Required

Time granularity

Enum values:
dailyweeklymonthly
web_sourcestring

Specifies the web source device type

Enum values:
desktopmobile_webtotal
countrystring Required

Two-letter country code (e.g., 'us', 'gb', 'ww')

channelstring

Type of traffic source

Enum values:
totalsearchorganic_searchpaid_searchsocialdisplay_adsreferraldirectmail
formatstring

Format in which the reply should be returned.

Enum values:
jsonxml
limitinteger

Number of items per page for pagination, default is 100

offsetinteger

Page number for pagination, starting from 1

ascboolean

Sort order direction, 'true' for ascending, 'false' for descending. Default is 'false'

Nullable:
True
sortstring

Sort order for the results, applied on the properties of the returned record

Response

200
Object
Success

Response Attributes

metaobject

Show child attributes

dataarray
Nullable:
True

Show child attributes

Was this section helpful?

What made this section unhelpful for you?

GET

/

Select
1

Response

Was this section helpful?

What made this section unhelpful for you?

View as Markdown

Ask an AI

Open in ChatGPTOpen in Claude

Code with AI