Competitors domains

API + MCP

GET/v3/rank-tracker/competitors-domains

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

Query parameters

timeoutinteger

A manual timeout duration in seconds.

limitinteger

The number of results to return.

Default:1000

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

wherestring

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

selectstringRequired

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

target_and_tracked_competitors_onlyboolean

Restrict domains to target and tracked competitors

Default:false

date_comparedstring (date)

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

datestring (date)Required

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

devicestringRequired

Choose between mobile and desktop rankings.

Allowed values:desktopmobile

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#

volume_modestring

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

Allowed values:monthlyaverage

Default:monthly

outputstring

The output format.

Allowed values:jsoncsvxmlphp

Responses

competitors-domainsarray<object>

domainstring (domain)

The page domain.

keywordsinteger

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

pagesinteger

The total number of pages from this domain ranking for the project's tracked keywords.

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

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.