> ## Documentation Index
> Fetch the complete documentation index at: https://docs.markifact.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Rank Tracker Serp

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

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, backlinks, referring domains, keywords and traffic. Free: does not consume API units, unlike ahrefs\_get\_serp\_overview which works for any keyword.

|                      |                                |
| -------------------- | ------------------------------ |
| **App**              | Ahrefs                         |
| **Operation ID**     | `ahrefs_get_rank_tracker_serp` |
| **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.                                                                                                                                                                                                                                                                   |
| `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. |

### 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 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**:

```json theme={"dark"}
[
  {
    "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
  }
]
```