Get Keyword Overview

Get Ahrefs Keywords Explorer metrics for a list of keywords in one country: search volume, keyword difficulty, CPC, clicks, traffic potential, search intents, parent topic and SERP features. Use ahrefs_find_keyword_ideas to discover new keywords and ahrefs_get_serp_overview to see who ranks.


App	Ahrefs
Operation ID	`ahrefs_get_keyword_overview`
Type	Action
Connection	`ahrefs` (required)
Credits per run	Free
Agent / MCP tool	Yes

Inputs

Field	Type	Required	Default	Description
`keywords`	array of string or string	Yes	-	Keywords to look up. Accepts a list or a newline/comma-separated string. Ahrefs is queried in batches of 100 keywords; one row is returned per keyword Ahrefs has data for.
`country`	string or SelectableOption	No	`us`	Two-letter country code for search volume and SERP data (e.g. us, gb, de). Defaults to us.
`metrics`	array of string or SelectableOption	No	-	Metrics to return (keyword is always included). Available: volume, volume_monthly, global_volume, difficulty, cpc (USD), clicks, cps, traffic_potential, intents, parent_topic, parent_volume, serp_features, serp_last_update, first_seen, volume_desktop_pct, volume_mobile_pct, searches_pct_clicks_organic_only, searches_pct_clicks_paid_only, searches_pct_clicks_organic_and_paid. Ahrefs API unit cost per row: volume, volume_monthly, global_volume, difficulty, traffic_potential, intents and parent_volume cost 10 units each, the rest 1. Defaults to volume, difficulty, cpc, clicks, traffic_potential, intents, parent_topic, serp_features.
`filters`	array of FilterItem	No	-	Filters on the available metrics, e.g. volume GREATER_THAN 1000 (volume_monthly, intents and the click-share fields cannot be filtered on). Filter fields count towards the unit cost per row.
`orders`	array of OrderItem	No	-	Sort by one or more metrics (volume_monthly is not sortable).
`limit`	integer	No	-	Maximum number of rows to return. 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.

OrderItem

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’

SelectableOption

Field	Type	Required	Default	Description
`value`	string	Yes	-
`label`	string	Yes	-

Output

Type: List[Dict] Returns one row per keyword with the selected Ahrefs fields: keyword, volume, volume_monthly, global_volume, difficulty, cpc (USD), clicks, cps, traffic_potential, intents (comma-separated), parent_topic, parent_volume, serp_features (comma-separated), serp_last_update, first_seen, volume_desktop_pct, volume_mobile_pct. Fields: keyword, volume, difficulty, cpc, clicks, traffic_potential, intents, parent_topic, serp_features Example:

[
  {
    "keyword": "seo tools",
    "volume": 434000,
    "difficulty": 25,
    "cpc": 5.7,
    "clicks": 310000,
    "traffic_potential": 129000,
    "intents": "informational, commercial",
    "parent_topic": "seo tools",
    "serp_features": "sitelink, question, video_th"
  }
]

Get Started

Guides

Operations

Get Keyword Overview

Inputs

FilterItem

OrderItem

SelectableOption

Output

​Inputs

​FilterItem

​OrderItem

​SelectableOption

​Output

Inputs

FilterItem

OrderItem

SelectableOption

Output