Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
Get the Google top 100 search results for one or more keywords from Ahrefs SERP Overview, with each result’s position, type (organic, paid, snippet, AI Overview…), Domain Rating, URL Rating, back…
| App | Ahrefs |
| Operation ID | ahrefs_get_serp_overview |
| Type | Action |
| Connection | ahrefs (required) |
| Credits per run | Free |
| Agent / MCP tool | Yes |
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
keywords | array of string or string | Yes | - | Keywords to get the SERP for. Accepts a list or a newline/comma-separated string. One Ahrefs request is made per keyword (minimum 50 API units each); rows carry a keyword column. |
country | string or SelectableOption | No | us | Two-letter country code of the Google SERP (e.g. us, gb, de). Defaults to us. |
serp_types | array of string or SelectableOption | No | - | Only return positions of these SERP result types, e.g. organic, paid_top, snippet, ai_overview, video, local_pack, question. Leave empty for all types. Available: organic, paid_top, paid_bottom, paid_right, paid_sitelink, sitelink, snippet, image, image_th, article, knowledge_card, knowledge_panel, local_pack, local_teaser, news, question, review, shopping, organic_shopping, tweet, spelling, video, video_th, discussion, ai_overview, ai_overview_sitelink, ai_overview_found. |
top_positions | integer | No | - | Only return the top N organic positions. Leave empty for the full top 100 SERP. |
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, page_type, update_date. Ahrefs API unit cost per row: traffic, value and top_keyword_volume cost 10 units, refdomains 5, the rest 1. Defaults to type, title, domain_rating, url_rating, backlinks, refdomains, keywords, traffic. |
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
value | string | Yes | - | |
label | string | Yes | - |
List[Dict]
Returns one row per SERP position per keyword with keyword plus the selected Ahrefs fields: position, url, type (comma-separated), title, domain_rating, url_rating, ahrefs_rank, backlinks, refdomains, keywords, traffic, value (USD), top_keyword, top_keyword_volume, page_type, update_date.
Fields: keyword, position, url, type, title, domain_rating, url_rating, backlinks, refdomains, keywords, traffic
Example:
[
{
"keyword": "ahrefs",
"position": 1,
"url": "https://ahrefs.com/",
"type": "organic",
"title": "Ahrefs - AI Marketing Platform",
"domain_rating": 91.0,
"url_rating": 41.0,
"backlinks": 1814309,
"refdomains": 49179,
"keywords": 807,
"traffic": 128796
}
]