Get Rank Tracker Overview

Get tracked keyword rankings from an Ahrefs Rank Tracker project for a date and device: position, ranking URL, traffic, volume, difficulty, SERP features, location, tags and intents, with position and traffic change against a compare date. Free: does not consume API units. Use ahrefs_list_projects to find the project_id and ahrefs_get_rank_tracker_competitors for share of voice.


App	Ahrefs
Operation ID	`ahrefs_get_rank_tracker_overview`
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.
`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; enables position_prev, position_diff, traffic_prev, traffic_diff and url_prev.
`device`	string or SelectableOption	No	`desktop`	Rankings for ‘desktop’ (default) or ‘mobile’.
`metrics`	array of string or SelectableOption	No	-	Fields to return (keyword is always included). Available: position, position_prev, position_diff, url, url_prev, traffic, traffic_prev, traffic_diff, volume, volume_desktop_pct, volume_mobile_pct, keyword_difficulty, cost_per_click (USD), clicks, clicks_per_search, country, location, language, tags, serp_features, serp_updated, parent_topic, target_positions_count, best_position_kind, best_position_has_thumbnail, best_position_has_video_preview, keyword_has_data, keyword_is_frozen, created_at, is_branded, is_commercial, is_informational, is_local, is_navigational, is_transactional, search_type_web, search_type_image, search_type_news, search_type_video. The _prev and _diff fields need date_compared. Defaults to position, url, traffic, volume, keyword_difficulty, serp_features, location, tags.
`filters`	array of FilterItem	No	-	Filters on the available fields, e.g. position LESS_THAN 11 or tags CONTAINS ‘brand’.
`orders`	array of OrderItem	No	-	Sort by one or more fields, e.g. position ASC.
`limit`	integer	No	-	Maximum number of keywords to return. 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 tracked keyword with keyword plus the selected fields: position, position_prev, position_diff, url, url_prev, traffic, traffic_prev, traffic_diff, volume, keyword_difficulty, cost_per_click (USD), clicks, serp_features (comma-separated), location, language, country, tags (comma-separated), intent flags and more. Fields: keyword, position, url, traffic, volume, keyword_difficulty, serp_features, location, tags Example:

[
  {
    "keyword": "google ads audit",
    "position": 19,
    "url": "https://www.marketingauditor.com/",
    "traffic": 1,
    "volume": 350,
    "keyword_difficulty": 0,
    "serp_features": "ai_overview, question, sitelink",
    "location": "United States",
    "tags": null
  }
]

Get Started

Guides

Operations

Get Rank Tracker Overview

Inputs

FilterItem

OrderItem

SelectItem

SelectableOption

Output

​Inputs

​FilterItem

​OrderItem

​SelectItem

​SelectableOption

​Output

Inputs

FilterItem

OrderItem

SelectItem

SelectableOption

Output