Competitors pages

API + MCP

GET/v3/rank-tracker/competitors-pages

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.

target_and_tracked_competitors_onlyboolean

Restrict pages to target and tracked competitors

Default:false

outputstring

The output format.

Allowed values:jsoncsvxmlphp

Responses

competitors-pagesarray<object>

keywordsinteger

The total number of keywords that your target ranks for in the top 100 organic search results.

share_of_traffic_valuenumber (float)

The share of your target's organic search traffic value compared to the total organic search traffic value for all tracked keywords.

share_of_traffic_value_prevnumber (float)

The share of traffic value on the comparison date.

share_of_voicenumber (float)

The share of your target's organic search traffic compared to the total organic search traffic for all tracked keywords.

share_of_voice_prevnumber (float)

The share of voice on the comparison date.

statusstring

The status of a page: the new page that just started to rank ("left"), the lost page that disappeared from search results ("right"), or no change ("both").

Allowed values:leftrightboth

titlestring or null

The title displayed for the page in its top keyword's SERP.

title_prevstring or null

The title on the comparison date.

trafficinteger

An estimation of the number of monthly visits that a page gets from organic search.

traffic_previnteger

The traffic on the comparison date.

traffic_valueinteger or null

The estimated value of a page’s monthly organic search traffic, in USD cents.

traffic_value_previnteger or null

The traffic value on the comparison date.

urlstring (url)

The page URL.