Unified Search Historical Google Database

 
Unified Search Historical Google Database is a combination of the Historical Google SERP and Historical Google Keyword Databases.

Historical Google SERP Database contains millions of monthly Google SERP snapshots structured in JSON with all extra SERP features, such as featured snippets, knowledge graphs, people also ask sections, top stories, and more.

Historical Google Keyword Databases provides billions of keywords enriched with historical keyword data: search volume, competition, and more.

Note that historical Keyword data is available starting from 2021-09-01, historical SERP data is available for the past 365 days.

This database is available in JSON format only.

Click here to download a database sample for the US location, English language.

You can also download the full list of supported locations in the CSV format (last updated 2025-08-05).

Description of the fields in the database:

Field name	Type	Description
keyword	string	keyword UTF-8 encoding applies
location	integer	location code unique identifier of the corresponding location you can receive the list of available locations with their location_code by making a GET request to https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages example: 2840 corresponds to the United States
language	string	language code unique identifier of the language available for the corresponding location you can receive the list of available locations with their language_code by making a GET request to https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages example: en corresponds to English
spell	string	autocorrection of the search engine if the search engine provided results for a keyword that was corrected, we will provide the keyword corrected by the search engine and the type of autocorrection
spell_type	string	type of autocorrection possible values: did_you_mean, showing_results_for, no_results_found_for, including_results_for
keyword_info_history	object	historical keyword data for the returned keyword
$date	object	date variable provided in the “YYYYMM” format example: "202109"
search_volume	integer	average monthly search volume rate represents either the approximate number of searches for the given keyword idea on google.com or google.com and partners, depending on the user’s targeting
cpc	float	cost-per-click represents the average cost per click (USD) historically paid for the keyword note that Google Ads does not provide separate CPC data; this field returns values based on data from high_top_of_page_bid supplied in Google Ads
competition	float	competition represents the relative amount of competition associated with the given keyword; the value is based on Google Ads data and can be between 0 and 1 (inclusive)
competition_level	string	competition level represents the relative level of competition associated with the given keyword in paid SERP only; possible values: LOW, MEDIUM, HIGH if competition level is unknown, the value is null; learn more about the metric in this help center article
low_top_of_page_bid	float	minimum bid for the ad to be displayed at the top of the first page indicates the value greater than about 20% of the lowest bids for which ads were displayed (based on Google Ads statistics for advertisers) the value may differ depending on the location specified in a POST request
high_top_of_page_bid	float	maximum bid for the ad to be displayed at the top of the first page indicates the value greater than about 80% of the lowest bids for which ads were displayed (based on Google Ads statistics for advertisers) the value may differ depending on the location specified in a POST request
time_update	string	date and time when keyword data was last updated in the ISO 8601 format: “YYYY-MM-DDThh:mm:ss.sssssssZ” example: 2020-09-12T00:07:43.0733218Z
categories	array	product and service categories you can download the full list of possible categories
history	object	monthly searches represents the (approximate) number of searches on the returned keyword in the given location for the past 4 years; example: "202109":40
serp_info_history	object	historical SERP data available for the returned keyword SERP data for each month is provided as a separate object
check_url	string	direct URL to search engine results you can use it to make sure that we provided exact results
items_count	integer	the number of results returned in the serp array
keyword_difficulty	integer	difficulty of ranking in the first top-10 organic results for a keyword indicates the chance of getting in top-10 organic results for a keyword on a logarithmic scale from 0 to 100; calculated by analysing, among other parameters, link profiles of the first 10 pages in SERP; learn more about the metric in this help center guide
se_results_count	integer	total number of results in SERP
time_update	string	date and time when SERP data was last updated in the ISO 8601 format: “YYYY-MM-DDThh:mm:ss.sssssssZ” example: 2020-09-12T00:07:43.0733218Z
previous_updated_time	string	previous to the most recent update of SERP data in the ISO 8601 format: “YYYY-MM-DDThh:mm:ss.sssssssZ” example: 2020-09-12T00:07:43.0733218Z
item_types	array	types of search results in SERP contains types of search results (items) found in SERP. possible item types: answer_box, carousel, multi_carousel, featured_snippet, google_flights, google_reviews, google_posts, google_hotels, images, jobs, knowledge_graph, local_pack, hotels_pack, map, organic, paid, people_also_ask, related_searches, people_also_search, shopping, top_stories, twitter, video, events, mention_carousel, recipes, top_sights, scholarly_articles, popular_products, podcasts, questions_and_answers, find_results_on, stocks_box, visual_stories, commercial_units, local_services, math_solver, currency_box, product_considerations, short_videos, refine_products, explore_brands, perspectives, discussions_and_forums, compare_sites, third_party_reviews, ai_overview
serp	array	contains data on the SERP elements found for the returned keyword SERP data recorded on a given time_update
‘organic’ element in SERP
title	string	title of the result in SERP
pre_snippet	string	includes additional information appended before the result description in SERP
description	string	description of the results element in SERP
breadcrumb	string	breadcrumb in SERP
images	array	images of the element
type	string	type of element = ‘images_element‘
alt	string	alt tag of the image
url	string	relevant URL
image_url	string	URL of the image the URL leading to the image on the original resource or DataForSEO storage (in case the original source is not available)
is_image	boolean	indicates whether the element contains an image
is_video	boolean	indicates whether the element contains a video
is_featured_snippet	boolean	indicates whether the element is a featured_snippet
extended_snippet	string	includes additional information appended after the result description in SERP
amp_version	boolean	Accelerated Mobile Pages indicates whether an item has the Accelerated Mobile Page (AMP) version
rating	object	the item’s rating the popularity rate based on reviews and displayed in SERP
rating_type	string	the type of rating here you can find the following elements: Max5, Percents, CustomMax
value	integer	the value of the rating
votes_count	integer	the amount of feedback
rating_max	integer	the maximum value for a rating_type
highlighted	array	words highlighted in bold within the results description
links	array	sitelinks the links shown below some of Google’s search results if there are none, equals null
type	string	type of element = ‘link_element‘
title	string	title of the result in SERP
description	string	description of the results element in SERP
url	string	sitelink URL
domain	string	domain in SERP
main_domain	string	main domain in SERP without subdomains
url	string	relevant absolute URL in SERP
relative_url	string	relative URL from SERP
is_malicious	boolean	indicates whether the element is marked as malicious
faq	object	frequently asked questions questions and answers extension shown below some of Google’s search results if there are none, equals null
type	string	type of element = ‘faq_box‘
items	array	items featured in the faq_box
type	string	type of element = ‘faq_box_element‘
title	string	question related to the result
description	string	answer provided in the drop-down block
links	array	links featured in the faq_box_element
type	string	type of element = ‘link_element‘
title	string	link anchor text
description	string	link description
url	string	link URL
type	string	type of element = ‘organic’
is_new	boolean	new element indicates whether the element is new compared with the previous version of the database
is_up	boolean	element went up indicates whether the element went up in SERP compared with the previous version of the database
is_down	boolean	element went down indicates whether the element went down in SERP compared with the previous version of the database
previous_rank_absolute	integer	previous absolute rank in SERP absolute position among all the elements in SERP previous to the most recent update
extended_people_also_search	array	extension of the organic element extension of the organic result containing related search queries Note: extension appears in SERP upon clicking on the result and then bouncing back to search results
cache_url	string	cached version of the page
price	object	pricing details contains the pricing details of the product or service featured in the result
current	float	current price indicates the current price of the product or service featured in the result
regular	float	regular price indicates the regular price of the product or service with no discounts applied
max_value	float	the maximum price the maximum price of the product or service as indicated in the result
currency	string	currency of the listed price ISO code of the currency applied to the price
is_price_range	boolean	price is provided as a range indicates whether a price is provided in a range
displayed_price	string	price string in the result raw price string as provided in the result
related_search_url	string	URL to a similar search URL to a new search for the same keyword(s) on related sites
related_result	array	related result from the same domain related result from the same domain appears as a part of the main result snippet
type	string	type of element = ‘related_result‘
xpath	string	the XPath of the element
domain	string	relevant domain
title	string	title of the result in SERP
url	string	relevant URL in SERP
cache_url	string	cached version of the page
related_search_url	string	URL to a similar search URL to a new search for the same keyword(s) on related sites
breadcrumb	string	breadcrumb in SERP
is_image	boolean	indicates whether the element contains an image
is_video	boolean	indicates whether the element contains a video
description	string	description of the results element in SERP
pre_snippet	string	includes additional information appended before the result description in SERP
extended_snippet	string	includes additional information appended after the result description in SERP
images	array	images of the element
type	string	type of element = ‘images_element‘
alt	string	alt tag of the image
url	string	relevant URL
amp_version	boolean	Accelerated Mobile Pages indicates whether an item has the Accelerated Mobile Page (AMP) version
rating	object	the item’s rating the popularity rate based on reviews and displayed in SERP
rating_type	string	the type of rating here you can find the following elements: Max5, Percents, CustomMax
value	integer	the value of the rating
votes_count	integer	the amount of feedback
rating_max	integer	the maximum value for a rating_type
price	object	pricing details contains the pricing details of the product or service featured in the result
current	float	current price indicates the current price of the product or service featured in the result
regular	float	regular price indicates the regular price of the product or service with no discounts applied
max_value	float	the maximum price the maximum price of the product or service as indicated in the result
currency	string	currency of the listed price ISO code of the currency applied to the price
is_price_range	boolean	price is provided as a range indicates whether a price is provided in a range
displayed_price	string	price string in the result raw price string as provided in the result
highlighted	array	words highlighted in bold within the result’s description
about_this_result	object	contains information from the ‘About this result’ panel ‘About this result’ panel provides additional context about why Google returned this result for the given query; this feature appears after clicking on the three dots next to most results
type	string	type of element = ‘about_this_result_element‘
url	string	result’s URL
source	string	source of additional information about the result
source_info	string	additional information about the result description of the website from Wikipedia or another additional context
source_url	string	URL to full information from the source
language	string	the language of the result
location	string	location for which the result is relevant
search_terms	array	matching search terms that appear in the result
related_terms	array	related search terms that appear in the result
time_stamp	string	date and time when the result was published in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00” example: 2019-11-15 12:57:46 +00:00
about_this_result	object	contains information from the ‘About this result’ panel ‘About this result’ panel provides additional context about why Google returned this result for the given query; this feature appears after clicking on the three dots next to most results
type	string	type of element = ‘about_this_result_element‘
url	string	result’s URL
source	string	source of additional information about the result
source_info	string	additional information about the result description of the website from Wikipedia or another additional context
source_url	string	URL to full information from the source
language	string	the language of the result
location	string	location for which the result is relevant
search_terms	array	matching search terms that appear in the result
related_terms	array	related search terms that appear in the result
is_web_story	boolean	indicates whether the element is marked as Google web story
timestamp	string	date and time when the result was published in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00” example: 2019-11-15 12:57:46 +00:00
rank_info	object	page and domain rank information
page_rank	integer	page rank page_rank is calculated based on the method for node ranking in a linked database – a principle used in the original Google PageRank algorithm; learn more about the metric and how it is calculated in this help center article
main_domain_rank	integer	main domain rank main_domain_rank is calculated based on the method for node ranking in a linked database – a principle used in the original Google PageRank algorithm learn more about the metric and how it is calculated in this help center article
position	string	the alignment of the element in SERP can take the following values: left, right
xpath	string	the XPath of the element
traffic_cost	float	estimated cost of converting organic search traffic into paid represents the estimated monthly cost of running ads for the keyword that a given URL ranks for the metric is calculated as the product of organic etv and paid cpc values and indicates the cost of driving the estimated volume of monthly organic traffic through PPC advertising in Google Search
rank_group	integer	group rank in SERP position within a group of elements with identical type values positions of elements with different type values are omitted from rank_group
rank_absolute	integer	absolute rank in SERP absolute position among all the elements in SERP
etv	float	estimated traffic volume estimated organic monthly traffic to the domain calculated as the product of CTR (click-through-rate) and search volume values of the keyword a given URL ranks for
‘paid’ element in SERP
title	string	title of the result in SERP
domain	string	full domain in SERP of the Ad element
description	string	description of the results element in SERP
breadcrumb	string	breadcrumb of the Ad element in SERP
url	string	relevant absolute URL of the Ad element in SERP
main_domain	string	main domain in SERP without subdomains
relative_url	string	relevant relative URL of the Ad element in SERP
highlighted	array	words highlighted in bold within the results description
extra	object	additional information about the result
ad_aclk	string	the identifier of the ad
description_rows	array	extended description if there is none, equals null
links	array	sitelinks the links shown below some of Google’s search results if there are none, equals null
type	string	type of element = ‘ad_link_element‘
title	string	title of the element
url	string	URL link
description	string	description of the link element in SERP
ad_aclk	string	the identifier of the ad
type	string	type of element = ‘paid’
is_new	boolean	new element indicates whether the element is new compared with the previous version of the database
is_up	boolean	element went up indicates whether the element went up in SERP compared with the previous version of the database
is_down	boolean	element went down indicates whether the element went down in SERP compared with the previous version of the database
previous_rank_absolute	integer	previous absolute rank in SERP absolute position among all the elements in SERP previous to the most recent update
price	object	pricing details contains the pricing details of the product or service featured in the result
current	float	current price indicates the current price of the product or service featured in the result
regular	float	regular price indicates the regular price of the product or service with no discounts applied
max_value	float	the maximum price the maximum price of the product or service as indicated in the result
currency	string	currency of the listed price ISO code of the currency applied to the price
is_price_range	boolean	price is provided as a range indicates whether a price is provided in a range
displayed_price	string	price string in the result raw price string as provided in the result
rank_info	object	page and domain rank information
page_rank	integer	page rank page_rank is calculated based on the method for node ranking in a linked database – a principle used in the original Google PageRank algorithm; learn more about the metric and how it is calculated in this help center article
main_domain_rank	integer	main domain rank main_domain_rank is calculated based on the method for node ranking in a linked database – a principle used in the original Google PageRank algorithm learn more about the metric and how it is calculated in this help center article
position	string	the alignment of the element in SERP can take the following values: left, right
xpath	string	the XPath of the element
traffic_cost	float	estimated cost of converting organic search traffic into paid represents the estimated monthly cost of running ads for the keyword that a given URL ranks for the metric is calculated as the product of organic etv and paid cpc values and indicates the cost of driving the estimated volume of monthly organic traffic through PPC advertising in Google Search
rank_group	integer	group rank in SERP position within a group of elements with identical type values positions of elements with different type values are omitted from rank_group
rank_absolute	integer	absolute rank in SERP absolute position among all the elements in SERP
etv	float	estimated traffic volume estimated organic monthly traffic to the domain calculated as the product of CTR (click-through-rate) and search volume values of the keyword a given URL ranks for
‘carousel’ element in SERP
title	string	title of the result in SERP
items	array	additional items present in the element if there are none, equals null
type	string	type of element = ‘carousel_element‘
title	string	title of the item
subtitle	string	subtitle of the item
type	string	type of element = ‘carousel’
position	string	the alignment of the element in SERP can take the following values: left, right
xpath	string	the XPath of the element
traffic_cost	float	estimated cost of monthly search traffic represents the estimated cost of paid monthly traffic based on etv and cpc values
rank_group	integer	group rank in SERP position within a group of elements with identical type values positions of elements with different type values are omitted from rank_group
rank_absolute	integer	absolute rank in SERP absolute position among all the elements in SERP
etv	float	estimated traffic volume estimated organic monthly traffic to the domain; calculated as the product of CTR (click-through-rate) and search volume values of the keyword a given URL ranks for
‘multi_carousel’ element in SERP
type	string	type of element = ‘multi_carousel’
items	array	additional items present in the element if there are none, equals null
type	string	type of element = ‘multi_carousel_element‘
multi_carousel_snippets	array	multi_carousel_snippet results
type	string	type of element = ‘multi_carousel_snippet‘
title	string	title of a particular item
title	string	title of the item
position	string	the alignment of the element in SERP can take the following values: left, right
xpath	string	the XPath of the element
traffic_cost	float	estimated cost of monthly search traffic represents the estimated cost of paid monthly traffic based on etv and cpc values
rank_group	integer	group rank in SERP position within a group of elements with identical type values positions of elements with different type values are omitted from rank_group
rank_absolute	integer	absolute rank in SERP absolute position among all the elements in SERP
etv	float	estimated traffic volume estimated organic monthly traffic to the domain calculated as the product of CTR (click-through-rate) and search volume values of the keyword a given URL ranks for
‘answer_box’ element in SERP
text	array	text if there is none, equals null
links	array	sitelinks the links shown below some of Google’s search results if there are none, equals null
type	string	type of element = ‘link_element‘
title	string	title of the link
description	string	description of the results element in SERP
url	string	URL link
type	string	type of element = ‘answer_box’
position	string	the alignment of the element in SERP can take the following values: left, right
xpath	string	the XPath of the element
traffic_cost	float	estimated cost of monthly search traffic represents the estimated cost of paid monthly traffic based on etv and cpc values
rank_group	integer	group rank in SERP position within a group of elements with identical type values positions of elements with different type values are omitted from rank_group
rank_absolute	integer	absolute rank in SERP absolute position among all the elements in SERP
etv	float	estimated traffic volume estimated organic monthly traffic to the domain calculated as the product of CTR (click-through-rate) and search volume values of the keyword a given URL ranks for
‘related_searches’ element in SERP
items	array	additional items present in the element if there are none, equals null
type	string	type of element = ‘related_searches’
position	string	the alignment of the element in SERP can take the following values: left, right
xpath	string	the XPath of the element
traffic_cost	float	estimated cost of monthly search traffic represents the estimated cost of paid monthly traffic based on etv and cpc values
rank_group	integer	group rank in SERP position within a group of elements with identical type values positions of elements with different type values are omitted from rank_group
rank_absolute	integer	absolute rank in SERP absolute position among all the elements in SERP
etv	float	estimated traffic volume estimated organic monthly traffic to the domain calculated as the product of CTR (click-through-rate) and search volume values of the keyword a given URL ranks for
‘people_also_search’ element in SERP
title	string	title of the result in SERP
items	array	additional items present in the element if there are none, equals null
type	string	type of element = ‘people_also_search’
position	string	the alignment of the element in SERP can take the following values: left, right
xpath	string	the XPath of the element
traffic_cost	float	estimated cost of monthly search traffic represents the estimated cost of paid monthly traffic based on etv and cpc values
rank_group	integer	group rank in SERP position within a group of elements with identical type values positions of elements with different type values are omitted from rank_group
rank_absolute	integer	absolute rank in SERP absolute position among all the elements in SERP
etv	float	estimated traffic volume estimated organic monthly traffic to the domain calculated as the product of CTR (click-through-rate) and search volume values of the keyword a given URL ranks for
‘local_pack’ element in SERP
title	string	title of the result in SERP
description	string	description of the results element in SERP
phone	string	phone number
is_paid	boolean	indicates whether the element is an ad
rating	object	the item’s rating the popularity rate based on reviews and displayed in SERP
rating_type	string	the type of rating here you can find the following elements: Max5, Percents, CustomMax
value	integer	the value of the rating
votes_count	integer	the amount of feedback
rating_max	integer	the maximum value for a rating_type
domain	string	domain in SERP
main_domain	string	main domain in SERP without subdomains
url	string	relevant absolute URL in SERP
relative_url	string	relative URL from SERP
type	string	type of element = ‘local_pack’
is_new	boolean	new element indicates whether the element is new compared with the previous version of the database
is_up	boolean	element went up indicates whether the element went up in SERP compared with the previous version of the database
is_down	boolean	element went down indicates whether the element went down in SERP compared with the previous version of the database
previous_rank_absolute	integer	previous absolute rank in SERP absolute position among all the elements in SERP previous to the most recent update
rank_info	object	page and domain rank information
page_rank	integer	page rank page_rank is calculated based on the method for node ranking in a linked database – a principle used in the original Google PageRank algorithm; learn more about the metric and how it is calculated in this help center article
main_domain_rank	integer	main domain rank main_domain_rank is calculated based on the method for node ranking in a linked database – a principle used in the original Google PageRank algorithm learn more about the metric and how it is calculated in this help center article
position	string	the alignment of the element in SERP can take the following values: left, right
xpath	string	the XPath of the element
traffic_cost	float	estimated cost of converting organic search traffic into paid represents the estimated monthly cost of running ads for the keyword that a given URL ranks for; the metric is calculated as the product of organic etv and paid cpc values and indicates the cost of driving the estimated volume of monthly organic traffic through PPC advertising in Google Search
rank_group	integer	group rank in SERP position within a group of elements with identical type values positions of elements with different type values are omitted from rank_group
rank_absolute	integer	absolute rank in SERP absolute position among all the elements in SERP
etv	float	estimated traffic volume estimated organic monthly traffic to the domain calculated as the product of CTR (click-through-rate) and search volume values of the keyword a given URL ranks for
‘knowledge_graph’ element in SERP
title	string	title of the result in SERP
subtitle	string	subtitle of the item
description	string	description
card_id	string	card id
url	string	relevant URL
logo_url	string	URL to the logo used in the element
items	array	additional items present in the element if there are none, equals null
type	string	type of element = ‘knowledge_graph_carousel_item‘
title	string	title of the item
link	object	link in the item
type	array	type of element = ‘link_element‘
title	string	title of the link element
description	string	description of the results element in SERP
url	string	URL link
data_attrid	string	google defined data attribute ID example: action:listen_artist
items	array	elements of the knowledge graph carousel
type	array	type of element = ‘knowledge_graph_carousel_element‘
title	string	title of the element
subtitle	string	subtitle of the element
url	string	URL
domain	string	domain in the URL
image_url	string	URL of the image
position	string	the alignment of the element in SERP can take the following values: left, right
xpath	string	the XPath of the element
traffic_cost	float	estimated cost of monthly search traffic estimated organic monthly traffic to the domain; represents the estimated cost of paid monthly traffic based on etv and cpc values
rank_group	integer	group rank in SERP position within a group of elements with identical type values positions of elements with different type values are omitted from rank_group
rank_absolute	integer	absolute rank in SERP absolute position among all the elements in SERP
etv	float	estimated traffic volume estimated organic monthly traffic to the domain; calculated as the product of CTR (click-through-rate) and search volume values of the keyword a given URL ranks for
type	string	type of element = ‘knowledge_graph_description_item‘
text	string	text featured in the item
links	array	links in the item
type	array	type of element = ‘link_element‘
title	string	title of the link element
description	string	description of the link
url	string	URL link
position	string	the alignment of the element in SERP can take the following values: left, right
xpath	string	the XPath of the element
traffic_cost	float	estimated cost of monthly search traffic estimated organic monthly traffic to the domain; represents the estimated cost of paid monthly traffic based on etv and cpc values
rank_group	integer	group rank in SERP position within a group of elements with identical type values positions of elements with different type values are omitted from rank_group
rank_absolute	integer	absolute rank in SERP absolute position among all the elements in SERP
etv	float	estimated traffic volume estimated organic monthly traffic to the domain; calculated as the product of CTR (click-through-rate) and search volume values of the keyword a given URL ranks for
type	string	type of element = ‘knowledge_graph_images_item‘
link	object	link of the item
type	array	type of element = ‘link_element‘
title	string	title of the link element
description	string	description of the results element in SERP
url	string	URL link
items	array	elements of the knowledge graph images
type	array	type of element = ‘knowledge_graph_images_element‘
url	string	URL
domain	string	domain in the URL
alt	string	alternative text of the image
image_url	string	URL of the image
position	string	the alignment of the element in SERP can take the following values: left, right
xpath	string	the XPath of the element
traffic_cost	float	estimated cost of monthly search traffic estimated organic monthly traffic to the domain; represents the estimated cost of paid monthly traffic based on etv and cpc values
rank_group	integer	group rank in SERP position within a group of elements with identical type values positions of elements with different type values are omitted from rank_group
rank_absolute	integer	absolute rank in SERP absolute position among all the elements in SERP
etv	float	estimated traffic volume estimated organic monthly traffic to the domain; calculated as the product of CTR (click-through-rate) and search volume values of the keyword a given URL ranks for
type	string	type of element = ‘knowledge_graph_ai_overview_item‘‘
references	array	references relevant to the element
type	string	type of element = ‘ai_overview_reference‘
source	string	reference source name or title
domain	string	domain name of the reference
url	string	reference page URL
title	string	reference page title
text	string	reference text text snippet from the page that was used to generate the ai_overview_element
items	array	items present in the element
type	string	type of element = ‘ai_overview_element‘
title	string	title of the element
text	string	text or description of the element in SERP
images	array	images of the element
type	string	type of element = ‘images_element‘
alt	string	alt tag of the image
url	string	relevant URL
image_url	string	URL of the image the URL leading to the image on the original resource or DataForSEO storage (in case the original source is not available)
position	string	the alignment of the element in SERP can take the following values: left, right
xpath	string	the XPath of the element
traffic_cost	float	estimated cost of monthly search traffic estimated organic monthly traffic to the domain; represents the estimated cost of paid monthly traffic based on etv and cpc values
rank_group	integer	group rank in SERP position within a group of elements with identical type values positions of elements with different type values are omitted from rank_group
rank_absolute	integer	absolute rank in SERP absolute position among all the elements in SERP
etv	float	estimated traffic volume estimated organic monthly traffic to the domain; calculated as the product of CTR (click-through-rate) and search volume values of the keyword a given URL ranks for
type	string	type of element = ‘knowledge_graph_list_item‘
title	string	title of the item
link	object	link of the item
type	array	type of element = ‘link_element‘
title	string	title of the link element
description	string	description of the results element in SERP
url	string	URL link
data_attrid	string	google defined data attribute ID example: action:listen_artist
items	array	elements of the knowledge graph list
type	array	type of element = ‘knowledge_graph_list_element‘
title	string	title of the element
subtitle	string	subtitle of the element
url	string	URL
domain	string	domain in the URL
image_url	string	URL of the image
position	string	the alignment of the element in SERP can take the following values: left, right
xpath	string	the XPath of the element
traffic_cost	float	estimated cost of monthly search traffic estimated organic monthly traffic to the domain; represents the estimated cost of paid monthly traffic based on etv and cpc values
rank_group	integer	group rank in SERP position within a group of elements with identical type values positions of elements with different type values are omitted from rank_group
rank_absolute	integer	absolute rank in SERP absolute position among all the elements in SERP
etv	float	estimated traffic volume estimated organic monthly traffic to the domain; calculated as the product of CTR (click-through-rate) and search volume values of the keyword a given URL ranks for
type	string	type of element = ‘knowledge_graph_row_item‘
title	string	title of the item
data_attrid	string	google defined data attribute ID example: action:listen_artist
text	string	text featured in the item
links	array	links of the item
type	array	type of element = ‘link_element‘
title	string	title of the link element
description	string	description of the link
url	string	URL link
position	string	the alignment of the element in SERP can take the following values: left, right
xpath	string	the XPath of the element
traffic_cost	float	estimated cost of monthly search traffic estimated organic monthly traffic to the domain; represents the estimated cost of paid monthly traffic based on etv and cpc values
rank_group	integer	group rank in SERP position within a group of elements with identical type values positions of elements with different type values are omitted from rank_group
rank_absolute	integer	absolute rank in SERP absolute position among all the elements in SERP
etv	float	estimated traffic volume estimated organic monthly traffic to the domain; calculated as the product of CTR (click-through-rate) and search volume values of the keyword a given URL ranks for
type	string	type of element = ‘knowledge_graph_part_item‘
title	string	title of the item
text	string	text featured in the item
data_attrid	string	google defined data attribute ID example: action:listen_artist
links	array	links of the item
type	array	type of element = ‘link_element‘
title	string	title of the link element
description	string	description of the link
url	string	URL link
position	string	the alignment of the element in SERP can take the following values: left, right
xpath	string	the XPath of the element
traffic_cost	float	estimated cost of monthly search traffic estimated organic monthly traffic to the domain; represents the estimated cost of paid monthly traffic based on etv and cpc values
rank_group	integer	group rank in SERP position within a group of elements with identical type values positions of elements with different type values are omitted from rank_group
rank_absolute	integer	absolute rank in SERP absolute position among all the elements in SERP
etv	float	estimated traffic volume estimated organic monthly traffic to the domain; calculated as the product of CTR (click-through-rate) and search volume values of the keyword a given URL ranks for
type	string	type of element = ‘knowledge_graph_shopping_item‘
data_attrid	string	google defined data attribute ID example: action:listen_artist
items	array	elements of the knowledge graph shopping item
type	array	type of element = ‘knowledge_graph_shopping_element‘
title	string	title of the element
url	string	URL
domain	string	domain in the URL
price	object	price indicated in the element
current	float	current price indicates the current price of the product or service featured in the result
regular	float	regular price indicates the regular price of the product or service with no discounts applied
max_value	float	the maximum price the maximum price of the product or service as indicated in the result
currency	string	currency of the listed price ISO code of the currency applied to the price
is_price_range	boolean	price is provided as a range indicates whether a price is provided in a range
displayed_price	string	price string in the result raw price string as provided in the result
source	string	web source of the shopping element indicates the source of information included in the element
snippet	string	description of the shopping element
marketplace	string	merchant account provider ecommerce site that hosts products or websites of individual sellers under the same merchant account example: by Google
marketplace_url	string	URL to the merchant account provider ecommerce site that hosts products or websites of individual sellers under the same merchant account
position	string	the alignment of the element in SERP can take the following values: left, right
xpath	string	the XPath of the element
traffic_cost	float	estimated cost of monthly search traffic estimated organic monthly traffic to the domain; represents the estimated cost of paid monthly traffic based on etv and cpc values
rank_group	integer	group rank in SERP position within a group of elements with identical type values positions of elements with different type values are omitted from rank_group
rank_absolute	integer	absolute rank in SERP absolute position among all the elements in SERP
etv	float	estimated traffic volume estimated organic monthly traffic to the domain; calculated as the product of CTR (click-through-rate) and search volume values of the keyword a given URL ranks for
type	string	type of element = ‘knowledge_graph_expanded_item‘
title	string	title of the element
data_attrid	string	google defined data attribute ID example: action:listen_artist
expanded_element	array	expanded element
type	array	type of element = ‘knowledge_graph_expanded_element‘
featured_title	string	featured title of the element
url	string	URL
domain	string	domain in the URL
title	string	title of the element
snippet	string	description of the shopping element
table	object	table featured in the expanded element
table_header	array	table header
table_content	array	content of the table
position	string	the alignment of the element in SERP can take the following values: left, right
xpath	string	the XPath of the element
traffic_cost	float	estimated cost of monthly search traffic estimated organic monthly traffic to the domain; represents the estimated cost of paid monthly traffic based on etv and cpc values
rank_group	integer	group rank in SERP position within a group of elements with identical type values positions of elements with different type values are omitted from rank_group
rank_absolute	integer	absolute rank in SERP absolute position among all the elements in SERP
etv	float	estimated traffic volume estimated organic monthly traffic to the domain; calculated as the product of CTR (click-through-rate) and search volume values of the keyword a given URL ranks for
type	string	type of element = ‘knowledge_graph’
position	string	the alignment of the element in SERP can take the following values: left, right
xpath	string	the XPath of the element
traffic_cost	float	estimated cost of monthly search traffic estimated organic monthly traffic to the domain; represents the estimated cost of paid monthly traffic based on etv and cpc values
rank_group	integer	group rank in SERP position within a group of elements with identical type values positions of elements with different type values are omitted from rank_group
rank_absolute	integer	absolute rank in SERP absolute position among all the elements in SERP
etv	float	estimated traffic volume estimated organic monthly traffic to the domain; calculated as the product of CTR (click-through-rate) and search volume values of the keyword a given URL ranks for
‘featured_snippet’ element in SERP
title	string	title of the result in SERP
featured_title	string	the title of the featured snippets source page
description	string	description of the results element in SERP
table	object	results table if there are none, equals null
table_header	array	column names
table_content	array	the content of the table one line of the table in this element of the array
type	string	type of element = ‘featured_snippet’
domain	string	full domain in SERP of the Ad element
main_domain	string	main domain in SERP without subdomains
url	string	relevant absolute URL of the element in SERP
relative_url	string	relative URL of the element in SERP
is_new	boolean	new element indicates whether the element is new compared with the previous version of the database
is_up	boolean	element went up indicates whether the element went up in SERP compared with the previous version of the database
is_down	boolean	element went down indicates whether the element went down in SERP compared with the previous version of the database
previous_rank_absolute	integer	previous absolute rank in SERP absolute position among all the elements in SERP previous to the most recent update
images	array	images of the element
type	string	type of element = ‘images_element‘
alt	string	alt tag of the image
url	string	relevant URL
timestamp	string	date and time when the result was published in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00” example: 2019-11-15 12:57:46 +00:00
rank_info	object	page and domain rank information
page_rank	integer	page rank page_rank is calculated based on the method for node ranking in a linked database – a principle used in the original Google PageRank algorithm; learn more about the metric and how it is calculated in this help center article
main_domain_rank	integer	main domain rank main_domain_rank is calculated based on the method for node ranking in a linked database – a principle used in the original Google PageRank algorithm learn more about the metric and how it is calculated in this help center article
position	string	the alignment of the element in SERP can take the following values: left, right
xpath	string	the XPath of the element
traffic_cost	float	estimated cost of monthly search traffic represents the estimated cost of paid monthly traffic based on etv and cpc values
rank_group	integer	group rank in SERP position within a group of elements with identical type values positions of elements with different type values are omitted from rank_group
rank_absolute	integer	absolute rank in SERP absolute position among all the elements in SERP
etv	float	estimated traffic volume estimated organic monthly traffic to the domain calculated as the product of CTR (click-through-rate) and search volume values of the keyword a given URL ranks for
‘top_stories’ element in SERP
items	array	additional items present in the element if there are none, equals null
type	string	type of element = ‘top_stories_element‘
source	string	source of the element indicates the source of information included in the top stories element
domain	string	domain in SERP
title	string	title of the result in SERP
date	string	the date when the page source of the element was published
amp_version	boolean	Accelerated Mobile Pages indicates whether an item has the Accelerated Mobile Page (AMP) version
url	string	URL
timestamp	string	date and time when the episode was added in the format “year-month-date:minutes:UTC_difference_hours:UTC_difference_minutes” example: 2019-11-15 12:57:46 +00:00
image_url	string	URL of the image the URL leading to the image on the original resource or DataForSEO storage (in case the original source is not available)
badges	array	badges relevant to the element
type	string	type of element = ‘top_stories’
position	string	the alignment of the element in SERP can take the following values: left, right
xpath	string	the XPath of the element
traffic_cost	float	estimated cost of monthly search traffic represents the estimated cost of paid monthly traffic based on etv and cpc values
rank_group	integer	group rank in SERP position within a group of elements with identical type values positions of elements with different type values are omitted from rank_group
rank_absolute	integer	absolute rank in SERP absolute position among all the elements in SERP
etv	float	estimated traffic volume estimated organic monthly traffic to the domain calculated as the product of CTR (click-through-rate) and search volume values of the keyword a given URL ranks for
‘twitter’ element in SERP
title	string	title of the result in SERP
url	string	URL
items	array	additional items present in the element if there are none, equals null
type	string	type of element = ‘twitter_element‘
tweet	string	tweet message
date	string	the posting date
url	string	URL
timestamp	string	date and time when the result was published in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00” example: 2019-11-15 12:57:46 +00:00
type	string	type of element = ‘twitter’
position	string	the alignment of the element in SERP can take the following values: left, right
xpath	string	the XPath of the element
traffic_cost	float	estimated cost of monthly search traffic represents the estimated cost of paid monthly traffic based on etv and cpc values
rank_group	integer	group rank in SERP position within a group of elements with identical type values positions of elements with different type values are omitted from rank_group
rank_absolute	integer	absolute rank in SERP absolute position among all the elements in SERP
etv	float	estimated traffic volume estimated organic monthly traffic to the domain; calculated as the product of CTR (click-through-rate) and search volume values of the keyword a given URL ranks for
‘map’ element in SERP
title	string	title of the result in SERP
url	string	URL of the result in SERP
type	string	type of element = ‘map’
position	string	the alignment of the element in SERP can take the following values: left, right
xpath	string	the XPath of the element
traffic_cost	float	estimated cost of monthly search traffic represents the estimated cost of paid monthly traffic based on etv and cpc values
rank_group	integer	group rank in SERP position within a group of elements with identical type values; positions of elements with different type values are omitted from rank_group
rank_absolute	integer	absolute rank in SERP absolute position among all the elements in SERP
etv	float	estimated traffic volume estimated organic monthly traffic to the domain; calculated as the product of CTR (click-through-rate) and search volume values of the keyword a given URL ranks for
‘google_flights’ element in SERP
type	string	type of element = ‘google_flights’
title	string	title of the result in SERP
url	string	URL of the result in SERP
items	array	additional items present in the element if there are none, equals null
type	string	type of element = ‘google_flights_element‘
description	string	description
url	string	URL
position	string	the alignment of the element in SERP can take the following values: left, right
xpath	string	the XPath of the element
traffic_cost	float	estimated cost of monthly search traffic represents the estimated cost of paid monthly traffic based on etv and cpc values
rank_group	integer	group rank in SERP position within a group of elements with identical type values positions of elements with different type values are omitted from rank_group
rank_absolute	integer	absolute rank in SERP absolute position among all the elements in SERP
etv	float	estimated traffic volume estimated organic monthly traffic to the domain; calculated as the product of CTR (click-through-rate) and search volume values of the keyword a given URL ranks for
‘google_reviews’ element in SERP
reviews_count	integer	the number of reviews
place_id	string	the identifier of a place
feature	string	the additional feature of the review
type	string	type of element = ‘google_reviews’
position	string	the alignment of the element in SERP can take the following values: left, right
xpath	string	the XPath of the element
traffic_cost	float	estimated cost of monthly search traffic represents the estimated cost of paid monthly traffic based on etv and cpc values
rank_group	integer	group rank in SERP position within a group of elements with identical type values positions of elements with different type values are omitted from rank_group
rank_absolute	integer	absolute rank in SERP absolute position among all the elements in SERP
etv	float	estimated traffic volume estimated organic monthly traffic to the domain; calculated as the product of CTR (click-through-rate) and search volume values of the keyword a given URL ranks for
‘video’ element in SERP
items	array	additional items present in the element if there are none, equals null
type	string	type of element = ‘video_element‘
source	string	source of the element indicates the source of the video
title	string	title of the result in SERP
url	string	URL
timestamp	string	date and time when the result was published in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00” example: 2019-11-15 12:57:46 +00:00
type	string	type of element = ‘video’
position	string	the alignment of the element in SERP can take the following values: left, right
xpath	string	the XPath of the element
traffic_cost	float	estimated cost of monthly search traffic represents the estimated cost of paid monthly traffic based on etv and cpc values
rank_group	integer	group rank in SERP position within a group of elements with identical type values; positions of elements with different type values are omitted from rank_group
rank_absolute	integer	absolute rank in SERP absolute position among all the elements in SERP
etv	float	estimated traffic volume estimated organic monthly traffic to the domain calculated as the product of CTR (click-through-rate) and search volume values of the keyword a given URL ranks for
‘people_also_ask’ element in SERP
items	array	additional items present in the element if there are none, equals null
type	string	type of element = ‘people_also_ask_element‘
title	string	title of the result in SERP
seed_question	string	question that triggered additional expanded elements
xpath	string	the XPath of the element
expanded_element	array	expanded element
type	string	type of element = ‘people_also_ask_expanded_element‘
featured_title	string	title
url	string	relevant URL
domain	string	domain in SERP
code>title	string	title of the result in SERP
description	string	description of the results element in SERP
images	array	images of the element
type	string	type of element = ‘images_element‘
alt	string	alt tag of the image
url	string	relevant URL
image_url	string	URL of the image the URL leading to the image on the original resource or DataForSEO storage (in case the original source is not available)
timestamp	string	date and time when the result was published in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00” example: 2019-11-15 12:57:46 +00:00
table	object	results table if there are none, equals null
table_header	array	column names
table_content	array	the content of the table one line of the table in this element of the array
type	string	type of element = ‘people_also_ask_ai_overview_expanded_element‘
items	array	array of items
type	string	type of element = ‘ai_overview_element‘
rank_group	integer	group rank in SERP position within a group of elements with identical type values positions of elements with different type values are omitted from rank_group
rank_absolute	integer	absolute rank in SERP absolute position among all the elements in SERP
position	string	the alignment of the element in SERP can take the following values: left, right
title	string	title of the element
text	string	text or description of the element in SERP
markdown	string	content of the element in markdown format
links	array	website links featured in the element
type	string	type of element = ‘link_element‘
title	string	link anchor text
description	string	link description
url	string	link URL
domain	string	domain in SERP
images	array	images of the element if there are none, equals null
type	string	type of element = ‘images_element‘
alt	string	alt tag of the image
url	string	relevant URL
image_url	string	URL of the image the URL leading to the image on the original resource or DataForSEO storage (in case the original source is not available)
references	array	references relevant to the element includes references to webpages that were used to generate the ai_overview_element
type	string	type of element = ‘ai_overview_reference‘
source	string	reference source name or title
domain	string	domain name of the reference
url	string	reference page URL
title	string	reference page title
text	string	reference text text snippet from the page that was used to generate the ai_overview_element
type	string	type of element = ‘ai_overview_video_element‘
position	string	the alignment of the element in SERP can take the following values: left, right
title	string	title of the element
snippet	string	additional information for the video
url	string	URL of the link to the video
domain	string	domain of the website hosting the video
image_url	string	URL to the image thumbnail of the video
source	string	name of the source of the video
date	string	date when the video was published or indexed example: Apr 26, 2024
timestamp	string	date and time when the video was published or indexed in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00” example: 2019-11-15 12:57:46 +00:00
type	string	type of element = ‘ai_overview_table_element‘
position	string	the alignment of the element in SERP can take the following values: left, right
markdown	string	content of the element in markdown format
table	object	table present in the element the header and content of the table present in the element
table_header	array	content in the header of the table
table_content	array	array of contents of the table present in the element each array represents the table row
references	array	references relevant to the element includes references to webpages that were used to generate the ai_overview_element
type	string	type of element = ‘ai_overview_reference‘
source	string	reference source name or title
domain	string	domain name of the reference
url	string	reference page URL
title	string	reference page title
text	string	reference text text snippet from the page that was used to generate the ai_overview_element
type	string	type of element = ‘ai_overview_expanded_element‘
position	string	the alignment of the element in SERP can take the following values: left, right
title	string	title of the element in SERP
text	string	additional text of the element in SERP
components	array	array of components of the element
type	array	type of component = ‘ai_overview_expanded_component‘
title	string	title of the element in SERP
text	string	text of the component
markdown	string	text of the component in the markdwon format
images	array	images of the component if there are none, equals null
type	string	type of element = ‘images_element‘
alt	string	alt tag of the image
url	string	relevant URL
image_url	string	URL of the image the URL leading to the image on the original resource or DataForSEO storage (in case the original source is not available)
links	array	sitelinks the links shown below some of Google’s search results if there are none, equals null
type	string	type of element = ‘link_element‘
title	string	title of the link
description	string	description of the link
url	string	URL in link
domain	string	domain in link
references	array	references relevant to the element includes references to webpages that were used to generate the ai_overview_element
type	string	type of element = ‘ai_overview_reference‘
source	string	reference source name or title
domain	string	domain name of the reference
url	string	reference page URL
title	string	reference page title
text	string	reference text text snippet from the page that was used to generate the ai_overview_element
references	array	additional references relevant to the item includes references to webpages that may have been used to generate the ai_overview
type	string	type of element = ‘ai_overview_reference‘
source	string	reference source name or title
domain	string	domain name of the reference
url	string	reference page URL
title	string	reference page title
text	string	reference text text snippet from the page that was used to generate the ai_overview_element
position	string	the alignment of the element in SERP can take the following values: left, right
xpath	string	the XPath of the element
traffic_cost	float	estimated cost of monthly search traffic represents the estimated cost of paid monthly traffic based on etv and cpc values
rank_group	integer	group rank in SERP position within a group of elements with identical type values; positions of elements with different type values are omitted from rank_group
rank_absolute	integer	absolute rank in SERP absolute position among all the elements in SERP
etv	float	estimated traffic volume estimated organic monthly traffic to the domain; calculated as the product of CTR (click-through-rate) and search volume values of the keyword a given URL ranks for
‘images’ element in SERP
title	string	title of the result in SERP
url	string	relevant URL
items	array	additional items present in the element if there are none, equals null
type	string	type of element = ‘images_element‘
alt	string	the alt tag of the image
url	string	URL
image_url	string	URL of the image the URL leading to the image on the original resource or DataForSEO storage (in case the original source is not available)
related_image_searches	array	contains keywords and images related to the specified search term if there are none, equals null
type	string	type of element = ‘related_image_searches_element‘
title	string	title of the element indicates keyword that may be used with the specified term to refine image search
alt	string	alt tag of the featured image
url	string	original URL of the featured image the URL leading to the image on the original resource
image_url	string	URL to the compressed featured image the URL leading to the image on DataForSEO storage
type	string	type of element = ‘images’
position	string	the alignment of the element in SERP can take the following values: left, right
xpath	string	the XPath of the element
traffic_cost	float	estimated cost of monthly search traffic represents the estimated cost of paid monthly traffic based on etv and cpc values
rank_group	integer	group rank in SERP position within a group of elements with identical type values; positions of elements with different type values are omitted from rank_group
rank_absolute	integer	absolute rank in SERP absolute position among all the elements in SERP
etv	float	estimated traffic volume estimated organic monthly traffic to the domain; calculated as the product of CTR (click-through-rate) and search volume values of the keyword a given URL ranks for
‘shopping’ element in SERP
title	string	title of the result in SERP
items	array	additional items present in the element if there are none, equals null
type	string	type of element = ‘shopping_element‘
title	string	title of the result in SERP
price	object	price
current	float	current price indicates the current price of the product or service featured in the result
regular	float	regular price indicates the regular price of the product or service with no discounts applied
max_value	float	the maximum price the maximum price of the product or service as indicated in the result
currency	string	currency of the listed price ISO code of the currency applied to the price
is_price_range	boolean	price is provided as a range indicates whether a price is provided in a range
displayed_price	string	price string in the result raw price string as provided in the result
source	string	source of the element indicates the source of information included in the ‘shopping’ element
description	string	the description of the results element in SERP
marketplace	string	merchant account provider commerce site that hosts products or websites of individual sellers under the same merchant account example: by Google
marketplace_url	string	relevant marketplace URL URL of the page on the marketplace website where the product is hosted
rating	object	the element’s rating the popularity rate based on reviews and displayed in SERP
rating_type	string	the type of rating here you can find the following elements: Max5, Percents, CustomMax
value	float	the value of the rating
votes_count	integer	the amount of feedback
rating_max	integer	the maximum value for a rating_type
type	string	type of element = ‘shopping’
position	string	the alignment of the element in SERP can take the following values: left, right
xpath	string	the XPath of the element
traffic_cost	float	estimated cost of monthly search traffic represents the estimated cost of paid monthly traffic based on etv and cpc values
rank_group	integer	group rank in SERP position within a group of elements with identical type values positions of elements with different type values are omitted from rank_group
rank_absolute	integer	absolute rank in SERP absolute position among all the elements in SERP
etv	float	estimated traffic volume estimated organic monthly traffic to the domain; calculated as the product of CTR (click-through-rate) and search volume values of the keyword a given URL ranks for
‘jobs’ element in SERP
title	string	title of the result in SERP
url	string	URL of the result in SERP
items	array	additional items present in the element if there are none, equals null
type	string	type of element = ‘jobs_element‘
title	string	title of the result in SERP
description	string	snippet
author	string	author
job_posted_time	string	the time when the job was posted
contract_type	string	contract type
salary	string	salary
url	string	URL
timestamp	string	date and time when the result was published in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00” example: 2019-11-15 12:57:46 +00:00
type	string	type of element = ‘jobs’
position	string	the alignment of the element in SERP can take the following values: left, right
xpath	string	the XPath of the element
traffic_cost	float	estimated cost of monthly search traffic represents the estimated cost of paid monthly traffic based on etv and cpc values
rank_group	integer	group rank in SERP position within a group of elements with identical type values; positions of elements with different type values are omitted from rank_group
rank_absolute	integer	absolute rank in SERP absolute position among all the elements in SERP
etv	float	estimated traffic volume estimated organic monthly traffic to the domain; calculated as the product of CTR (click-through-rate) and search volume values of the keyword a given URL ranks for
‘events’ element in SERP
type	string	type of element = ‘events’
url	string	URL of the result in SERP
title	string	title of the result in SERP
items	array	additional items present in the element if there are none, equals null
type	string	type of element = ‘events_element‘
title	string	title of the item
snippet	string	snippet of the element
url	string	events_element URL
position	string	the alignment of the element in SERP can take the following values: left, right
xpath	string	the XPath of the element
traffic_cost	float	estimated cost of monthly search traffic represents the estimated cost of paid monthly traffic based on etv and cpc values
rank_group	integer	group rank in SERP position within a group of elements with identical type values; positions of elements with different type values are omitted from rank_group
rank_absolute	integer	absolute rank in SERP absolute position among all the elements in SERP
etv	float	estimated traffic volume estimated organic monthly traffic to the domain; calculated as the product of CTR (click-through-rate) and search volume values of the keyword a given URL ranks for
‘mention_carousel’ element in SERP
title	string	title of the result in SERP
items	array	additional items present in the element if there are none, equals null
type	string	type of element = ‘mention_carousel_element‘
title	string	title of the item
price	object	price
current	float	current price indicates the current price of the product or service featured in the result
regular	float	regular price indicates the regular price of the product or service with no discounts applied
max_value	float	the maximum price the maximum price of the product or service as indicated in the result
currency	string	currency of the listed price ISO code of the currency applied to the price
is_price_range	boolean	price is provided as a range indicates whether a price is provided in a range
displayed_price	string	price string in the result raw price string as provided in the result
rating	object	the item’s rating the popularity rate based on reviews and displayed in SERP
rating_type	string	the type of rating here you can find the following elements: Max5, Percents, CustomMax
value	integer	the value of the rating
votes_count	integer	the amount of feedback
rating_max	integer	the maximum value for a rating_type
mentioned_in	array	additional elements in the mention_carousel item
type	string	type of element = ‘link_element‘
title	string	title of the item
snippet	string	snippet of the element
url	string	link_element URL
type	string	type of element = ‘mention_carousel’
position	string	the alignment of the element in SERP can take the following values: left, right
xpath	string	the XPath of the element
traffic_cost	float	estimated cost of monthly search traffic represents the estimated cost of paid monthly traffic based on etv and cpc values
rank_group	integer	group rank in SERP position within a group of elements with identical type values; positions of elements with different type values are omitted from rank_group
rank_absolute	integer	absolute rank in SERP absolute position among all the elements in SERP
etv	float	estimated traffic volume estimated organic monthly traffic to the domain; calculated as the product of CTR (click-through-rate) and search volume values of the keyword a given URL ranks for
‘find_results_on’ element in SERP
type	string	type of element = ‘find_results_on’
items	array	additional items present in the element if there are none, equals null
type	string	type of element = ‘find_results_on_element‘
title	string	title of the result in SERP
domain	string	domain name of the source
url	string	find_results_on_element URL
source	string	source of the element indicates the source of information included in the element
position	string	the alignment of the element in SERP can take the following values: left, right
xpath	string	the XPath of the element
traffic_cost	float	estimated cost of monthly search traffic represents the estimated cost of paid monthly traffic based on etv and cpc values
rank_group	integer	group rank in SERP position within a group of elements with identical type values positions of elements with different type values are omitted from rank_group
rank_absolute	integer	absolute rank in SERP absolute position among all the elements in SERP
etv	float	estimated traffic volume estimated organic monthly traffic to the domain; calculated as the product of CTR (click-through-rate) and search volume values of the keyword a given URL ranks for
‘stocks_box’ element in SERP
type	string	type of element = ‘‘stocks_box’’
title	string	title of the result in SERP
source	string	source of the element indicates the source of information provided in the stocks_box element
snippet	string	snippet of the element
price	object	price quote featured on Google at the time when our API pulled the results note that stock prices displayed in the stocks_box element may be delayed according to Google Finance disclaimer
current	float	current price indicates the current price of the product or service featured in the result
regular	float	regular price indicates the regular price of the product or service with no discounts applied
max_value	float	the maximum price the maximum price of the product or service as indicated in the result
currency	string	currency of the listed price ISO code of the currency applied to the price
is_price_range	boolean	price is provided as a range indicates whether a price is provided in a range
displayed_price	string	price string in the result raw price string as provided in the result
url	string	relevant URL
domain	string	domain in SERP
table	object	results table if there are none, equals null
table_header	array	column names if there are none, equals null
table_content	array	the content of the table additional information about the stock prices displayed below the graph if there is none, equals null
graph	object	contains data provided in the graph of the element
items	array	data provided for the date and time when our API pulled the results
type	string	type of element = ‘graph_element’ corresponds to one point on the graph that indicates the stock price for a specific date and time
date	string	date and time in the yyyy-mm-ddThh:mm:ss ISO 8601 format indicates date and time for which the stock price in the value field is provided
value	integer	stock price stock price for the date and time provided in the date field
previous_items	array	previous close data contains stock price data based on the preceding time period
position	string	the alignment of the element in SERP can take the following values: left, right
xpath	string	the XPath of the element
traffic_cost	float	estimated cost of monthly search traffic represents the estimated cost of paid monthly traffic based on etv and cpc values
rank_group	integer	group rank in SERP position within a group of elements with identical type values positions of elements with different type values are omitted from rank_group
rank_absolute	integer	absolute rank in SERP absolute position among all the elements in SERP
etv	float	estimated traffic volume estimated organic monthly traffic to the domain; calculated as the product of CTR (click-through-rate) and search volume values of the keyword a given URL ranks for
‘currency_box’ element in SERP
type	string	type of element = ‘currency_box’
value	integer	value to convert
converted_value	float	value converted to a requested currency indicates the exact value based on Google Fincance data at the time when our API pulled the results note that exchange rates displayed in the currency_box element may be delayed according to the Google Finance disclaimer
currency	string	currency to convert
converted_currency	string	converted currency
timestamp	string	date and time when the result was published in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00” example: 2019-11-15 12:57:46 +00:00
table	object	results table if there are none, equals null
table_header	array	column names if there are none, equals null
table_content	array	the content of the table information about the requested exchange rates as featured in SERP if there is none, equals null
graph	object	contains data provided in the graph of the element
items	array	data provided for the date and time when our API pulled the results
type	string	type of element = ‘graph_element’ corresponds to one point on the graph that indicates the exchange rate for a specific date and time
date	string	date and time in the yyyy-mm-ddThh:mm:ss ISO 8601 format indicates date and time for which the exchange rate in the value field is provided
value	float	exchange rate exchange rate for the date and time provided in the date field
previous_items	array	exchange rates on the preceding time period contains exchange rate data based on the preceding time period if there are none, equals null
type	string	type of element = ‘graph_element’ corresponds to one point on the graph that indicates the exchange rate for a specific date and time
date	string	date and time in the yyyy-mm-ddThh:mm:ss ISO 8601 format indicates the date and time for which the value field provides previous exchange rate
value	float	previous exchange rate exchange rate on the preceding time period
position	string	the alignment of the element in SERP can take the following values: left, right
xpath	string	the XPath of the element
traffic_cost	float	estimated cost of converting organic search traffic into paid represents the estimated monthly cost of running ads for the keyword that a given URL ranks for the metric is calculated as the product of organic etv and paid cpc values and indicates the cost of driving the estimated volume of monthly organic traffic through PPC advertising in Google Search
rank_group	integer	group rank in SERP position within a group of elements with identical type values positions of elements with different type values are omitted from rank_group
rank_absolute	integer	absolute rank in SERP absolute position among all the elements in SERP
etv	float	estimated traffic volume estimated organic monthly traffic to the domain calculated as the product of CTR (click-through-rate) and search volume values of the keyword a given URL ranks for
‘recipes’ element in SERP
type	string	type of element = ‘recipes’
items	array	additional items present in the element if there are none, equals null
type	string	type of element = ‘recipes_element‘
title	string	title of the item
url	string	recipes_element URL
domain	string	domain in SERP
source	string	source of the element indicates the source of information included in the top stories element
description	string	snippet of the element
time	string	the total time it takes to prepare the dish
rating	object	the item’s rating the popularity rate based on reviews and displayed in SERP
rating_type	string	the type of rating here you can find the following elements: Max5, Percents, CustomMax
value	integer	the value of the rating
votes_count	integer	the amount of feedback
rating_max	integer	the maximum value for a rating_type
position	string	the alignment of the element in SERP can take the following values: left, right
xpath	string	the XPath of the element
traffic_cost	float	estimated cost of monthly search traffic represents the estimated cost of paid monthly traffic based on etv and cpc values
rank_group	integer	group rank in SERP position within a group of elements with identical type values positions of elements with different type values are omitted from rank_group
rank_absolute	integer	absolute rank in SERP absolute position among all the elements in SERP
etv	float	estimated traffic volume estimated organic monthly traffic to the domain; calculated as the product of CTR (click-through-rate) and search volume values of the keyword a given URL ranks for
‘top_sights’ element in SERP
type	string	type of element = ‘top_sights’
items	array	additional items present in the element if there are none, equals null
type	string	type of element = ‘top_sights_element‘
title	string	title of the item
url	string	top_sights_element URL
description	string	snippet of the element
rating	object	the item’s rating the popularity rate based on reviews and displayed in SERP
rating_type	string	the type of rating here you can find the following elements: Max5, Percents, CustomMax
value	integer	the value of the rating
votes_count	integer	the amount of feedback
rating_max	integer	the maximum value for a rating_type
position	string	the alignment of the element in SERP can take the following values: left, right
xpath	string	the XPath of the element
traffic_cost	float	estimated cost of monthly search traffic represents the estimated cost of paid monthly traffic based on etv and cpc values
rank_group	integer	group rank in SERP position within a group of elements with identical type values positions of elements with different type values are omitted from rank_group
rank_absolute	integer	absolute rank in SERP absolute position among all the elements in SERP
etv	float	estimated traffic volume estimated organic monthly traffic to the domain; calculated as the product of CTR (click-through-rate) and search volume values of the keyword a given URL ranks for
‘scholarly_articles’ element in SERP
type	string	type of element = ‘scholarly_articles’
items	array	additional items present in the element if there are none, equals null
type	string	type of element = ‘scholarly_articles_element‘
title	string	title of the item
url	string	scholarly_articles_element URL
author	string	author
description	string	snippet of the element
rating	array	the item’s rating the popularity rate based on reviews and displayed in SERP
rating_type	string	the type of rating here you can find the following elements: Max5, Percents, CustomMax
value	integer	the value of the rating
votes_count	integer	the amount of feedback
rating_max	integer	the maximum value for a rating_type
position	string	the alignment of the element in SERP can take the following values: left, right
xpath	string	the XPath of the element
traffic_cost	float	estimated cost of monthly search traffic represents the estimated cost of paid monthly traffic based on etv and cpc values
rank_group	integer	group rank in SERP position within a group of elements with identical type values positions of elements with different type values are omitted from rank_group
rank_absolute	integer	absolute rank in SERP absolute position among all the elements in SERP
etv	float	estimated traffic volume estimated organic monthly traffic to the domain; calculated as the product of CTR (click-through-rate) and search volume values of the keyword a given URL ranks for
‘popular_products’ element in SERP
type	string	type of element = ‘popular_products’
items	array	additional items present in the element if there are none, equals null
type	string	type of element = ‘popular_products_element‘
title	string	title of the item
snippet	string	snippet of the element
price	object	price
current	float	current price indicates the current price of the product or service featured in the result
regular	float	regular price indicates the regular price of the product or service with no discounts applied
max_value	float	the maximum price the maximum price of the product or service as indicated in the result
currency	string	currency of the listed price ISO code of the currency applied to the price
is_price_range	boolean	price is provided as a range indicates whether a price is provided in a range
displayed_price	string	price string in the result raw price string as provided in the result
rating	object	the item’s rating the popularity rate based on reviews and displayed in SERP
rating_type	string	the type of rating here you can find the following elements: Max5, Percents, CustomMax
value	integer	the value of the rating
votes_count	integer	the amount of feedback
rating_max	integer	the maximum value for a rating_type
position	string	the alignment of the element in SERP can take the following values: left, right
xpath	string	the XPath of the element
traffic_cost	float	estimated cost of monthly search traffic represents the estimated cost of paid monthly traffic based on etv and cpc values
rank_group	integer	group rank in SERP position within a group of elements with identical type values positions of elements with different type values are omitted from rank_group
rank_absolute	integer	absolute rank in SERP absolute position among all the elements in SERP
etv	float	estimated traffic volume estimated organic monthly traffic to the domain; calculated as the product of CTR (click-through-rate) and search volume values of the keyword a given URL ranks for
‘podcasts’ element in SERP
type	string	type of element = ‘podcasts’
items	array	additional items present in the element if there are none, equals null
type	string	type of element = ‘podcasts_element‘
title	string	title of the item
url	string	podcasts_element URL
snippet	string	snippet of the element
timestamp	string	date and time when the episode was added in the format “year-month-date:minutes:UTC_difference_hours:UTC_difference_minutes” example: 2019-11-15 12:57:46 +00:00
time_to_play	string	the total time it will take to play a podcast
position	string	the alignment of the element in SERP can take the following values: left, right
xpath	string	the XPath of the element
traffic_cost	float	estimated cost of monthly search traffic represents the estimated cost of paid monthly traffic based on etv and cpc values
rank_group	integer	group rank in SERP position within a group of elements with identical type values positions of elements with different type values are omitted from rank_group
rank_absolute	integer	absolute rank in SERP absolute position among all the elements in SERP
etv	float	estimated traffic volume estimated organic monthly traffic to the domain; calculated as the product of CTR (click-through-rate) and search volume values of the keyword a given URL ranks for
‘questions_and_answers’ element in SERP
type	string	type of element = ‘questions_and_answers’
items	array	additional items present in the element if there are none, equals null
type	string	type of element = ‘questions_and_answers_element‘
url	string	questions_and_answers_element URL
question_text	string	question included in the item
answer_text	string	answer included in the item
source	string	name of the source
votes	integer	number of votes
position	string	the alignment of the element in SERP can take the following values: left, right
xpath	string	the XPath of the element
traffic_cost	float	estimated cost of monthly search traffic represents the estimated cost of paid monthly traffic based on etv and cpc values
rank_group	integer	group rank in SERP position within a group of elements with identical type values positions of elements with different type values are omitted from rank_group
rank_absolute	integer	absolute rank in SERP absolute position among all the elements in SERP
etv	float	estimated traffic volume estimated organic monthly traffic to the domain; calculated as the product of CTR (click-through-rate) and search volume values of the keyword a given URL ranks for
‘hotels_pack’ element in SERP
type	string	type of element = ‘hotels_pack’
title	string	title of the result in SERP
date_from	string	starting date of stay in the format “year-month-date”; example: 2019-11-15
date_to	string	ending date of stay in the format “year-month-date”; example: 2019-11-17
items	array	contains results featured in the ‘hotels_pack’ element of SERP
type	string	type of element = ‘hotels_pack_element’
title	string	title of the place
url	string	relevant URL
desription	string	description of the place in SERP
domain	string	domain in SERP
rating	object	the item’s rating the popularity rate based on reviews and displayed in SERP
rating_type	string	the type of rating here you can find the following elements: Max5, Percents, CustomMax
value	float	the value of the rating
votes_count	integer	the amount of feedback
rating_max	integer	the maximum value for a rating_type
price	object	price of booking a place for the specified dates of stay
current	float	current price indicates the current price of booking a place for the specified dates of stay
regular	float	regular price indicates the regular price of booking a place for the specified dates of stay
max_value	float	the maximum price the maximum price of booking a place for the specified dates of stay
currency	string	currency of the listed price ISO code of the currency applied to the price
is_price_range	boolean	price is provided as a range indicates whether a price is provided in a range
displayed_price	string	price string in the result raw price string as provided in the result
is_paid	boolean	indicates whether the element is an ad
position	string	the alignment of the element in SERP can take the following values: left, right
xpath	string	the XPath of the element
traffic_cost	float	estimated cost of monthly search traffic represents the estimated cost of paid monthly traffic based on etv and cpc values
rank_group	integer	group rank in SERP position within a group of elements with identical type values positions of elements with different type values are omitted from rank_group
rank_absolute	integer	absolute rank in SERP absolute position among all the elements in SERP
etv	float	estimated traffic volume estimated organic monthly traffic to the domain; calculated as the product of CTR (click-through-rate) and search volume values of the keyword a given URL ranks for
‘google_posts’ element in SERP
type	string	type of element = ‘google_posts’
posts_id	string	the identifier of the google_posts feature
feature	string	the additional feature of the review
cid	string	google-defined client id unique id of a local establishment; can be used with Google Reviews API to get a full list of reviews
position	string	the alignment of the element in SERP can take the following values: left, right
xpath	string	the XPath of the element
traffic_cost	float	estimated cost of monthly search traffic represents the estimated cost of paid monthly traffic based on etv and cpc values
rank_group	integer	group rank in SERP position within a group of elements with identical type values positions of elements with different type values are omitted from rank_group
rank_absolute	integer	absolute rank in SERP absolute position among all the elements in SERP
etv	float	estimated traffic volume estimated organic monthly traffic to the domain; calculated as the product of CTR (click-through-rate) and search volume values of the keyword a given URL ranks for
‘visual_stories’ element in SERP
type	string	type of element = ‘visual_stories’
items	array	contains results featured in the visual_stories element of SERP
type	string	type of element = ‘visual_stories_element’
title	string	title of the visual story
url	string	relevant URL
domain	string	domain in SERP
position	string	the alignment of the element in SERP can take the following values: left, right
xpath	string	the XPath of the element
traffic_cost	float	estimated cost of monthly search traffic estimated organic monthly traffic to the domain; represents the estimated cost of paid monthly traffic based on etv and cpc values
rank_group	integer	group rank in SERP position within a group of elements with identical type values positions of elements with different type values are omitted from rank_group
rank_absolute	integer	absolute rank in SERP absolute position among all the elements in SERP
etv	float	estimated traffic volume estimated organic monthly traffic to the domain; calculated as the product of CTR (click-through-rate) and search volume values of the keyword a given URL ranks for
‘commercial units’ element in SERP
type	string	type of element = ‘commercial_units’
title	string	title of the visual story
items	array	contains results featured in the commercial_units element of SERP
type	string	type of element = ‘commercial_units_element’
title	string	title of the element
url	string	relevant URL
domain	string	domain in SERP
price	object	price
current	float	current price indicates the current price of the product or service featured in the result
regular	float	regular price indicates the regular price of the product or service with no discounts applied
max_value	float	the maximum price the maximum price of the product or service as indicated in the result
currency	string	currency of the listed price ISO code of the currency applied to the price
is_price_range	boolean	price is provided as a range indicates whether a price is provided in a range
displayed_price	string	price string in the result raw price string as provided in the result
source	string	source
rating	object	the item’s rating the popularity rate based on reviews and displayed in SERP
rating_type	string	the type of rating here you can find the following elements: Max5, Percents, CustomMax
value	integer	the value of the rating
votes_count	integer	the amount of feedback
rating_max	integer	the maximum value for a rating_type
position	string	the alignment of the element in SERP can take the following values: left, right
xpath	string	the XPath of the element
traffic_cost	float	estimated cost of monthly search traffic estimated organic monthly traffic to the domain; represents the estimated cost of paid monthly traffic based on etv and cpc values
rank_group	integer	group rank in SERP position within a group of elements with identical type values positions of elements with different type values are omitted from rank_group
rank_absolute	integer	absolute rank in SERP absolute position among all the elements in SERP
etv	float	estimated traffic volume estimated organic monthly traffic to the domain; calculated as the product of CTR (click-through-rate) and search volume values of the keyword a given URL ranks for
‘local services’ element in SERP
type	string	type of element = ‘local_services’
title	string	title of the local services element
url	string	relevant URL
domain	string	domain in SERP
items	array	contains results featured in the local_services element of SERP
type	string	type of element = ‘local_services_element’
title	string	title of the element
url	string	relevant URL
domain	string	domain in SERP
description	string	description of the element
rating	object	the item’s rating the popularity rate based on reviews and displayed in SERP
rating_type	string	the type of rating here you can find the following elements: Max5, Percents, CustomMax
value	integer	the value of the rating
votes_count	integer	the amount of feedback
rating_max	integer	the maximum value for a rating_type
profile_image_url	string	URL to the image featured in the element
position	string	the alignment of the element in SERP can take the following values: left, right
xpath	string	the XPath of the element
traffic_cost	float	estimated cost of monthly search traffic estimated organic monthly traffic to the domain; represents the estimated cost of paid monthly traffic based on etv and cpc values
rank_group	integer	group rank in SERP position within a group of elements with identical type values positions of elements with different type values are omitted from rank_group
rank_absolute	integer	absolute rank in SERP absolute position among all the elements in SERP
etv	float	estimated traffic volume estimated organic monthly traffic to the domain; calculated as the product of CTR (click-through-rate) and search volume values of the keyword a given URL ranks for
‘google_hotels’ element in SERP
hotel_identifier	string	unique hotel identifier unique hotel identifier assigned by Google; example: "CgoIjaeSlI6CnNpVEAE"
url	string	URL of the element
position	string	the alignment of the element in SERP can take the following values: left, right
xpath	string	the XPath of the element
traffic_cost	float	estimated cost of monthly search traffic estimated organic monthly traffic to the domain; represents the estimated cost of paid monthly traffic based on etv and cpc values
rank_group	integer	group rank in SERP position within a group of elements with identical type values positions of elements with different type values are omitted from rank_group
rank_absolute	integer	absolute rank in SERP absolute position among all the elements in SERP
etv	float	estimated traffic volume estimated organic monthly traffic to the domain; calculated as the product of CTR (click-through-rate) and search volume values of the keyword a given URL ranks for
‘math_solver’ element in SERP
type	string	type of element = ‘math_solver’
title	string	title of the result in SERP
result	string	solution to the equation solution to the mathematical equation specified in the keyword field when setting a task
items	array	additional items present in the element if there are none, equals null
type	string	type of element = ‘math_solver_element‘
title	string	title of the item
expanded_element	array	expanded element
type	string	type of element = ‘math_solver_expanded_element‘
title	string	title of the element
solution	array	solution of the element displays steps to solve the mathematical equation as specified in the element
position	string	the alignment of the element in SERP can take the following values: left, right
xpath	string	the XPath of the element
traffic_cost	float	estimated cost of monthly search traffic estimated organic monthly traffic to the domain; represents the estimated cost of paid monthly traffic based on etv and cpc values
rank_group	integer	group rank in SERP position within a group of elements with identical type values positions of elements with different type values are omitted from rank_group
rank_absolute	integer	absolute rank in SERP absolute position among all the elements in SERP
etv	float	estimated traffic volume estimated organic monthly traffic to the domain; calculated as the product of CTR (click-through-rate) and search volume values of the keyword a given URL ranks for
‘product_considerations’ element in SERP
type	string	type of element = ‘product_considerations’
title	integer	title of the product considerations snippet
items	array	data provided for the date and time when our API pulled the results
type	string	type of element = ‘product_considerations_element’ contains the product consideration and expanded element with additional info
title	string	title of the element
consideration_category	string	category of the consideration element the category is indicated just above the title fo the consideration element
expanded_element	object	product consideration info contains an answer to the question articulated in the title
type	string	type of element = ‘product_considerations_expanded_element’
title	string	title of the expanded element
featured_title	string	alternative title featured in the element
breadcrumb	string	breadcrumb in SERP
snippet	string	text snippet
domain	string	source domain
url	string	source url
related_searches	array	search queries related to the elment
timestamp	string	date and time when the result was published in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00” example: 2019-11-15 12:57:46 +00:00
about_this_result	object	contains information from the ‘About this result’ panel ‘About this result’ panel provides additional context about why Google returned this result for the given query; this feature appears after clicking on the three dots next to most results
type	string	type of element = ‘about_this_result_element‘
url	string	result’s URL
source	string	source of additional information about the result
source_info	string	additional information about the result description of the website from Wikipedia or another additional context
source_url	string	URL to full information from the source
language	string	the language of the result
location	string	location for which the result is relevant
search_terms	array	matching search terms that appear in the result
related_terms	array	related search terms that appear in the result
type	string	type of element = ‘product_considerations_ai_overview_expanded_element’
items	array	items present in the element
type	string	type of element = ‘ai_overview_element‘
title	string	title of the element
text	string	text or description of the element in SERP
images	array	images of the element if there are none, equals null
type	string	type of element = ‘images_element‘
alt	string	alt tag of the image
url	string	relevant URL
image_url	string	URL of the image the URL leading to the image on the original resource or DataForSEO storage (in case the original source is not available)
references	array	references relevant to the element includes references to webpages that were used to generate the ai_overview_element
type	string	type of element = ‘ai_overview_reference‘
source	string	reference source name or title
domain	string	domain name of the reference
url	string	reference page URL
title	string	reference page title
text	string	reference text text snippet from the page that was used to generate the ai_overview_element
references	array	additional references relevant to the item includes references to webpages that may have been used to generate the product_considerations_ai_overview_expanded_element
type	string	type of element = ‘ai_overview_reference‘
source	string	reference source name or title
domain	string	domain name of the reference
url	string	reference page URL
title	string	reference page title
text	string	reference text text snippet from the page that was used to generate the product_considerations_ai_overview_expanded_element
position	string	the alignment of the element in SERP can take the following values: left, right
xpath	string	the XPath of the element
traffic_cost	float	estimated cost of converting organic search traffic into paid represents the estimated monthly cost of running ads for the keyword that a given URL ranks for the metric is calculated as the product of organic etv and paid cpc values and indicates the cost of driving the estimated volume of monthly organic traffic through PPC advertising in Google Search
rank_group	integer	group rank in SERP position within a group of elements with identical type values positions of elements with different type values are omitted from rank_group
rank_absolute	integer	absolute rank in SERP absolute position among all the elements in SERP
etv	float	estimated traffic volume estimated organic monthly traffic to the domain calculated as the product of CTR (click-through-rate) and search volume values of the keyword a given URL ranks for
‘short_videos’ element in SERP
type	string	type of element = ‘short_videos’
title	string	title of the element
items	array	additional items present in the element if there are none, equals null
type	string	type of element = ‘short_videos_element‘
title	string	title of the result in SERP
url	string	URL
domain	string	domain in SERP
source	string	source of the element indicates the source of information included in the top_stories_element
position	string	the alignment of the element in SERP can take the following values: left, right
xpath	string	the XPath of the element
traffic_cost	float	estimated cost of monthly search traffic estimated organic monthly traffic to the domain; represents the estimated cost of paid monthly traffic based on etv and cpc values
rank_group	integer	group rank in SERP position within a group of elements with identical type values positions of elements with different type values are omitted from rank_group
rank_absolute	integer	absolute rank in SERP absolute position among all the elements in SERP
etv	float	estimated traffic volume estimated organic monthly traffic to the domain; calculated as the product of CTR (click-through-rate) and search volume values of the keyword a given URL ranks for
‘refine_products’ element in SERP
type	string	type of element = ‘refine_products’
title	string	title of the element
items	array	additional items present in the element if there are none, equals null
type	string	type of element = ‘refine_products_element‘
title	string	title of the result in SERP
image_url	string	URL of the image the URL leading to the image on the original resource or DataForSEO storage (in case the original source is not available)
keyword	string	keyword for the related refined search
refine_type	string	type of search refinement
position	string	the alignment of the element in SERP can take the following values: left, right
xpath	string	the XPath of the element
traffic_cost	float	estimated cost of monthly search traffic estimated organic monthly traffic to the domain; represents the estimated cost of paid monthly traffic based on etv and cpc values
rank_group	integer	group rank in SERP position within a group of elements with identical type values positions of elements with different type values are omitted from rank_group
rank_absolute	integer	absolute rank in SERP absolute position among all the elements in SERP
etv	float	estimated traffic volume estimated organic monthly traffic to the domain; calculated as the product of CTR (click-through-rate) and search volume values of the keyword a given URL ranks for
‘explore_brands’ element in SERP
type	string	type of element = ‘explore_brands’
title	string	title of the element
items	array	additional items present in the element if there are none, equals null
type	string	type of element = ‘explore_brands_element‘
title	string	title of the result in SERP
url	string	URL
domain	string	domain in SERP
description	string	description of the result in SERP
image_url	string	URL of the image the URL leading to the image on the original resource or DataForSEO storage (in case the original source is not available)
position	string	the alignment of the element in SERP can take the following values: left, right
xpath	string	the XPath of the element
traffic_cost	float	estimated cost of monthly search traffic estimated organic monthly traffic to the domain; represents the estimated cost of paid monthly traffic based on etv and cpc values
rank_group	integer	group rank in SERP position within a group of elements with identical type values positions of elements with different type values are omitted from rank_group
rank_absolute	integer	absolute rank in SERP absolute position among all the elements in SERP
etv	float	estimated traffic volume estimated organic monthly traffic to the domain; calculated as the product of CTR (click-through-rate) and search volume values of the keyword a given URL ranks for
‘perspectives’ element in SERP
type	string	type of element = ‘perspectives’
title	string	title of the element
items	array	additional items present in the element if there are none, equals null
type	string	type of element = ‘perspectives_element‘
title	string	title of the result in SERP
description	string	description of the result in SERP
url	string	URL
domain	string	domain in SERP
date	string	the date or time when the page source of the element was published example: 13 hours ago
source	string	source of additional information about the result
timestamp	string	date and time when the result was published in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00” example: 2019-11-15 12:57:46 +00:00
position	string	the alignment of the element in SERP can take the following values: left, right
xpath	string	the XPath of the element
traffic_cost	float	estimated cost of monthly search traffic estimated organic monthly traffic to the domain; represents the estimated cost of paid monthly traffic based on etv and cpc values
rank_group	integer	group rank in SERP position within a group of elements with identical type values positions of elements with different type values are omitted from rank_group
rank_absolute	integer	absolute rank in SERP absolute position among all the elements in SERP
etv	float	estimated traffic volume estimated organic monthly traffic to the domain; calculated as the product of CTR (click-through-rate) and search volume values of the keyword a given URL ranks for
‘discussions_and_forums’ element in SERP
type	string	type of element = ‘discussions_and_forums’
title	string	title of the element
items	array	additional items present in the element if there are none, equals null
type	string	type of element = ‘discussions_and_forums_element‘
title	string	title of the result in SERP
url	string	URL to the source
domain	string	domain in SERP
source	string	source of additional information about the result
description	string	description of the result in SERP
timestamp	string	date and time when the result was published in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00” example: 2019-11-15 12:57:46 +00:00
posts_count	integer	number of posts from the discussion on the related source
position	string	the alignment of the element in SERP can take the following values: left, right
xpath	string	the XPath of the element
traffic_cost	float	estimated cost of monthly search traffic estimated organic monthly traffic to the domain; represents the estimated cost of paid monthly traffic based on etv and cpc values
rank_group	integer	group rank in SERP position within a group of elements with identical type values positions of elements with different type values are omitted from rank_group
rank_absolute	integer	absolute rank in SERP absolute position among all the elements in SERP
etv	float	estimated traffic volume estimated organic monthly traffic to the domain; calculated as the product of CTR (click-through-rate) and search volume values of the keyword a given URL ranks for
‘compare_sites’ element in SERP
type	string	type of element = ‘compare_sites’
title	string	title of the element
items	array	additional items present in the element if there are none, equals null
type	string	type of element = ‘compare_sites_element‘
title	string	title of the result in SERP
url	string	URL to the source
domain	string	domain in SERP
image_url	string	URL to the image
source	string	website name, source of the result
position	string	the alignment of the element in SERP can take the following values: left, right
xpath	string	the XPath of the element
traffic_cost	float	estimated cost of monthly search traffic estimated organic monthly traffic to the domain; represents the estimated cost of paid monthly traffic based on etv and cpc values
rank_group	integer	group rank in SERP position within a group of elements with identical type values positions of elements with different type values are omitted from rank_group
rank_absolute	integer	absolute rank in SERP absolute position among all the elements in SERP
etv	float	estimated traffic volume estimated organic monthly traffic to the domain; calculated as the product of CTR (click-through-rate) and search volume values of the keyword a given URL ranks for
‘third_party_reviews’ element in SERP
type	string	type of element = ‘third_party_reviews’
rank_group	integer	group rank in SERP position within a group of elements with identical type values positions of elements with different type values are omitted from rank_group
rank_absolute	integer	absolute rank in SERP absolute position among all the elements in SERP
position	string	the alignment of the element in SERP can take the following values: left, right
xpath	string	the XPath of the element
reviews_count	integer	the number of reviews
title	string	name of the third-party review source
url	string	URL of the third-party review source
rating	object	the element’s rating the popularity rate based on reviews and displayed in SERP
rating_type	string	the type of rating here you can find the following elements: Max5, Percents, CustomMax
value	integer	the value of the rating
votes_count	integer	the amount of feedback
rating_max	integer	the maximum value for a rating_type
‘ai_overview’ element in SERP
type	string	type of element = ‘ai_overview’
asynchronous_ai_overview	boolean	indicates whether the element is loaded asynchronically if true, the ai_overview element is loaded asynchronically; if false, the ai_overview element is loaded from cache
markdown	string/td>	content of the element in markdown format the text of the ai_overview formatted in the markdown markup language
items	array	items present in the element
type	string	type of element = ‘ai_overview_element‘
title	string	title of the element
text	string	text or description of the element in SERP
markdown	string	content of the element in markdown format
links	array	website links featured in the element
type	string	type of element = ‘link_element‘
title	string	link anchor text
description	string	link description
url	string	link URL
domain	string	domain in SERP
images	array	images of the element if there are none, equals null
type	string	type of element = ‘images_element‘
alt	string	alt tag of the image
url	string	relevant URL
image_url	string	URL of the image the URL leading to the image on the original resource or DataForSEO storage (in case the original source is not available)
references	array	references relevant to the element includes references to webpages that were used to generate the ai_overview_element
type	string	type of element = ‘ai_overview_reference‘
source	string	reference source name or title
domain	string	domain name of the reference
url	string	reference page URL
title	string	reference page title
text	string	reference text text snippet from the page that was used to generate the ai_overview_element
type	string	type of element = ‘ai_overview_video_element‘
title	string	title of the element
snippet	string	additional information for the video
url	string	URL of the link to the video
domain	string	domain of the website hosting the video
image_url	string	URL to the image thumbnail of the video
source	string	name of the source of the video
date	string	date when the video was published or indexed example: Apr 26, 2024
timestamp	string	date and time when the video was published or indexed in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00” example: 2019-11-15 12:57:46 +00:00
type	string	type of element = ‘ai_overview_table_element‘
markdown	string	content of the element in markdown format
table	object	table present in the element the header and content of the table present in the element
table_header	array	content in the header of the table
table_content	array	array of contents of the table present in the element each array represents the table row
references	array	references relevant to the element includes references to webpages that were used to generate the ai_overview_element
type	string	type of element = ‘ai_overview_reference‘
source	string	reference source name or title
domain	string	domain name of the reference
url	string	reference page URL
title	string	reference page title
text	string	reference text text snippet from the page that was used to generate the ai_overview_element
type	string	type of element = ‘ai_overview_expanded_element‘
title	string	title of the element in SERP
text	string	additional text of the element in SERP
components	array	array of components of the element
type	array	type of component = ‘ai_overview_expanded_component‘
title	string	title of the element in SERP
text	string	text of the component
markdown	string	text of the component in the markdwon format
images	array	images of the component if there are none, equals null
type	string	type of element = ‘images_element‘
alt	string	alt tag of the image
url	string	relevant URL
image_url	string	URL of the image the URL leading to the image on the original resource or DataForSEO storage (in case the original source is not available)
links	array	sitelinks the links shown below some of Google’s search results if there are none, equals null
type	string	type of element = ‘link_element‘
title	string	title of the link
description	string	description of the link
url	string	URL in link
domain	string	domain in link
references	array	additional references relevant to the item includes references to webpages that may have been used to generate the ai_overview
type	string	type of element = ‘ai_overview_reference‘
source	string	reference source name or title
domain	string	domain name of the reference
url	string	reference page URL
title	string	reference page title
text	string	reference text text snippet from the page that was used to generate the ai_overview_element
references	array	additional references relevant to the item includes references to webpages that may have been used to generate the ai_overview
type	string	type of element = ‘ai_overview_reference‘
source	string	reference source name or title
domain	string	domain name of the reference
url	string	reference page URL
title	string	reference page title
text	string	reference text text snippet from the page that was used to generate the ai_overview_element
position	string	the alignment of the element in SERP can take the following values: left, right
traffic_cost	float	estimated cost of converting organic search traffic into paid represents the estimated monthly cost of running ads for the keyword that a given URL ranks for the metric is calculated as the product of organic etv and paid cpc values and indicates the cost of driving the estimated volume of monthly organic traffic through PPC advertising in Google Search
rank_group	integer	group rank in SERP position within a group of elements with identical type values positions of elements with different type values are omitted from rank_group
rank_absolute	integer	absolute rank in SERP absolute position among all the elements in SERP
etv	float	estimated traffic volume estimated organic monthly traffic to the domain calculated as the product of CTR (click-through-rate) and search volume values of the keyword a given URL ranks for
extra	array	additional information about the keyword
core_keyword	string	main keyword in a group contains the main keyword in a group of keywords that share similarities across the keyword_info parameters if the value is null, our database does not contain any keywords that match these criteria
synonym_clustering_algorithm	string	the algorithm used to identify synonyms possible values: keyword_metrics – indicates the algorithm based on keyword_info parameters text_processing – indicates the text-based algorithm if the value is null, our database does not contain any keywords the corresponding algorithm could identify as synonymous with keyword
detected_language	string	detected language of the keyword indicates the language of the keyword as identified by our system
keyword_difficulty	integer	difficulty of ranking in the first top-10 organic results for a keyword indicates the chance of getting in top-10 organic results for a keyword on a logarithmic scale from 0 to 100; calculated by analysing, among other parameters, link profiles of the first 10 pages in SERP; learn more about the metric in this help center guide
search_intent_info	object	search intent info for the returned keyword learn about search intent in this help center article
main_intent	string	main search intent possible values: informational, navigational, commercial, transactional
foreign_intent	array	supplementary search intents possible values: informational, navigational, commercial, transactional
last_updated_time	string	date and time when search intent data was last updated in the ISO 8601 format: “YYYY-MM-DDThh:mm:ss.sssssssZ” example: 2022-09-12T00:07:43.0733218Z