Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
List the landing pages a domain advertises in Google paid search according to Ahrefs Site Explorer, with paid keyword counts, ad counts, paid traffic and cost, top keyword and URL Rating
| App | Ahrefs |
| Operation ID | ahrefs_get_paid_pages |
| 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 list paid search landing pages for (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). |
country | string or SelectableOption | No | - | Two-letter country code (e.g. us, gb, de) to restrict results to one country. Leave empty for all countries. |
date | string | No | - | Report date in YYYY-MM-DD format. Defaults to today (latest data). |
date_compared | string | No | - | Optional earlier date in YYYY-MM-DD format to compare against; enables the *_prev and *_diff metrics. |
metrics | array of string or SelectableOption | No | - | Metrics to return (url is always included). Available: keywords, keywords_prev, keywords_diff, ads_count, ads_count_prev, ads_count_diff, sum_traffic, sum_traffic_prev, traffic_diff, value (USD), value_prev, value_diff, top_keyword, top_keyword_volume, top_keyword_best_position, top_keyword_country, ur, referring_domains, status (needs date_compared). Ahrefs API unit cost per row: sum_traffic, sum_traffic_prev, value, value_prev and top_keyword_volume cost 10 units, referring_domains 5, the rest 1. Defaults to keywords, ads_count, sum_traffic, value, top_keyword, top_keyword_best_position, ur. |
filters | array of FilterItem | No | - | Filters on the available metrics, e.g. ads_count GREATER_THAN 1 or url CONTAINS ‘/landing/’. Filter fields count towards the unit cost per row. |
orders | array of OrderItem | No | - | Sort by one or more metrics. |
limit | integer | No | 100 | Maximum number of rows to return. Defaults to 100. Your Ahrefs plan caps rows per request (Lite 100, Standard 250, Advanced 500). |
| 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. |
| 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’ |
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
value | string | Yes | - | |
label | string | Yes | - |
List[Dict]
Returns one row per paid landing page with the selected Ahrefs fields: url, keywords, ads_count, sum_traffic, value (USD), top_keyword, top_keyword_volume, top_keyword_best_position, ur, referring_domains and *_prev / *_diff comparison fields.
Fields: url, keywords, ads_count, sum_traffic, value, top_keyword, top_keyword_best_position, ur
Example:
[
{
"url": "https://ahrefs.com/brand-radar",
"keywords": 19,
"ads_count": 19,
"sum_traffic": 59,
"value": 41.32,
"top_keyword": "brand radar",
"top_keyword_best_position": 1,
"ur": 22.0
}
]