Get Keyword Overview

Get DataForSEO Labs metrics for a list of known keywords in one location and language: search volume with monthly history and trend, CPC, competition, keyword difficulty and search intent, optionally with SERP facts and clickstream volume. Use dataforseo_find_keyword_ideas to discover new keywords.


App	DataForSEO
Operation ID	`dataforseo_get_keyword_overview`
Type	Action
Connection	`dataforseo` (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, as a list or newline/comma-separated text. Up to 700 per request; longer lists are split into several requests.
`location`	string or SelectableOption	No	`2840`	Country or location: a two-letter country code (us, gb, de…), a DataForSEO location code (2840 = United States), or a full location name such as ‘London,England,United Kingdom’. Defaults to the United States.
`language`	string or SelectableOption	No	`en`	Language code of the search results, e.g. en, de, es, fr, nl. Defaults to en.
`include_serp_info`	boolean	No	`False`	Also return SERP facts per keyword: result types on the page, number of results and the check URL.
`include_clickstream_data`	boolean	No	`False`	Also return clickstream-based volume with gender and age distribution. Doubles the request cost.
`fields`	string or array of string	No	-	Dotted result fields to keep, e.g. keyword, keyword_info.search_volume, keyword_info.cpc, keyword_info.competition_level, keyword_info.monthly_searches, keyword_info.search_volume_trend.yearly, keyword_properties.keyword_difficulty, search_intent_info.main_intent, serp_info.serp_item_types, avg_backlinks_info.backlinks. Leave empty for the default set listed in the output description. Does not change the cost.

SelectableOption

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

Output

Type: List[Dict] Returns one row per keyword with DataForSEO’s fields flattened to dotted columns: keyword, keyword_info.search_volume, keyword_info.cpc, keyword_info.competition, keyword_info.competition_level, keyword_info.monthly_searches (list), keyword_info.search_volume_trend.monthly/quarterly/yearly, keyword_properties.keyword_difficulty, keyword_properties.core_keyword, search_intent_info.main_intent, search_intent_info.foreign_intent, avg_backlinks_info.* and, when requested, serp_info.* and clickstream_keyword_info.*. Fields: keyword, keyword_info.search_volume, keyword_info.cpc, keyword_info.competition_level, keyword_properties.keyword_difficulty, search_intent_info.main_intent Example:

[
  {
    "keyword": "seo tools",
    "keyword_info.search_volume": 40500,
    "keyword_info.cpc": 6.2,
    "keyword_info.competition_level": "MEDIUM",
    "keyword_properties.keyword_difficulty": 72,
    "search_intent_info.main_intent": "commercial"
  }
]

Get Started

Guides

Operations

Get Keyword Overview

Inputs

SelectableOption

Output

​Inputs

​SelectableOption

​Output

Inputs

SelectableOption

Output