The cost depends on the size and location parameters of the specific database.
The cost can be found on the Bing Databases page.
Unified Search Bing Database
Full Bing Database is a combination of the Advanced Bing SERP Database and Bing Keyword Database.
The Advanced Bing SERP Database encompasses millions of Bing search result pages with extra SERP features, such as featured snippets, knowledge graphs, etc.
Bing Keyword Database encompasses millions of search terms enriched with related data from Bing: search volume history, current search volume, CPC, and competition.
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 | search query 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 tohttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languagesexample: 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 tohttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languagesexample: 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 specify 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 |
object | keyword data for the returned keyword |
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 |
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) note: competition will have values for the United States location only |
cpc |
float | cost-per-click represents the average cost per click (USD) historically paid for the keyword note: cpc will have values for the United States location only |
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 |
history |
object | monthly searches represents the (approximate) number of monthly searches on the returned keyword in the given location for the past 4 years |
serp_info |
object | SERP data available for the returned keyword |
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, events, featured_snippet, hotels_pack, images, jobs, local_pack, map, organic, paid, people_also_ask, people_also_search, questions_and_answers, recipes, related_searches, shopping, top_stories, video
|
serp |
array | contains data on the SERP elements found for the returned keyword |
| ‘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 rankpage_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 rankmain_domain_rank is calculated based on the method for node ranking in a linked database – a principle used in the original Google PageRank algorithmlearn 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 valuespositions 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 rankpage_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 rankmain_domain_rank is calculated based on the method for node ranking in a linked database – a principle used in the original Google PageRank algorithmlearn 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 valuespositions 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 valuespositions 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 valuespositions 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 valuespositions 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 valuespositions 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 rankpage_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 rankmain_domain_rank is calculated based on the method for node ranking in a linked database – a principle used in the original Google PageRank algorithmlearn 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 valuespositions 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 rankpage_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 rankmain_domain_rank is calculated based on the method for node ranking in a linked database – a principle used in the original Google PageRank algorithmlearn 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 valuespositions 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 |
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 |
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 valuespositions 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 |
| ‘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 |
xpath |
string | the XPath of the element |
expanded_element |
array | expanded element |
featured_title |
string | title |
url |
string | relevant URL |
domain |
string | domain in SERP |
title |
string | title of the result in SERP |
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 = ‘people_also_ask_expanded_element‘ |
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 = ‘people_also_ask’ |
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 |
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 valuespositions 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 |
| ‘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 |
| ‘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 valuespositions 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 valuespositions 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 in this case, will equal null |