Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
Break down a domain or URL’s organic and paid search metrics by country from Ahrefs Site Explorer: keywords, top-3 keywords, traffic, traffic value, paid keywords, paid pages, paid traffic and cost
| App | Ahrefs |
| Operation ID | ahrefs_get_metrics_by_country |
| Type | Action |
| Connection | ahrefs (required) |
| Credits per run | Free |
| Agent / MCP tool | Yes |
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
target | string | Yes | - | The domain, subdomain, subfolder or URL to break down by country (e.g. example.com). |
mode | string or SelectableOption | No | subdomains | How to interpret the target: ‘subdomains’ (domain and all subdomains, default), ‘domain’ (the exact host only), ‘prefix’ (every URL starting with the target), or ‘exact’ (the exact URL only). |
date | string | No | - | Report date in YYYY-MM-DD format. Defaults to today (latest data). |
metrics | array of string or SelectableOption | No | - | Metrics to return per country (country is always included). Available: org_keywords, org_keywords_1_3, org_traffic, org_cost (USD), paid_keywords, paid_pages, paid_traffic, paid_cost (USD). Ahrefs API unit cost per row: org_traffic, org_cost, paid_traffic and paid_cost cost 10 units each, the rest 1. Defaults to all of them. |
limit | integer | No | - | Maximum number of countries to return, ordered by organic traffic. Leave empty for all countries with data. |
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
value | string | Yes | - | |
label | string | Yes | - |
List[Dict]
Returns one row per country with country plus the selected fields: org_keywords, org_keywords_1_3, org_traffic, org_cost (USD), paid_keywords, paid_pages, paid_traffic, paid_cost (USD).
Fields: country, org_keywords, org_keywords_1_3, org_traffic, org_cost, paid_keywords, paid_pages, paid_traffic, paid_cost
Example:
[
{
"country": "US",
"org_keywords": 24739,
"org_keywords_1_3": 9835,
"org_traffic": 5168733,
"org_cost": 7384141.91,
"paid_keywords": 53,
"paid_pages": 23,
"paid_traffic": 143,
"paid_cost": 224.96
}
]