Get Rank Tracker Competitors

Get competitor performance from an Ahrefs Rank Tracker project: share of voice, traffic, average position and position buckets per competitor (stats), every competitor’s position per tracked keyword (keywords), or all domains and pages ranking for the tracked keywords (domains, pages). Free: does not consume API units. The domains and pages reports need competitors added to the project in Ahrefs.


App	Ahrefs
Operation ID	`ahrefs_get_rank_tracker_competitors`
Type	Action
Connection	`ahrefs` (required)
Credits per run	Free
Agent / MCP tool	Yes

Inputs

Field	Type	Required	Default	Description
`project_id`	string or SelectItem	Yes	-	The Rank Tracker project (numeric ID from the Ahrefs project URL). Use ahrefs_list_projects to find it.
`report`	string or SelectableOption	No	`stats`	’stats’ (default): one row per target and tracked competitor with share of voice, traffic, traffic value, average position, position buckets and SERP feature counts. ‘keywords’: one row per tracked keyword with every competitor’s position in competitors_list. ‘domains’ / ‘pages’: every domain or page ranking for the tracked keywords with share of voice and traffic (needs competitors added to the project).
`date`	string	No	-	Report date in YYYY-MM-DD format. Defaults to today.
`date_compared`	string	No	-	Earlier date in YYYY-MM-DD format to compare against (keywords, domains and pages reports); enables the *_prev fields.
`device`	string or SelectableOption	No	`desktop`	Rankings for ‘desktop’ (default) or ‘mobile’.
`tracked_competitors_only`	boolean	No	`False`	For the domains and pages reports: only include the target and the competitors tracked in the project.
`metrics`	array of string or SelectableOption	No	-	Fields to return; the report decides which are valid. stats: competitor, share_of_voice, share_of_traffic_value, traffic, traffic_value (USD), average_position, pos_1_3, pos_4_10, pos_11_20, pos_21_50, pos_51_plus, pos_no_rank, ai_overview_count, featured_snippet_count, image_pack_count, knowledge_card_count, knowledge_panel_count, sitelinks_count, thumbnail_count, top_stories_count, video_preview_count, videos_count, discussions_count, x_count. keywords: keyword, volume, keyword_difficulty, competitors_list, serp_features, serp_updated, serp_updated_prev, country, location, language, tags, keyword_has_data, keyword_is_frozen. domains: domain, keywords, pages, traffic, traffic_prev, traffic_value (USD), traffic_value_prev, share_of_voice, share_of_voice_prev, share_of_traffic_value, share_of_traffic_value_prev, status. pages: url, title, title_prev, keywords, traffic, traffic_prev, traffic_value, traffic_value_prev, share_of_voice, share_of_voice_prev, share_of_traffic_value, share_of_traffic_value_prev, status. Leave empty for a sensible default per report.
`filters`	array of FilterItem	No	-	Filters on the tracked keywords (keywords, domains and pages reports): keyword, country, location, language, tags, plus volume, keyword_difficulty, serp_features and serp_updated for the keywords report, domain for domains and pages, url for pages.
`orders`	array of OrderItem	No	-	Sort by one or more fields (keywords, domains and pages reports only).
`limit`	integer	No	-	Maximum number of rows (keywords, domains and pages reports only). Free endpoint; your Ahrefs plan still caps rows per request.

Field	Type	Required	Default	Description
`field`	string or SelectableOption	Yes	-	The field to filter on, must be one of the current selected metrics or dimensions.
`operator`	string	Yes	-	The operator to use for filtering. Must be one of the supported values. Use REGEXP_MATCH to search/filter by multiple OR values like ’.(summer\|holiday).’
`value`	string	Yes	-	The value to filter by, always as a string: text, a number, or a regex. For IN_LIST and NOT_IN_LIST, pass the values as one comma-separated string such as ‘a,b,c’, not as an array.

OrderItem

Field	Type	Required	Default	Description
`field`	string or SelectableOption	Yes	-	The field to sort by. must be one of the current selected metrics or dimensions.
`direction`	string	Yes	-	The order to sort by, must be one of ‘ASC’, ‘DESC’

SelectItem

Field	Type	Required	Default	Description
`value`	string	Yes	-	The value of the selectable item.
`label`	string	Yes	-	The label of the selectable item, used for display purposes. If not provided, defaults to the value.

SelectableOption

Field	Type	Required	Default	Description
`value`	string	Yes	-
`label`	string	Yes	-

Output

Type: List[Dict] Returns one row per competitor (stats), tracked keyword (keywords; competitors_list holds each competitor’s url, position, traffic and value in USD cents as returned by Ahrefs), domain or page, with the selected fields such as share_of_voice, traffic, traffic_value (USD), average_position, pos_1_3 to pos_no_rank, keywords, status. Fields: competitor, share_of_voice, traffic, traffic_value, average_position, pos_1_3, pos_4_10, pos_11_20, pos_21_50, pos_51_plus, pos_no_rank Example:

[
  {
    "competitor": "marketingauditor.com/",
    "share_of_voice": 0.28,
    "traffic": 5,
    "traffic_value": 67.5,
    "average_position": 17.5,
    "pos_1_3": 0,
    "pos_4_10": 0,
    "pos_11_20": 1,
    "pos_21_50": 1,
    "pos_51_plus": 0,
    "pos_no_rank": 5
  }
]

Get Started

Guides

Operations

Get Rank Tracker Competitors

Inputs

FilterItem

OrderItem

SelectItem

SelectableOption

Output

​Inputs

​FilterItem

​OrderItem

​SelectItem

​SelectableOption

​Output

Inputs

FilterItem

OrderItem

SelectItem

SelectableOption

Output