Docs
Search docs...⌘K

Competitors overview

API + MCP
GET/v3/rank-tracker/competitors-overview

Requests to this endpoint are free and do not consume any API units.

Query parameters

selectstringRequired

A comma-separated list of columns to return. See response schema for valid column identifiers.

wherestring

The filter expression. The following column identifiers are recognized (this differs from the identifiers recognized by the select parameter).

order_bystring

A comma-separated list of columns to order results by, with optional direction. See response schema for valid column identifiers.

Example:field_a,field_b:asc,field_c:desc
limitinteger

The number of results to return.

Default:1000
timeoutinteger

A manual timeout duration in seconds.

volume_modestring

The search volume calculation mode: monthly or average. It affects volume, traffic, and traffic value.

Allowed values:monthlyaverage
Default:monthly
project_idintegerRequired

The unique identifier of the project. You can find it in the URL of your Rank Tracker project in Ahrefs: https://app.ahrefs.com/rank-tracker/overview/#project_id#

devicestringRequired

Choose between mobile and desktop rankings.

Allowed values:desktopmobile
datestring (date)Required

A date to report metrics on in YYYY-MM-DD format.

date_comparedstring (date)

A date to compare metrics with in YYYY-MM-DD format.

outputstring

The output format.

Allowed values:jsonphp

Responses

keywordsarray<object>
competitors_listarray<object>

Competitors information for a given keyword. The following fields are included: url, url_prev, position, position_prev, best_position_kind, best_position_kind_prev, traffic, traffic_prev, value, value_prev. Fields ending in prev are included only in the compared view.

countrystring

The country that a given keyword is being tracked in. A two-letter country code (ISO 3166-1 alpha-2).

Allowed values:ADAEAFAGAIALAMAOAQARASATAUAWAX…
keywordstring

The keyword your target ranks for.

keyword_difficultyinteger or null

An estimation of how hard it is to rank in the top 10 organic search results for a keyword on a 100-point scale.

keyword_has_databoolean

Will return false if the keyword is still processing and no SERP has been fetched yet.

keyword_is_frozenboolean

Indicates whether a keyword has exceeded the tracked keywords limit on your plan. Such keywords are "frozen", meaning they do not have their rankings updated.

languagestring

The SERP language that a given keyword is being tracked for.

locationstring

The location (country, state/province, or city) that a given keyword is being tracked in.

serp_featuresarray<string>

The SERP features that appear in search results for a keyword.

Allowed values:paid_toppaid_bottompaid_rightpaid_sitelinkorganicsitelinksnippetimagearticleknowledge_cardknowledge_panellocal_packlocal_teasernewsquestion…
serp_updatedstring (date-time) or null

The date when we last checked search engine results for a keyword.

serp_updated_prevstring (date-time) or null

The date when we checked search engine results up to the comparison date.

tagsarray<string>

A list of tags assigned to a given keyword.

volumeinteger or null

An estimation of the average monthly number of searches for a keyword over the latest month or over the latest known 12 months of data depending on the "volume_mode" parameter.