Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
Get the stored Google SERP for a keyword tracked in an Ahrefs Rank Tracker project (desktop or mobile, per tracked country, location and language) with each result’s type, Domain Rating, URL Rating…
| App | Ahrefs |
| Operation ID | ahrefs_get_rank_tracker_serp |
| Type | Action |
| Connection | ahrefs (required) |
| Credits per run | Free |
| Agent / MCP tool | Yes |
| 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. |
keyword | string | Yes | - | A keyword tracked in the project. Use ahrefs_list_tracked_keywords to see them with their country, location and language. |
country | string or SelectableOption | No | us | Two-letter country code the keyword is tracked in (e.g. us, gb). Defaults to us. |
device | string or SelectableOption | No | desktop | SERP for ‘desktop’ (default) or ‘mobile’. |
location_id | integer | No | - | Location ID the keyword is tracked for, when it is tracked at city or region level (from ahrefs_list_tracked_keywords). |
language_code | string | No | - | Language code the keyword is tracked in (e.g. en), when the project tracks several languages. |
top_positions | integer | No | - | Only return the top N organic positions. Leave empty for every position Ahrefs stored. |
date | string | No | - | Return the last SERP snapshot on or before this date, as YYYY-MM-DD or YYYY-MM-DDThh:mm:ss. Defaults to the most recent snapshot. |
metrics | array of string or SelectableOption | No | - | Columns to return (position and url are always included). Available: type, title, domain_rating, url_rating, ahrefs_rank, backlinks, refdomains, keywords, traffic, value (USD), top_keyword, top_keyword_volume, nr_words, page_type, update_date. Free endpoint. Defaults to type, title, domain_rating, url_rating, backlinks, refdomains, keywords, traffic. |
| 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. |
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
value | string | Yes | - | |
label | string | Yes | - |
List[Dict]
Returns one row per SERP position: position, url plus the selected fields (type comma-separated, title, domain_rating, url_rating, ahrefs_rank, backlinks, refdomains, keywords, traffic, value (USD), top_keyword, top_keyword_volume, nr_words, page_type, update_date).
Fields: position, url, type, title, domain_rating, url_rating, backlinks, refdomains, keywords, traffic
Example:
[
{
"position": 1,
"url": "https://www.marketingauditor.com/",
"type": "organic",
"title": "Marketing Auditor",
"domain_rating": 31.0,
"url_rating": 12.0,
"backlinks": 210,
"refdomains": 88,
"keywords": 140,
"traffic": 950
}
]