Get Keyword Gap

Keyword gap analysis from DataForSEO Labs: the keywords two domains both rank for with each one’s position, the keywords only the first ranks for, or the keywords shared across up to 20 specific pages, each with volume, CPC, difficulty and intent.


App	DataForSEO
Operation ID	`dataforseo_get_keyword_gap`
Type	Action
Connection	`dataforseo` (required)
Credits per run	Free
Agent / MCP tool	Yes

Inputs

Field	Type	Required	Default	Description
`targets`	array of string or string	Yes	-	Domains (comparison ‘domains’: exactly two, without scheme or www) or page URLs (comparison ‘pages’: 2 to 20 full URLs), as a list or newline/comma-separated text.
`comparison`	string or SelectableOption	No	`domains`	’domains’ (default): compare the keyword sets of two domains. ‘pages’: compare the keyword sets of 2 to 20 specific pages.
`shared_only`	boolean	No	`True`	Domains: true returns keywords BOTH domains rank for (with each domain’s position); false returns keywords the FIRST domain ranks for and the second does not. Pages: true returns keywords all pages share; false returns keywords any of them ranks for.
`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.
`item_types`	string or array of string	No	-	SERP element types to compare on: organic, paid, featured_snippet, local_pack, ai_overview_reference. Defaults to organic and paid.
`filters`	array of FilterItem	No	-	Up to 8 filters on dotted result fields, e.g. keyword_data.keyword_info.search_volume GREATER_THAN 500, first_domain_serp_element.rank_group LESS_THAN 11, second_domain_serp_element.rank_group GREATER_THAN 10.
`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_data.keyword, keyword_data.keyword_info.search_volume, keyword_data.keyword_info.cpc, keyword_data.keyword_properties.keyword_difficulty, first_domain_serp_element.rank_group, first_domain_serp_element.url, second_domain_serp_element.rank_group, second_domain_serp_element.url (domains comparison), or intersection_result.1.rank_group, intersection_result.2.rank_group (pages comparison). 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 with dotted columns: keyword_data.keyword, keyword_data.keyword_info.search_volume, keyword_data.keyword_info.cpc, keyword_data.keyword_properties.keyword_difficulty, keyword_data.search_intent_info.main_intent, then first_domain_serp_element.* and second_domain_serp_element.* (type, rank_group, rank_absolute, url, title, etv) for the domains comparison, or intersection_result.<n>.* per page for the pages comparison. Fields: keyword_data.keyword, keyword_data.keyword_info.search_volume, first_domain_serp_element.rank_group, first_domain_serp_element.url, second_domain_serp_element.rank_group, second_domain_serp_element.url Example:

[
  {
    "keyword_data.keyword": "keyword research tool",
    "keyword_data.keyword_info.search_volume": 22200,
    "first_domain_serp_element.rank_group": 4,
    "second_domain_serp_element.rank_group": 2
  }
]

Get Started

Guides

Operations

Inputs

FilterItem

OrderItem

SelectableOption

Output

​Inputs

​FilterItem

​OrderItem

​SelectableOption

​Output

Inputs

FilterItem

OrderItem

SelectableOption

Output