Competitors metrics

GET/v3/rank-tracker/competitors-stats

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.

datestringRequired

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-metricsarray

ai_overview_countinteger

The total number of tracked keywords for which your target ranks in an AI Overview.

average_positionnumber or null

The average of your target's top organic positions across all tracked keywords.

competitorstring

Competitor's URL.

discussions_countinteger

The total number of tracked keywords for which your target ranks in Discussions and forums.

featured_snippet_countinteger

The total number of tracked keywords for which your target ranks in a Featured snippet.

image_pack_countinteger

The total number of tracked keywords for which your target ranks in an Image pack.

knowledge_card_countinteger

The total number of tracked keywords for which your target ranks in a Knowledge card.

knowledge_panel_countinteger

The total number of tracked keywords for which your target ranks in a Knowledge panel.

pos_11_20integer

The total number of tracked keywords for which your target's top organic position is within the 11th to 20th results.

pos_1_3integer

The total number of tracked keywords for which your target's top organic position is within the top 3 results.

pos_21_50integer

The total number of tracked keywords for which your target's top organic position is within the 21st to 50th results.

pos_4_10integer

The total number of tracked keywords for which your target's top organic position is within the 4th to 10th results.

pos_51_plusinteger

The total number of tracked keywords for which your target's top organic position is the 51st or higher.

pos_no_rankinteger

The total number of tracked keywords where your target doesn't rank.

share_of_traffic_valuenumber

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

share_of_voicenumber

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

sitelinks_countinteger

The total number of tracked keywords for which your target ranks in Sitelinks.

thumbnail_countinteger

The total number of tracked keywords for which your target ranks in a Thumbnail.

top_stories_countinteger

The total number of tracked keywords for which your target ranks in Top stories.

trafficinteger or null

The estimated number of monthly visits that your target gets from organic search for all tracked keywords.

traffic_valueinteger or null

The estimated value of your target's monthly organic search traffic for all tracked keywords.

video_preview_countinteger

The total number of tracked keywords for which your target ranks in a Video preview.

videos_countinteger

The total number of tracked keywords for which your target ranks in Videos.

x_countinteger

The total number of tracked keywords for which your target ranks in an X (Twitter) widget.