Find Keyword Ideas

Discover new keywords from seed keywords with DataForSEO Labs: ideas by topic, long-tail suggestions containing the seed, or related searches, each with search volume, CPC, competition, difficulty and intent. Use dataforseo_get_keyword_overview for metrics on keywords you already have.


App	DataForSEO
Operation ID	`dataforseo_find_keyword_ideas`
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	-	Seed keywords, as a list or newline/comma-separated text. keyword_ideas takes up to 200 seeds in one request; keyword_suggestions and related_keywords run one request per seed.
`idea_source`	string or SelectableOption	No	`keyword_ideas`	’keyword_ideas’ (default): keywords relevant to the seeds by category and meaning. ‘keyword_suggestions’: long-tail phrases containing the seed. ‘related_keywords’: terms from the ‘searches related to’ block, expandable by depth.
`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.
`exact_match`	boolean	No	`False`	keyword_suggestions only: return phrases containing the seed exactly as written.
`depth`	integer	No	`1`	related_keywords only: how many levels of related searches to expand (1 to 4). Each level multiplies the number of keywords, up to 8 at depth 1 and 4680 at depth 4.
`ignore_synonyms`	boolean	No	`False`	Skip keywords that are near-duplicates of others in the result.
`include_serp_info`	boolean	No	`False`	Also return SERP facts per keyword: result types on the page, number of results and the check URL.
`filters`	array of FilterItem	No	-	Up to 8 filters on dotted result fields, e.g. keyword_info.search_volume GREATER_THAN 500, keyword_properties.keyword_difficulty LESS_THAN 40, keyword CONTAINS ‘best’, search_intent_info.main_intent EQUALS commercial.
`orders`	array of OrderItem	No	-	Sort by up to 3 dotted result fields, e.g. keyword_info.search_volume DESC.
`limit`	integer	No	`100`	Maximum number of rows to return (1 to 1000). Defaults to 100. Each row is billed by DataForSEO, so keep this as small as the task needs.
`offset`	integer	No	-	Number of rows to skip, for paging.
`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.

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. For regex values, escape backslashes once in the JSON string: write \b for a word boundary, not \b.

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 idea with the same dotted columns as keyword overview (keyword, keyword_info., keyword_properties., search_intent_info., avg_backlinks_info.) plus seed_keyword, and for related_keywords also depth and related_keywords. Fields: seed_keyword, 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

Find Keyword Ideas

Inputs

FilterItem

OrderItem

SelectableOption

Output

​Inputs

​FilterItem

​OrderItem

​SelectableOption

​Output

Inputs

FilterItem

OrderItem

SelectableOption

Output