Your account will be charged only for posting a task. You can get the results of the task within the next 30 days for free.
The cost can be calculated on the Pricing page.
Description of the fields for sending a request:
| Field name | Type | Description |
|---|---|---|
id |
string | task identifier unique task identifier in our system in the UUID format you will be able to use it within 30 days to request the results of the task at any time |
As a response of the API server, you will receive JSON-encoded data containing a tasks array with the information specific to the set tasks.
You can also get all available SERP features and possible extra elements by making a request to the following Sandbox URL:
https://sandbox.dataforseo.com/v3/serp/google/organic/task_get/advanced/00000000-0000-0000-0000-000000000000
The response will include all available items in the Google Organic SERP Advanced endpoint with the fields containing dummy data.
You won’t be charged for using Sandbox endpoints.
Description of the fields in the results array:
| Field name | Type | Description |
|---|---|---|
version |
string | the current version of the API |
status_code |
integer | general status code you can find the full list of the response codes here Note: we strongly recommend designing a necessary system for handling related exceptional or error conditions |
status_message |
string | general informational message you can find the full list of general informational messages here |
time |
string | execution time, seconds |
cost |
float | total tasks cost, USD |
tasks_count |
integer | the number of tasks in the tasks array |
tasks_error |
integer | the number of tasks in the tasks array returned with an error |
tasks |
array | array of tasks |
id |
string | task identifier unique task identifier in our system in the UUID format |
status_code |
integer | status code of the task generated by DataForSEO; can be within the following range: 10000-60000 you can find the full list of the response codes here |
status_message |
string | informational message of the task you can find the full list of general informational messages here |
time |
string | execution time, seconds |
cost |
float | cost of the task, USD |
result_count |
integer | number of elements in the result array |
path |
array | URL path |
data |
object | contains the same parameters that you specified in the POST request |
result |
array | array of results |
keyword |
string | keyword received in a POST array the keyword is returned with decoded %## (plus symbol ‘+’ will be decoded to a space character) |
type |
string | search engine type in a POST array |
se_domain |
string | search engine domain in a POST array |
location_code |
integer | location code in a POST array |
language_code |
string | language code in a POST array |
check_url |
string | direct URL to search engine results you can use it to make sure that we provided accurate results |
datetime |
string | date and time when the result was received in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00” example: 2019-11-15 12:57:46 +00:00 |
spell |
object | 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 |
keyword |
string | keyword obtained as a result of search engine autocorrection the results will be provided for the corrected keyword |
type |
string | type of autocorrection possible values: did_you_mean, showing_results_for, no_results_found_for, including_results_for |
refinement_chips |
object | search refinement chips |
type |
string | type of element = ‘refinement_chips’ |
xpath |
string | the XPath of the element |
items |
array | items of the element |
type |
string | type of element = ‘refinement_chips_element’ |
title |
string | title of the element |
url |
string | search URL with refinement parameters |
domain |
string | domain in SERP |
options |
array | further search refinement options |
type |
string | type of element = ‘refinement_chips_option’ |
title |
string | title of the element |
url |
string | search URL with refinement parameters |
domain |
string | domain in SERP |
item_types |
array | types of search results in SERP contains types of search results ( items) found in SERP.possible item types: answer_box, app, carousel, multi_carousel, featured_snippet, google_flights, google_reviews, third_party_reviews, google_posts, 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, google_hotels, math_solver, currency_box,product_considerations, found_on_web, short_videos, refine_products, explore_brands, perspectives, discussions_and_forums, compare_sites, courses, ai_overview |
se_results_count |
integer | total number of results in SERP |
pages_count |
integer | total search results pages retrieved total number of retrieved SERPs in the result |
items_count |
integer | the number of results returned in the items array |
items |
array | elements of search results found in SERP |
‘organic’ element in SERP![]() |
||
type |
string | type of element = ‘organic’ |
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 |
page |
integer | search results page number indicates the number of the SERP page on which the element is located |
position |
string | the alignment of the element in SERP can take the following values: left, right |
xpath |
string | the XPath of the element |
domain |
string | domain in SERP |
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 |
website_name |
string | name of the website in SERP |
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 |
is_malicious |
boolean | indicates whether the element is marked as malicious |
is_web_story |
boolean | indicates whether the element is marked as Google web story |
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 |
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) |
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 |
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 | 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 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 |
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 |
url |
string | link URL |
domain |
string | domain in SERP |
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 |
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 |
related_result |
array | related result from the same domain related result from the same domain appears as a part of the main result snippet; you can derive the related_result snippets as "type": "organic" results by setting the group_organic_results parameter to false in the POST request |
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 |
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) |
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 |
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 | 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 results 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 |
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 |
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 |
rectangle |
object | rectangle parameters contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP equals null if calculate_rectangles in the POST request is not set to true |
x |
float | x-axis coordinate x-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
y |
float | y-axis coordinate y-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
width |
float | width of the element in pixels |
height |
float | height of the element in pixels |
‘paid’ element in SERP![]() |
||
type |
string | type of element = ‘paid’ |
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 |
page |
integer | search results page number indicates the number of the SERP page on which the element is located |
position |
string | the alignment of the element in SERP can take the following values: left, right |
xpath |
string | the XPath of the element |
title |
string | title of the result in SERP |
domain |
string | domain in SERP of the ad element |
website_name |
string | name of the website in the ad element |
description |
string | description of the results element in SERP |
url |
string | relevant URL of the Ad element in SERP |
breadcrumb |
string | breadcrumb of the Ad element in SERP |
is_image |
boolean | indicates whether the element contains an image |
is_video |
boolean | indicates whether the element contains a video |
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) |
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 |
string | description of the results element in SERP |
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 = ‘link_element‘ |
title |
string | title of the link element |
description |
string | description of the results element in SERP |
url |
string | URL link |
domain |
string | domain in SERP |
ad_aclk |
string | the identifier of the ad |
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 |
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 |
rectangle |
object | rectangle parameters contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP equals null if calculate_rectangles in the POST request is not set to true |
x |
float | x-axis coordinate x-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
y |
float | y-axis coordinate y-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
width |
float | width of the element in pixels |
height |
float | height of the element in pixels |
‘carousel’ element in SERP![]() |
||
type |
string | type of element = ‘carousel’ |
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 |
page |
integer | search results page number indicates the number of the SERP page on which the element is located |
position |
string | the alignment of the element in SERP can take the following values: left, right |
xpath |
string | the XPath of the element |
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 |
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) |
rectangle |
object | rectangle parameters contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP equals null if calculate_rectangles in the POST request is not set to true |
x |
float | x-axis coordinate x-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
y |
float | y-axis coordinate y-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
width |
float | width of the element in pixels |
height |
float | height of the element in pixels |
‘multi_carousel’ element in SERP![]() |
||
type |
string | type of element = ‘multi_carousel’ |
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 |
page |
integer | search results page number indicates the number of the SERP page on which the element is located |
position |
string | the alignment of the element in SERP can take the following values: left, right |
xpath |
string | the XPath of the element |
items |
array | additional items present in the element if there are none, equals null |
type |
string | type of element = ‘multi_carousel_element‘ |
title |
string | title of the item |
multi_carousel_snippets |
array | multi_carousel_snippet results |
type |
string | type of element = ‘multi_carousel_snippet‘ |
title |
string | title of a particular item |
subtitle |
string | subtitle of the item |
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) |
rectangle |
object | rectangle parameters contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP equals null if calculate_rectangles in the POST request is not set to true |
x |
float | x-axis coordinate x-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
y |
float | y-axis coordinate y-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
width |
float | width of the element in pixels |
height |
float | height of the element in pixels |
‘answer_box’ element in SERP![]() |
||
type |
string | type of element = ‘answer_box’ |
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 |
page |
integer | search results page number indicates the number of the SERP page on which the element is located |
position |
string | the alignment of the element in SERP can take the following values: left, right |
xpath |
string | the XPath of the element |
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 |
domain |
string | domain in SERP |
rectangle |
object | rectangle parameters contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP equals null if calculate_rectangles in the POST request is not set to true |
x |
float | x-axis coordinate x-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
y |
float | y-axis coordinate y-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
width |
float | width of the element in pixels |
height |
float | height of the element in pixels |
‘related_searches’ element in SERP![]() |
||
type |
string | type of element = ‘related_searches’ |
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 |
page |
integer | search results page number indicates the number of the SERP page on which the element is located |
position |
string | the alignment of the element in SERP can take the following values: left, right |
xpath |
string | the XPath of the element |
items |
array | additional items present in the element if there are none, equals null |
rectangle |
object | rectangle parameters contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP equals null if calculate_rectangles in the POST request is not set to true |
x |
float | x-axis coordinate x-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
y |
float | y-axis coordinate y-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
width |
float | width of the element in pixels |
height |
float | height of the element in pixels |
‘people_also_search’ element in SERP![]() |
||
type |
string | type of element = ‘people_also_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 |
page |
integer | search results page number indicates the number of the SERP page on which the element is located |
position |
string | the alignment of the element in SERP can take the following values: left, right |
xpath |
string | the XPath of the element |
title |
string | title of the result in SERP |
items |
array | additional items present in the element if there are none, equals null |
rectangle |
object | rectangle parameters contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP equals null if calculate_rectangles in the POST request is not set to true |
x |
float | x-axis coordinate x-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
y |
float | y-axis coordinate y-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
width |
float | width of the element in pixels |
height |
float | height of the element in pixels |
‘local_pack’ element in SERP![]() |
||
type |
string | type of element = ‘local_pack’ |
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 |
page |
integer | search results page number indicates the number of the SERP page on which the element is located |
position |
string | the alignment of the element in SERP can take the following values: left, right |
xpath |
string | the XPath of the element |
title |
string | title of the result in SERP |
description |
string | description of the results element in SERP |
domain |
string | domain in SERP |
phone |
string | phone number |
url |
string | relevant URL |
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 |
float | the value of the rating |
votes_count |
integer | the amount of feedback |
rating_max |
integer | the maximum value for a rating_type |
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 |
rectangle |
object | rectangle parameters contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP equals null if calculate_rectangles in the POST request is not set to true |
x |
float | x-axis coordinate x-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
y |
float | y-axis coordinate y-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
width |
float | width of the element in pixels |
height |
float | height of the element in pixels |
‘hotels_pack’ element in SERP![]() |
||
type |
string | type of element = ‘hotels_pack’ |
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 |
page |
integer | search results page number indicates the number of the SERP page on which the element is located |
position |
string | the alignment of the element in SERP can take the following values: left, right |
xpath |
string | the XPath of the element |
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’ |
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 |
title |
string | title of the place |
desription |
string | description of the place in SERP |
hotel_identifier |
string | unique hotel identifier unique hotel identifier assigned by Google; example: "CgoIjaeSlI6CnNpVEAE" |
domain |
string | domain in SERP |
url |
string | relevant URL |
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 |
float | the value of the rating |
votes_count |
integer | the amount of feedback |
rating_max |
integer | the maximum value for a rating_type |
rectangle |
object | rectangle parameters contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP equals null if calculate_rectangles in the POST request is not set to true |
x |
float | x-axis coordinate x-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
y |
float | y-axis coordinate y-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
width |
float | width of the element in pixels |
height |
float | height of the element in pixels |
‘knowledge_graph’ element in SERP![]() |
note that knowledge_graph items in mobile results may be separated by other elements;in such cases, the API response returns several knowledge_graph elements, each containing distinct items, and each placed according to the items’ placement in SERP |
|
type |
string | type of element = ‘knowledge_graph’ |
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 |
page |
integer | search results page number indicates the number of the SERP page on which the element is located |
position |
string | the alignment of the element in SERP can take the following values: left, right |
xpath |
string | the XPath of the element |
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 |
image_url |
string | URL of the image from knowledge graph |
logo_url |
string | URL of the logo from knowledge graph |
cid |
string | google-defined client id |
items |
array | additional items present in the element if there are none, equals null |
|
string | type of element = ‘knowledge_graph_images_item‘ |
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;always equals 0 for desktop |
rank_absolute |
integer | absolute rank in SERP absolute position among all the elements in SERP always equals 0 for desktop |
page |
integer | search results page number indicates the number of the SERP page on which the element is located |
position |
string | the alignment of the element in SERP can take the following values: left, right |
xpath |
string | the XPath of the element |
link |
object | link of the element |
type |
string | type of element = ‘link_element‘ |
title |
string | title of a given link element |
url |
string | URL |
domain |
string | domain where a link points |
snippet |
string | text alongside the link title |
xpath |
string | the XPath of the element |
items |
array | contains arrays of specific images |
type |
string | type of element = ‘knowledge_graph_images_element‘ |
url |
string | image source URL |
domain |
string | website domain |
alt |
string | alt attribute |
image_url |
string | URL of a specific image |
xpath |
string | the XPath of the element |
rectangle |
object | rectangle parameters contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP equals null if calculate_rectangles in the POST request is not set to true |
x |
float | x-axis coordinate x-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
y |
float | y-axis coordinate y-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
width |
float | width of the element in pixels |
height |
float | height of the element in pixels |
type |
string | type of element = ‘knowledge_graph_list_item‘ |
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;always equals 0 for desktop |
rank_absolute |
integer | absolute rank in SERP absolute position among all the elements in SERP always equals 0 for desktop |
page |
integer | search results page number indicates the number of the SERP page on which the element is located |
position |
string | the alignment of the element in SERP can take the following values: left, right |
xpath |
string | the XPath of the element |
title |
string | title of the element |
data_attrid |
string | google defined data attribute ID example: action:listen_artist |
link |
object | link of the element |
type |
string | type of element = ‘link_element‘ |
title |
string | title of a given link element |
url |
string | URL |
domain |
string | domain where a link points |
snippet |
string | text alongside the link title |
xpath |
string | the XPath of the element |
items |
array | contains arrays of elements available in the list |
type |
string | type of element = ‘knowledge_graph_list_element‘ |
title |
string | title of the element |
subtitle |
string | subtitle of the element |
url |
string | URL of element |
domain |
string | website domain |
image_url |
string | URL of the image |
xpath |
string | the XPath of the element |
rectangle |
object | rectangle parameters contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP equals null if calculate_rectangles in the POST request is not set to true |
x |
float | x-axis coordinate x-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
y |
float | y-axis coordinate y-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
width |
float | width of the element in pixels |
height |
float | height of the element in pixels |
type |
string | type of element = ‘knowledge_graph_ai_overview_item‘‘ |
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;always equals 0 for desktop |
rank_absolute |
integer | absolute rank in SERP absolute position among all the elements in SERP always equals 0 for desktop |
page |
integer | search results page number indicates the number of the SERP page on which the element is located |
position |
string | the alignment of the element in SERP can take the following values: left, right |
xpath |
string | the XPath of the element |
asynchronous_ai_overview |
boolean | indicates whether the element is loaded asynchronously if true, the ai_overview element is loaded asynchronously;if false, the ai_overview element is loaded from cache;
|
items |
array | items present in the element |
type |
string | type of element = ‘ai_overview_element‘ |
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 |
page |
integer | search results page number indicates the number of the SERP page on which the element is located |
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 |
string | 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 |
rectangle |
object | rectangle parameters contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP equals null if calculate_rectangles in the POST request is not set to true |
x |
float | x-axis coordinate x-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
y |
float | y-axis coordinate y-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
width |
float | width of the element in pixels |
height |
float | height of the element in pixels |
type |
string | type of element = ‘knowledge_graph_description_item‘ |
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;always equals 0 for desktop |
rank_absolute |
integer | absolute rank in SERP absolute position among all the elements in SERP always equals 0 for desktop |
page |
integer | search results page number indicates the number of the SERP page on which the element is located |
position |
string | the alignment of the element in SERP can take the following values: left, right |
xpath |
string | the XPath of the element |
text |
string | description content |
links |
array | link of the element |
type |
string | type of element = ‘link_element‘ |
title |
string | title of a given link element |
url |
string | URL |
domain |
string | domain where a link points |
snippet |
string | text alongside the link title |
xpath |
string | the XPath of the element |
rectangle |
object | rectangle parameters contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP equals null if calculate_rectangles in the POST request is not set to true |
x |
float | x-axis coordinate x-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
y |
float | y-axis coordinate y-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
width |
float | width of the element in pixels |
height |
float | height of the element in pixels |
type |
string | type of element = ‘knowledge_graph_row_item‘ |
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;always equals 0 for desktop |
rank_absolute |
integer | absolute rank in SERP absolute position among all the elements in SERP always equals 0 for desktop |
page |
integer | search results page number indicates the number of the SERP page on which the element is located |
position |
string | the alignment of the element in SERP can take the following values: left, right |
xpath |
string | the XPath of the element |
title |
string | title of the row |
data_attrid |
string | google defined data attribute ID example: ss:/webfacts:net_worth |
text |
string | row content |
links |
array | link of the element |
type |
string | type of element = ‘link_element‘ |
title |
string | title of a given link element |
url |
string | URL |
domain |
string | domain where a link points |
snippet |
string | text alongside the link title |
xpath |
string | the XPath of the element |
rectangle |
object | rectangle parameters contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP equals null if calculate_rectangles in the POST request is not set to true |
x |
float | x-axis coordinate x-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
y |
float | y-axis coordinate y-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
width |
float | width of the element in pixels |
height |
float | height of the element in pixels |
type |
string | type of element = ‘knowledge_graph_carousel_item‘ |
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;always equals 0 for desktop |
rank_absolute |
integer | absolute rank in SERP absolute position among all the elements in SERP always equals 0 for desktop |
page |
integer | search results page number indicates the number of the SERP page on which the element is located |
position |
string | the alignment of the element in SERP can take the following values: left, right |
xpath |
string | the XPath of the element |
title |
string | title of the carousel item |
data_attrid |
string | google defined data attribute ID example: kc:/common/topic:social media presence |
link |
object | link of the element |
type |
string | type of element = ‘link_element‘ |
title |
string | title of a given link element |
url |
string | URL |
domain |
string | domain where a link points |
snippet |
string | text alongside the link title |
xpath |
string | the XPath of the element |
items |
array | contains arrays of elements available in the list |
type |
string | type of element = ‘knowledge_graph_carousel_element‘ |
title |
string | title of the element |
subtitle |
string | subtitle of the element |
url |
string | URL of element |
domain |
string | website domain |
image_url |
string | URL of the image |
xpath |
string | the XPath of the element |
rectangle |
object | rectangle parameters contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP equals null if calculate_rectangles in the POST request is not set to true |
x |
float | x-axis coordinate x-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
y |
float | y-axis coordinate y-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
width |
float | width of the element in pixels |
height |
float | height of the element in pixels |
type |
string | type of element = ‘knowledge_graph_part_item‘ |
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;always equals 0 for desktop |
rank_absolute |
integer | absolute rank in SERP absolute position among all the elements in SERP always equals 0 for desktop |
page |
integer | search results page number indicates the number of the SERP page on which the element is located |
position |
string | the alignment of the element in SERP can take the following values: left, right |
xpath |
string | the XPath of the element |
title |
string | title of the item |
data_attrid |
string | google defined data attribute ID example: kc:/local:place qa |
text |
string | content within the item |
links |
array | link of the element |
type |
string | type of element = ‘link_element‘ |
title |
string | title of a given link element |
url |
string | URL |
domain |
string | domain where a link points |
snippet |
string | text alongside the link title |
xpath |
string | the XPath of the element |
rectangle |
object | rectangle parameters contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP equals null if calculate_rectangles in the POST request is not set to true |
x |
float | x-axis coordinate x-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
y |
float | y-axis coordinate y-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
width |
float | width of the element in pixels |
height |
float | height of the element in pixels |
type |
string | type of element = ‘knowledge_graph_expanded_item‘ |
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;always equals 0 for desktop |
rank_absolute |
integer | absolute rank in SERP absolute position among all the elements in SERP always equals 0 for desktop |
page |
integer | search results page number indicates the number of the SERP page on which the element is located |
position |
string | the alignment of the element in SERP can take the following values: left, right |
xpath |
string | the XPath of the element |
title |
string | title of the item |
data_attrid |
string | google defined data attribute ID example: kc:/local:place qa |
expanded_element |
array | link of the element |
type |
string | type of element = ‘knowledge_graph_expanded_element‘ |
featured_title |
string | title of a given element |
url |
string | source URL |
domain |
string | source domain |
title |
string | source title |
snippet |
string | text alongside the title |
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 |
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) |
table |
object | table element |
table_element |
string | name assigned to the table element possible values: table_element |
table_header |
array | column names |
table_content |
array | the content of the table one line of the table in this element of the array |
rectangle |
object | rectangle parameters contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP equals null if calculate_rectangles in the POST request is not set to true |
x |
float | x-axis coordinate x-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
y |
float | y-axis coordinate y-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
width |
float | width of the element in pixels |
height |
float | height of the element in pixels |
type |
string | type of element = ‘knowledge_graph_shopping_item‘ |
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;always equals 0 for desktop |
rank_absolute |
integer | absolute rank in SERP absolute position among all the elements in SERP always equals 0 for desktop |
page |
integer | search results page number indicates the number of the SERP page on which the element is located |
position |
string | the alignment of the element in SERP can take the following values: left, right |
xpath |
string | the XPath of the element |
title |
string | title of the item |
data_attrid |
string | google defined data attribute ID example: kc:/shopping/gpc:organic-offers |
items |
array | link of the element |
type |
string | type of element = ‘knowledge_graph_shopping_element‘ |
title |
string | title of a given shopping element |
url |
string | URL |
domain |
string | domain in url |
price |
object | price indicated in the element |
current |
float | current price refers to the current price indicated in the element |
regular |
float | regular price refers to the regular price indicated in the element |
max_value |
float | the maximum price refers to the maximum price indicated in the element |
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 |
rectangle |
object | rectangle parameters contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP equals null if calculate_rectangles in the POST request is not set to true |
x |
float | x-axis coordinate x-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
y |
float | y-axis coordinate y-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
width |
float | width of the element in pixels |
height |
float | height of the element in pixels |
type |
string | type of element = ‘knowledge_graph_hotels_booking_item‘ |
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;always equals 0 for desktop |
rank_absolute |
integer | absolute rank in SERP absolute position among all the elements in SERP always equals 0 for desktop |
page |
integer | search results page number indicates the number of the SERP page on which the element is located |
position |
string | the alignment of the element in SERP can take the following values: left, right |
xpath |
string | the XPath of the element |
title |
string | title of the element |
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 |
data_attrid |
string | google defined data attribute ID example: kc:/local:hotel booking |
items |
array | contains arrays of elements available in the list |
type |
string | type of element = ‘knowledge_graph_hotels_booking_element‘ |
source |
string | web source of the hotel booking element indicates the source of information included in the element |
description |
string | description of the hotel booking element |
url |
string | URL |
domain |
string | domain in the URL |
price |
object | price indicated in the element |
current |
float | current price refers to the current price indicated in the element |
regular |
float | regular price refers to the regular price indicated in the element |
max_value |
float | the maximum price refers to the maximum price indicated in the element |
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 |
rectangle |
object | rectangle parameters contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP equals null if calculate_rectangles in the POST request is not set to true |
x |
float | x-axis coordinate x-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
y |
float | y-axis coordinate y-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
width |
float | width of the element in pixels |
height |
float | height of the element in pixels |
rectangle |
object | rectangle parameters contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP equals null if calculate_rectangles in the POST request is not set to true |
x |
float | x-axis coordinate x-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
y |
float | y-axis coordinate y-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
width |
float | width of the element in pixels |
height |
float | height of the element in pixels |
‘featured_snippet’ element in SERP![]() |
||
type |
string | type of element = ‘featured_snippet’ |
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 |
page |
integer | search results page number indicates the number of the SERP page on which the element is located |
position |
string | the alignment of the element in SERP can take the following values: left, right |
xpath |
string | the XPath of the element |
domain |
string | domain 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 |
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 |
url |
string | relevant URL |
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) |
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 |
rectangle |
object | rectangle parameters contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP equals null if calculate_rectangles in the POST request is not set to true |
x |
float | x-axis coordinate x-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
y |
float | y-axis coordinate y-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
width |
float | width of the element in pixels |
height |
float | height of the element in pixels |
‘top_stories’ element in SERP![]() |
||
type |
string | type of element = ‘top_stories’ |
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 |
page |
integer | search results page number indicates the number of the SERP page on which the element is located |
position |
string | the alignment of the element in SERP can take the following values: left, right |
xpath |
string | the XPath of the element |
title |
string | title of the 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 |
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 |
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) |
badges |
array | badges relevant to the element |
rectangle |
object | rectangle parameters contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP equals null if calculate_rectangles in the POST request is not set to true |
x |
float | x-axis coordinate x-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
y |
float | y-axis coordinate y-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
width |
float | width of the element in pixels |
height |
float | height of the element in pixels |
‘twitter’ element in SERP![]() |
||
type |
string | type of element = ‘twitter’ |
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 |
page |
integer | search results page number indicates the number of the SERP page on which the element is located |
position |
string | the alignment of the element in SERP can take the following values: left, right |
xpath |
string | the XPath of the element |
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 |
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 |
url |
string | URL |
rectangle |
object | rectangle parameters contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP equals null if calculate_rectangles in the POST request is not set to true |
x |
float | x-axis coordinate x-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
y |
float | y-axis coordinate y-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
width |
float | width of the element in pixels |
height |
float | height of the element in pixels |
‘map’ element in SERP![]() |
||
type |
string | type of element = ‘map’ |
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 |
page |
integer | search results page number indicates the number of the SERP page on which the element is located |
position |
string | the alignment of the element in SERP can take the following values: left, right |
xpath |
string | the XPath of the element |
title |
string | title of the result in SERP |
url |
string | URL |
rectangle |
object | rectangle parameters contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP equals null if calculate_rectangles in the POST request is not set to true |
x |
float | x-axis coordinate x-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
y |
float | y-axis coordinate y-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
width |
float | width of the element in pixels |
height |
float | height of the element in pixels |
‘google_flights’ element in SERP![]() |
||
type |
string | type of element = ‘google_flights’ |
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 |
page |
integer | search results page number indicates the number of the SERP page on which the element is located |
position |
string | the alignment of the element in SERP can take the following values: left, right |
xpath |
string | the XPath of the element |
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 = ‘google_flights_element‘ |
description |
string | description |
url |
string | URL |
rectangle |
object | rectangle parameters contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP equals null if calculate_rectangles in the POST request is not set to true |
x |
float | x-axis coordinate x-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
y |
float | y-axis coordinate y-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
width |
float | width of the element in pixels |
height |
float | height of the element in pixels |
‘google_reviews’ element in SERP![]() |
||
type |
string | type of element = ‘google_reviews’ |
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 |
page |
integer | search results page number indicates the number of the SERP page on which the element is located |
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 |
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 |
place_id |
string | the identifier of a place |
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 |
rectangle |
object | rectangle parameters contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP equals null if calculate_rectangles in the POST request is not set to true |
x |
float | x-axis coordinate x-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
y |
float | y-axis coordinate y-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
width |
float | width of the element in pixels |
height |
float | height of the element in pixels |
‘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 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 |
page |
integer | search results page number indicates the number of the SERP page on which the element is located |
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 |
rectangle |
object | rectangle parameters contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP equals null if calculate_rectangles in the POST request is not set to true |
x |
float | x-axis coordinate x-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
y |
float | y-axis coordinate y-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
width |
float | width of the element in pixels |
height |
float | height of the element in pixels |
‘google_posts’ element in SERP![]() |
||
type |
string | type of element = ‘google_posts’ |
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 |
page |
integer | search results page number indicates the number of the SERP page on which the element is located |
position |
string | the alignment of the element in SERP can take the following values: left, right |
xpath |
string | the XPath of the element |
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 |
rectangle |
object | rectangle parameters contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP equals null if calculate_rectangles in the POST request is not set to true |
x |
float | x-axis coordinate x-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
y |
float | y-axis coordinate y-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
width |
float | width of the element in pixels |
height |
float | height of the element in pixels |
‘video’ element in SERP![]() |
||
type |
string | type of element = ‘video’ |
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 |
page |
integer | search results page number indicates the number of the SERP page on which the element is located |
position |
string | the alignment of the element in SERP can take the following values: left, right |
xpath |
string | the XPath of the element |
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 |
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 |
url |
string | URL |
rectangle |
object | rectangle parameters contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP equals null if calculate_rectangles in the POST request is not set to true |
x |
float | x-axis coordinate x-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
y |
float | y-axis coordinate y-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
width |
float | width of the element in pixels |
height |
float | height of the element in pixels |
‘app’ element in SERP![]() |
||
type |
string | type of element = ‘app’ |
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 |
page |
integer | search results page number indicates the number of the SERP page on which the element is located |
position |
string | the alignment of the element in SERP can take the following values: left, right |
xpath |
string | the XPath of the element |
items |
array | additional items present in the element if there are none, equals null |
type |
string | type of element = ‘app_element‘ |
description |
string | description of the results element in SERP |
title |
string | title of the result in SERP |
url |
string | URL |
price |
object | price of the app element |
current |
float | current price refers to the current price indicated in the app element |
regular |
float | regular price refers to the regular price indicated in the app element |
max_value |
float | the maximum price refers to the maximum price indicated in the app element |
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 |
rectangle |
object | rectangle parameters contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP equals null if calculate_rectangles in the POST request is not set to true |
x |
float | x-axis coordinate x-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
y |
float | y-axis coordinate y-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
width |
float | width of the element in pixels |
height |
float | height of the element in pixels |
‘people_also_ask’ element in SERP![]() |
||
type |
string | type of element = ‘people_also_ask’ |
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 |
page |
integer | search results page number indicates the number of the SERP page on which the element is located |
position |
string | the alignment of the element in SERP can take the following values: left, right |
xpath |
string | the XPath of the element |
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 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 |
page |
integer | search results page number indicates the number of the SERP page on which the element is located |
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 |
string | 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 |
rectangle |
object | rectangle parameters contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP equals null if calculate_rectangles in the POST request is not set to true |
x |
float | x-axis coordinate x-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
y |
float | y-axis coordinate y-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
width |
float | width of the element in pixels |
height |
float | height of the element in pixels |
‘images’ element in SERP![]() |
||
type |
string | type of element = ‘images’ |
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 |
page |
integer | search results page number indicates the number of the SERP page on which the element is located |
position |
string | the alignment of the element in SERP can take the following values: left, right |
xpath |
string | the XPath of the element |
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 | alt tag of the image |
url |
string | original URL of the image the URL leading to the image on the original resource |
image_url |
string | URL to the compressed image the URL leading to the image on DataForSEO storage |
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 |
rectangle |
object | rectangle parameters contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP equals null if calculate_rectangles in the POST request is not set to true |
x |
float | x-axis coordinate x-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
y |
float | y-axis coordinate y-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
width |
float | width of the element in pixels |
height |
float | height of the element in pixels |
‘shopping’ element in SERP![]() |
||
type |
string | type of element = ‘shopping’ |
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 |
page |
integer | search results page number indicates the number of the SERP page on which the element is located |
position |
string | the alignment of the element in SERP can take the following values: left, right |
xpath |
string | the XPath of the element |
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 of the shopping element |
current |
float | current price indicates the current price of the shopping element |
regular |
float | regular price indicates the regular price of the shopping element |
max_value |
float | the maximum price indicates the maximum price of the shopping element |
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 |
url |
string | URL |
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 |
rectangle |
object | rectangle parameters contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP equals null if calculate_rectangles in the POST request is not set to true |
x |
float | x-axis coordinate x-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
y |
float | y-axis coordinate y-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
width |
float | width of the element in pixels |
height |
float | height of the element in pixels |
‘jobs’ element in SERP![]() |
||
type |
string | type of element = ‘jobs’ |
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 |
page |
integer | search results page number indicates the number of the SERP page on which the element is located |
position |
string | the alignment of the element in SERP can take the following values: left, right |
xpath |
string | the XPath of the element |
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 = ‘jobs_element‘ |
title |
string | title of the result in SERP |
description |
string | description |
location |
string | location for which the job vacancy is posted |
author |
string | author |
job_posted_time |
string | the time when the job was posted |
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 |
contract_type |
string | contract type |
salary |
string | salary |
url |
string | URL |
rectangle |
object | rectangle parameters contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP equals null if calculate_rectangles in the POST request is not set to true |
x |
float | x-axis coordinate x-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
y |
float | y-axis coordinate y-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
width |
float | width of the element in pixels |
height |
float | height of the element in pixels |
‘events’ element in SERP![]() |
||
type |
string | type of element = ‘events’ |
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 |
page |
integer | search results page number indicates the number of the SERP page on which the element is located |
position |
string | the alignment of the element in SERP can take the following values: left, right |
xpath |
string | the XPath of the element |
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 = ‘events_element‘ |
title |
string | title of the item |
description |
string | snippet of the element |
url |
string | events_element URL |
rectangle |
object | rectangle parameters contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP equals null if calculate_rectangles in the POST request is not set to true |
x |
float | x-axis coordinate x-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
y |
float | y-axis coordinate y-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
width |
float | width of the element in pixels |
height |
float | height of the element in pixels |
‘mention_carousel’ element in SERP![]() |
||
type |
string | type of element = ‘mention_carousel’ |
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 |
page |
integer | search results page number indicates the number of the SERP page on which the element is located |
position |
string | the alignment of the element in SERP can take the following values: left, right |
xpath |
string | the XPath of the element |
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 of the mention carousel element |
current |
float | current price indicates the current price of the mention carousel element |
regular |
float | regular price indicates the regular price of the mention carousel element |
max_value |
float | the maximum price indicates the maximum price of the mention carousel element |
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 |
float | 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 |
rectangle |
object | rectangle parameters contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP equals null if calculate_rectangles in the POST request is not set to true |
x |
float | x-axis coordinate x-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
y |
float | y-axis coordinate y-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
width |
float | width of the element in pixels |
height |
float | height of the element in pixels |
‘recipes’ element in SERP![]() |
||
type |
string | type of element = ‘recipes’ |
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 |
page |
integer | search results page number indicates the number of the SERP page on which the element is located |
position |
string | the alignment of the element in SERP can take the following values: left, right |
xpath |
string | the XPath of the element |
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 recipes_element |
description |
string | snippet of the element |
time |
string | the total time it takes to prepare the cook 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 |
float | the value of the rating |
votes_count |
integer | the amount of feedback |
rating_max |
integer | the maximum value for a rating_type |
rectangle |
object | rectangle parameters contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP equals null if calculate_rectangles in the POST request is not set to true |
x |
float | x-axis coordinate x-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
y |
float | y-axis coordinate y-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
width |
float | width of the element in pixels |
height |
float | height of the element in pixels |
‘top_sights’ element in SERP![]() |
||
type |
string | type of element = ‘top_sights’ |
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 |
page |
integer | search results page number indicates the number of the SERP page on which the element is located |
position |
string | the alignment of the element in SERP can take the following values: left, right |
xpath |
string | the XPath of the element |
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 = ‘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 |
float | the value of the rating |
votes_count |
integer | the amount of feedback |
rating_max |
integer | the maximum value for a rating_type |
rectangle |
object | rectangle parameters contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP equals null if calculate_rectangles in the POST request is not set to true |
x |
float | x-axis coordinate x-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
y |
float | y-axis coordinate y-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
width |
float | width of the element in pixels |
height |
float | height of the element in pixels |
‘scholarly_articles’ element in SERP![]() |
||
type |
string | type of element = ‘scholarly_articles’ |
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 |
page |
integer | search results page number indicates the number of the SERP page on which the element is located |
position |
string | the alignment of the element in SERP can take the following values: left, right |
xpath |
string | the XPath of the element |
title |
string | title of the item |
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 = ‘scholarly_articles_element‘ |
title |
string | title of the item |
url |
string | scholarly_articles_element URL |
author |
string | author |
description |
string | snippet of the element |
rectangle |
object | rectangle parameters contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP equals null if calculate_rectangles in the POST request is not set to true |
x |
float | x-axis coordinate x-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
y |
float | y-axis coordinate y-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
width |
float | width of the element in pixels |
height |
float | height of the element in pixels |
‘popular_products’ element in SERP![]() |
||
type |
string | type of element = ‘popular_products’ |
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 |
page |
integer | search results page number indicates the number of the SERP page on which the element is located |
position |
string | the alignment of the element in SERP can take the following values: left, right |
xpath |
string | the XPath of the element |
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 = ‘popular_products_element‘ |
title |
string | title of the item |
description |
string | snippet of the element |
seller |
string | seller of the product |
image_url |
string | URL of the product’s image |
price |
object | price of the popular products element |
current |
float | current price indicates the current price of the popular products element |
regular |
float | regular price indicates the regular price of the popular products element |
max_value |
float | the maximum price indicates the maximum price of the popular products element |
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 |
float | the value of the rating |
votes_count |
integer | the amount of feedback |
rating_max |
integer | the maximum value for a rating_type |
rectangle |
object | rectangle parameters contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP equals null if calculate_rectangles in the POST request is not set to true |
x |
float | x-axis coordinate x-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
y |
float | y-axis coordinate y-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
width |
float | width of the element in pixels |
height |
float | height of the element in pixels |
‘podcasts’ element in SERP![]() |
||
type |
string | type of element = ‘podcasts’ |
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 |
page |
integer | search results page number indicates the number of the SERP page on which the element is located |
position |
string | the alignment of the element in SERP can take the following values: left, right |
xpath |
string | the XPath of the element |
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 |
description |
string | snippet of the element |
timestamp |
string | date and time when the episode was added in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00” example: 2019-11-15 12:57:46 +00:00 |
time_to_play |
string | the total time it will take to play an episode |
rectangle |
object | rectangle parameters contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP equals null if calculate_rectangles in the POST request is not set to true |
x |
float | x-axis coordinate x-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
y |
float | y-axis coordinate y-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
width |
float | width of the element in pixels |
height |
float | height of the element in pixels |
‘questions_and_answers’ element in SERP![]() |
||
type |
string | type of element = ‘questions_and_answers’ |
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 |
page |
integer | search results page number indicates the number of the SERP page on which the element is located |
position |
string | the alignment of the element in SERP can take the following values: left, right |
xpath |
string | the XPath of the element |
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 | source of the element indicates the source of information included in the questions_and_answers_element |
domain |
string | domain name of the source |
votes |
integer | answer upvotes from the source |
rectangle |
object | rectangle parameters contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP equals null if calculate_rectangles in the POST request is not set to true |
x |
float | x-axis coordinate x-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
y |
float | y-axis coordinate y-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
width |
float | width of the element in pixels |
height |
float | height of the element in pixels |
‘find_results_on’ element in SERP![]() |
||
type |
string | type of element = ‘find_results_on’ |
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 |
page |
integer | search results page number indicates the number of the SERP page on which the element is located |
position |
string | the alignment of the element in SERP can take the following values: left, right |
xpath |
string | the XPath of the element |
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 find_results_on_element |
rectangle |
object | rectangle parameters contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP equals null if calculate_rectangles in the POST request is not set to true |
x |
float | x-axis coordinate x-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
y |
float | y-axis coordinate y-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
width |
float | width of the element in pixels |
height |
float | height of the element in pixels |
‘stocks_box’ element in SERP![]() |
||
type |
string | type of element = ‘‘stocks_box’’ |
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 |
page |
integer | search results page number indicates the number of the SERP page on which the element is located |
position |
string | the alignment of the element in SERP can take the following values: left, right |
xpath |
string | the XPath of the element |
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 quote featured on Google at the time when our API pulled the results |
regular |
float | regular price indicates the regular price quote featured on Google at the time when our API pulled the results |
max_value |
float | the maximum price indicates the maximum price quote featured on Google at the time when our API pulled the results |
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 |
rectangle |
object | rectangle parameters contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP equals null if calculate_rectangles in the POST request is not set to true |
x |
float | x-axis coordinate x-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
y |
float | y-axis coordinate y-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
width |
float | width of the element in pixels |
height |
float | height of the element in pixels |
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 formatindicates date and time for which the stock price in the value field is provided |
value |
float | 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 |
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 formatindicates the date and time for which the value field provides previous close pricefor example, "date": "2020-10-28T15:45:00" and "value": 11080.2857 mean the stock was traded at 11080.2857 on Oct. 27, 2020 at 15:45:00 |
value |
float | previous close price closing price on the preceding time period |
‘visual_stories’ element in SERP![]() |
||
type |
string | type of element = ‘visual_stories’ |
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 |
page |
integer | search results page number indicates the number of the SERP page on which the element is located |
position |
string | the alignment of the element in SERP can take the following values: left, right |
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 |
rectangle |
object | rectangle parameters contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP equals null if calculate_rectangles in the POST request is not set to true |
x |
float | x-axis coordinate x-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
y |
float | y-axis coordinate y-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
width |
float | width of the element in pixels |
height |
float | height of the element in pixels |
‘commercial units’ element in SERP![]() |
||
type |
string | type of element = ‘commercial_units’ |
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 |
page |
integer | search results page number indicates the number of the SERP page on which the element is located |
position |
string | the alignment of the element in SERP can take the following values: left, right |
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 commercial unit |
url |
string | relevant URL |
domain |
string | domain in SERP |
price |
object | price indicated in the element |
current |
float | current price indicates the current price of the commercial units element |
regular |
float | regular price indicates the regular price of the commercial units element |
max_value |
float | the maximum price indicates the maximum price of the commercial units element |
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 |
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 |
rectangle |
object | rectangle parameters contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP equals null if calculate_rectangles in the POST request is not set to true |
x |
float | x-axis coordinate x-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
y |
float | y-axis coordinate y-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
width |
float | width of the element in pixels |
height |
float | height of the element in pixels |
‘local services’ element in SERP![]() |
||
type |
string | type of element = ‘local_services’ |
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 |
page |
integer | search results page number indicates the number of the SERP page on which the element is located |
position |
string | the alignment of the element in SERP can take the following values: left, right |
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 local services element |
url |
string | relevant URL |
domain |
string | domain in SERP |
description |
string | description of the local services element |
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 |
profile_image_url |
string | URL of the image featured in the element |
rectangle |
object | rectangle parameters contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP equals null if calculate_rectangles in the POST request is not set to true |
x |
float | x-axis coordinate x-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
y |
float | y-axis coordinate y-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
width |
float | width of the element in pixels |
height |
float | height of the element in pixels |
‘google_hotels’ element in SERP![]() |
||
type |
string | type of element = ‘google_hotels’ |
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 |
page |
integer | search results page number indicates the number of the SERP page on which the element is located |
position |
string | the alignment of the element in SERP can take the following values: left, right |
xpath |
string | the XPath of the element |
hotel_identifier |
string | unique hotel identifier unique hotel identifier assigned by Google; example: "CgoIjaeSlI6CnNpVEAE" |
url |
string | URL of the element |
cid |
string | google-defined client id unique id of a local establishment; learn more about the identifier in this help center article example: "5087410620311667698" |
rectangle |
object | rectangle parameters contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP equals null if calculate_rectangles in the POST request is not set to true |
x |
float | x-axis coordinate x-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
y |
float | y-axis coordinate y-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
width |
float | width of the element in pixels |
height |
float | height of the element in pixels |
‘math_solver’ element in SERP![]() |
||
type |
string | type of element = ‘math_solver’ |
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 |
page |
integer | search results page number indicates the number of the SERP page on which the element is located |
position |
string | the alignment of the element in SERP can take the following values: left, right |
xpath |
string | the XPath of the element |
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 |
links |
array | links featured in the math_solver element if there are none, equals null |
type |
string | type of element = ‘link_element‘ |
title |
string | title of the link element |
description |
string | description of the link element |
url |
string | URL |
domain |
string | domain in SERP |
rectangle |
object | rectangle parameters contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP equals null if calculate_rectangles in the POST request is not set to true |
x |
float | x-axis coordinate x-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
y |
float | y-axis coordinate y-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
width |
float | width of the element in pixels |
height |
float | height of the element in pixels |
‘currency_box’ element in SERP![]() |
||
type |
string | type of element = ‘currency_box’ |
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 |
page |
integer | search results page number indicates the number of the SERP page on which the element is located |
position |
string | the alignment of the element in SERP can take the following values: left, right |
xpath |
string | the XPath of the element |
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 formatindicates 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 formatindicates 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 |
rectangle |
object | rectangle parameters contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP equals null if calculate_rectangles in the POST request is not set to true |
x |
float | x-axis coordinate x-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
y |
float | y-axis coordinate y-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
width |
float | width of the element in pixels |
height |
float | height of the element in pixels |
‘courses’ element in SERP![]() |
||
type |
string | type of element = ‘courses’ |
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 |
page |
integer | search results page number indicates the number of the SERP page on which the element is located |
position |
string | the alignment of the element in SERP can take the following values: left |
xpath |
string | the XPath of the element |
title |
string | title of the element in SERP |
categories |
array | array of course categories contains a list of categories relevant to courses |
items |
array | array of courses elements contains a list of courses elements |
type |
string | type of element = ‘courses_element’ |
title |
string | name of the course |
url |
string | URL of the course |
domain |
string | domain where a link points |
source |
string | web source of the courses element indicates the source of information included in the element |
description |
string | description of the element |
date |
string | date and time date and time when the result was published in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00” |
image_url |
string | URL of the image |
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
|
rectangle |
object | rectangle parameters contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP equals null if calculate_rectangles in the POST request is not set to true |
x |
float | x-axis coordinate x-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
y |
float | y-axis coordinate y-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
width |
float | width of the element in pixels |
height |
float | height of the element in pixels |
‘product_considerations’ element in SERP![]() |
||
type |
string | type of element = ‘product_considerations’ |
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 |
page |
integer | search results page number indicates the number of the SERP page on which the element is located |
position |
string | the alignment of the element in SERP can take the following values: left |
xpath |
string | the XPath of the element |
title |
string | title of the product considerations snippet |
items |
array | additional items present in the element if there are none, equals null |
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 |
array | 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 |
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 |
related_searches |
array | search queries related to the elment |
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 |
rectangle |
object | rectangle parameters contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP equals null if calculate_rectangles in the POST request is not set to true |
x |
float | x-axis coordinate x-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
y |
float | y-axis coordinate y-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
width |
float | width of the element in pixels |
height |
float | height of the element in pixels |
‘short_videos’ element in SERP![]() |
||
type |
string | type of element = ‘short_videos’ |
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 |
page |
integer | search results page number indicates the number of the SERP page on which the element is located |
position |
string | the alignment of the element in SERP can take the following values: left, right |
xpath |
string | the XPath of the element |
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 |
rectangle |
object | rectangle parameters contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP equals null if calculate_rectangles in the POST request is not set to true |
x |
float | x-axis coordinate x-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
y |
float | y-axis coordinate y-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
width |
float | width of the element in pixels |
height |
float | height of the element in pixels |
‘found_on_web’ element in SERP![]() |
||
type |
string | type of element = ‘found_on_web’ |
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 |
page |
integer | search results page number indicates the number of the SERP page on which the element is located |
position |
string | the alignment of the element in SERP can take the following values: left, right |
xpath |
string | the XPath of the element |
title |
string | title of the element |
related_searches |
array | search queries related to the elment |
items |
array | additional items present in the element if there are none, equals null |
type |
string | type of element = ‘found_on_web_element‘ |
title |
string | title of the result in SERP |
subtitle |
string | subtitle of the result in SERP |
image |
object | image 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) |
rectangle |
object | rectangle parameters contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP equals null if calculate_rectangles in the POST request is not set to true |
x |
float | x-axis coordinate x-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
y |
float | y-axis coordinate y-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
width |
float | width of the element in pixels |
height |
float | height of the element in pixels |
‘refine_products’ element in SERP![]() |
||
type |
string | type of element = ‘refine_products’ |
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 |
page |
integer | search results page number indicates the number of the SERP page on which the element is located |
position |
string | the alignment of the element in SERP can take the following values: left, right |
xpath |
string | the XPath of the element |
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 |
xpath |
string | the XPath of the element |
rectangle |
object | rectangle parameters contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP equals null if calculate_rectangles in the POST request is not set to true |
x |
float | x-axis coordinate x-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
y |
float | y-axis coordinate y-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
width |
float | width of the element in pixels |
height |
float | height of the element in pixels |
‘explore_brands’ element in SERP![]() |
||
type |
string | type of element = ‘explore_brands’ |
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 |
page |
integer | search results page number indicates the number of the SERP page on which the element is located |
position |
string | the alignment of the element in SERP can take the following values: left, right |
xpath |
string | the XPath of the element |
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) |
xpath |
string | the XPath of the element |
rectangle |
object | rectangle parameters contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP equals null if calculate_rectangles in the POST request is not set to true |
x |
float | x-axis coordinate x-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
y |
float | y-axis coordinate y-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
width |
float | width of the element in pixels |
height |
float | height of the element in pixels |
‘perspectives’ element in SERP![]() |
||
type |
string | type of element = ‘perspectives’ |
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 |
page |
integer | search results page number indicates the number of the SERP page on which the element is located |
position |
string | the alignment of the element in SERP can take the following values: left, right |
xpath |
string | the XPath of the element |
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 |
rectangle |
object | rectangle parameters contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP equals null if calculate_rectangles in the POST request is not set to true |
x |
float | x-axis coordinate x-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
y |
float | y-axis coordinate y-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
width |
float | width of the element in pixels |
height |
float | height of the element in pixels |
‘discussions_and_forums’ element in SERP![]() |
||
type |
string | type of element = ‘discussions_and_forums’ |
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 |
page |
integer | search results page number indicates the number of the SERP page on which the element is located |
position |
string | the alignment of the element in SERP can take the following values: left, right |
xpath |
string | the XPath of the element |
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 |
rectangle |
object | rectangle parameters contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP equals null if calculate_rectangles in the POST request is not set to true |
x |
float | x-axis coordinate x-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
y |
float | y-axis coordinate y-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
width |
float | width of the element in pixels |
height |
float | height of the element in pixels |
‘compare_sites’ element in SERP![]() |
||
type |
string | type of element = ‘compare_sites’ |
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 |
position |
string | the alignment of the element in SERP can take the following values: left, right |
xpath |
string | the XPath of the element |
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 |
rectangle |
object | rectangle parameters contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP equals null if calculate_rectangles in the POST request is not set to true |
x |
float | x-axis coordinate x-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
y |
float | y-axis coordinate y-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
width |
float | width of the element in pixels |
height |
float | height of the element in pixels |
‘ai_overview’ element in SERP![]() |
||
type |
string | type of element = ‘ai_overview’ |
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 |
page |
integer | search results page number indicates the number of the SERP page on which the element is located |
position |
string | the alignment of the element in SERP can take the following values: left, right |
xpath |
string | the XPath of the element |
asynchronous_ai_overview |
boolean | indicates whether the element is loaded asynchronously if true, the ai_overview element is loaded asynchronously;if false, the ai_overview element is loaded from cache |
markdown |
string | 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‘ |
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 |
page |
integer | search results page number indicates the number of the SERP page on which the element is located |
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 |
string | 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 |
rectangle |
object | rectangle parameters contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP equals null if calculate_rectangles in the POST request is not set to true |
x |
float | x-axis coordinate x-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
y |
float | y-axis coordinate y-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin |
width |
float | width of the element in pixels |
height |
float | height of the element in pixels |
Instead of ‘login’ and ‘password’ use your credentials from https://app.dataforseo.com/api-access
# Instead of 'login' and 'password' use your credentials from https://app.dataforseo.com/api-access
login="login"
password="password"
cred="$(printf ${login}:${password} | base64)"
id="02261816-2027-0066-0000-c27d02864073"
curl --location --request GET "https://api.dataforseo.com/v3/serp/google/organic/task_get/advanced/${id}"
--header "Authorization: Basic ${cred}"
--header "Content-Type: application/json"
--data-raw ""<?php
// You can download this file from here https://cdn.dataforseo.com/v3/examples/php/php_RestClient.zip
require('RestClient.php');
$api_url = 'https://api.dataforseo.com/';
try {
// Instead of 'login' and 'password' use your credentials from https://app.dataforseo.com/api-access
$client = new RestClient($api_url, null, 'login', 'password');
} catch (RestClientException $e) {
echo "n";
print "HTTP code: {$e->getHttpCode()}n";
print "Error code: {$e->getCode()}n";
print "Message: {$e->getMessage()}n";
print $e->getTraceAsString();
echo "n";
exit();
}
try {
$result = array();
// #1 - using this method you can get a list of completed tasks
// GET /v3/serp/google/organic/tasks_ready
// in addition to 'google' and 'organic' you can also set other search engine and type parameters
// the full list of possible parameters is available in documentation
$tasks_ready = $client->get('/v3/serp/google/organic/tasks_ready');
// you can find the full list of the response codes here https://docs.dataforseo.com/v3/appendix/errors
if (isset($tasks_ready['status_code']) AND $tasks_ready['status_code'] === 20000) {
foreach ($tasks_ready['tasks'] as $task) {
if (isset($task['result'])) {
foreach ($task['result'] as $task_ready) {
// #2 - using this method you can get results of each completed task
// GET /v3/serp/google/organic/task_get/advanced/$id
if (isset($task_ready['endpoint_advanced'])) {
$result[] = $client->get($task_ready['endpoint_advanced']);
}
// #3 - another way to get the task results by id
// GET /v3/serp/google/organic/task_get/advanced/$id
/*
if (isset($task_ready['id'])) {
$result[] = $client->get('/v3/serp/google/organic/task_get/advanced/' . $task_ready['id']);
}
*/
}
}
}
}
print_r($result);
// do something with result
} catch (RestClientException $e) {
echo "n";
print "HTTP code: {$e->getHttpCode()}n";
print "Error code: {$e->getCode()}n";
print "Message: {$e->getMessage()}n";
print $e->getTraceAsString();
echo "n";
}
$client = null;
?>const task_id = '02231256-2604-0066-2000-57133b8fc54e';
const axios = require('axios');
axios({
method: 'get',
url: 'https://api.dataforseo.com/v3/serp/google/organic/task_get/advanced/' + task_id,
auth: {
username: 'login',
password: 'password'
},
headers: {
'content-type': 'application/json'
}
}).then(function (response) {
var result = response['data']['tasks'];
// Result data
console.log(result);
}).catch(function (error) {
console.log(error);
});from client import RestClient
# You can download this file from here https://cdn.dataforseo.com/v3/examples/python/python_Client.zip
client = RestClient("login", "password")
# 1 - using this method you can get a list of completed tasks
# GET /v3/serp/google/organic/tasks_ready
# in addition to 'google' and 'organic' you can also set other search engine and type parameters
# the full list of possible parameters is available in documentation
response = client.get("/v3/serp/google/organic/tasks_ready")
# you can find the full list of the response codes here https://docs.dataforseo.com/v3/appendix/errors
if response['status_code'] == 20000:
results = []
for task in response['tasks']:
if (task['result'] and (len(task['result']) > 0)):
for resultTaskInfo in task['result']:
# 2 - using this method you can get results of each completed task
# GET /v3/serp/google/organic/advanced/$id
if(resultTaskInfo['endpoint_advanced']):
results.append(client.get(resultTaskInfo['endpoint_advanced']))
'''
# 3 - another way to get the task results by id
# GET /v3/serp/google/organic/task_get/advanced/$id
if(resultTaskInfo['id']):
results.append(client.get("/v3/serp/google/organic/task_get/advanced/" + resultTaskInfo['id']))
'''
print(results)
# do something with result
else:
print("error. Code: %d Message: %s" % (response["status_code"], response["status_message"]))using Newtonsoft.Json;
using System;
using System.Collections.Generic;
using System.Net.Http;
using System.Net.Http.Headers;
using System.Text;
using System.Threading.Tasks;
namespace DataForSeoDemos
{
public static partial class Demos
{
public static async Task serp_task_get()
{
var httpClient = new HttpClient
{
BaseAddress = new Uri("https://api.dataforseo.com/"),
// Instead of 'login' and 'password' use your credentials from https://app.dataforseo.com/api-access
DefaultRequestHeaders = { Authorization = new AuthenticationHeaderValue("Basic", Convert.ToBase64String(Encoding.ASCII.GetBytes("login:password"))) }
};
// #1 - using this method you can get a list of completed tasks
// GET /v3/serp/google/organic/tasks_ready
// in addition to 'google' and 'organic' you can also set other search engine and type parameters
// the full list of possible parameters is available in documentation
var response = await httpClient.GetAsync("/v3/serp/google/organic/tasks_ready");
var tasksInfo = JsonConvert.DeserializeObject<dynamic>(await response.Content.ReadAsStringAsync());
var tasksResponses = new List<object>();
// you can find the full list of the response codes here https://docs.dataforseo.com/v3/appendix/errors
if (tasksInfo.status_code == 20000)
{
if (tasksInfo.tasks != null)
{
foreach (var tasks in tasksInfo.tasks)
{
if (tasks.result != null)
{
foreach (var task in tasks.result)
{
if (task.endpoint_advanced != null)
{
// #2 - using this method you can get results of each completed task
// GET /v3/serp/google/organic/task_get/advanced/$id
var taskGetResponse = await httpClient.GetAsync((string)task.endpoint_advanced);
var taskResultObj = JsonConvert.DeserializeObject<dynamic>(await taskGetResponse.Content.ReadAsStringAsync());
if (taskResultObj.tasks != null)
{
var fst = taskResultObj.tasks.First;
// you can find the full list of the response codes here https://docs.dataforseo.com/v3/appendix/errors
if (fst.status_code >= 40000 || fst.result == null)
Console.WriteLine($"error. Code: {fst.status_code} Message: {fst.status_message}");
else
tasksResponses.Add(fst.result);
}
// #3 - another way to get the task results by id
// GET /v3/serp/google/organic/task_get/advanced/$id
/*
var tasksGetResponse = await httpClient.GetAsync("/v3/serp/google/organic/task_get/advanced/" + (string)task.id);
var tasksResultObj = JsonConvert.DeserializeObject<dynamic>(await tasksGetResponse.Content.ReadAsStringAsync());
if (tasksResultObj.tasks != null)
{
var fst = taskResultObj.tasks.First;
// you can find the full list of the response codes here https://docs.dataforseo.com/v3/appendix/errors
if (fst.status_code >= 40000 || fst.result == null)
Console.WriteLine($"error. Code: {fst.status_code} Message: {fst.status_message}");
else
tasksResponses.Add(fst.result);
}
*/
}
}
}
}
}
if (tasksResponses.Count > 0)
// do something with result
Console.WriteLine(String.Join(Environment.NewLine, tasksResponses));
else
Console.WriteLine("No completed tasks");
}
else
Console.WriteLine($"error. Code: {tasksInfo.status_code} Message: {tasksInfo.status_message}");
}
}
}The above command returns JSON structured like this:
{
"version": "0.1.20200129",
"status_code": 20000,
"status_message": "Ok.",
"time": "0.2347 sec.",
"cost": 0,
"tasks_count": 1,
"tasks_error": 0,
"tasks": [
{
"id": "01291734-1535-0066-0000-6988734166f9",
"status_code": 20000,
"status_message": "Ok.",
"time": "0.0934 sec.",
"cost": 0,
"result_count": 1,
"path": [
"v3",
"serp",
"google",
"organic",
"task_get",
"advanced",
"01291734-1535-0066-0000-6988734166f9"
],
"data": {
"api": "serp",
"function": "task_get",
"se": "google",
"se_type": "organic",
"language_name": "English",
"location_name": "United States",
"keyword": "flight ticket new york san francisco",
"priority": 2,
"tag": "tag2",
"device": "desktop",
"os": "windows"
},
"result": [
{
"keyword": "flight ticket new york san francisco",
"type": "organic",
"se_domain": "google.com",
"location_code": 2840,
"language_code": "en",
"check_url": "https://www.google.com/search?q=flight%20ticket%20new%20york%20san%20francisco&num=100&hl=en&gl=US&gws_rd=cr&ie=UTF-8&oe=UTF-8&uule=w+CAIQIFISCQs2MuSEtepUEUK33kOSuTsc",
"datetime": "2019-11-15 12:57:46 +00:00",
"spell": null,
"refinement_chips": {
"type": "refinement_chips",
"xpath": "/html[1]/body[1]/div[3]/div[1]/div[9]/div[1]/div[1]/div[3]/div[1]/div[1]",
"items": [
{
"type": "refinement_chips_element",
"title": "Remote",
"url": "https://www.google.com/search?num=100&sca_esv=427163c40a0d98b7&hl=en&gl=US&glp=1&q=bristol+temp+agencies+remote&uds=ADvngMjcH0KdF7qGWtwTBrP0nt7drlQNXJ_q6WhUnfcnlFQAOVqvQ09aiEx7jUP4Wb5sg6FzKTGyEoBQg36hfgreicnnhtBQv8H25iRkUIMWBSqTcu0nGLObB57jKDn4sIHqgjkv6AqtXzA0gTV6n6-p1_aOUPMmYdgJOPy5xybgxI0ZY3-OZUg&sa=X&ved=2ahUKEwjEjMPzrvyIAxVgpIkEHYTyBqEQxKsJegQIHRAB&ictx=0",
"domain": "www.google.com",
"options": null
},
{
"type": "refinement_chips_element",
"title": "Date posted",
"url": null,
"domain": null,
"options": [
{
"type": "refinement_chips_option",
"title": "Yesterday",
"url": "https://www.google.com/search?num=100&sca_esv=427163c40a0d98b7&hl=en&gl=US&glp=1&q=bristol+temp+agencies+since+yesterday&uds=ADvngMjcH0KdF7qGWtwTBrP0nt7d1cxhUU_4I1tnZ_YIEcACz8ZYvzwewv2vtaifFRGAtrClbFOcrHbTAbAeXm1jREcC6VS1VsCvY-sITnX4ozb-ILgfWEVwq_Z5ROUTUSIPShEnKXD5sUUbZbocrG609xSmt2d98g8y8m1lGjX2kp2G7tWTnMoyaYhx7tPHFsc1SlxiTTuylOmQpyaET98nEnMhDFUw8hSQnpfQcpEDEdBLwrOxN3gOZC4RtcHuKTyeCrFRnaDjQ17dNosh1yiBWrSXB9e1dQF-1Pt17wXCHwRUCH6wH0DbAN-oCNd7lMT2v24eI8rDkLQP3kTLpzGMUZReaWIAPw&sa=X&ved=2ahUKEwjEjMPzrvyIAxVgpIkEHYTyBqEQkbEKegQIDxAD",
"domain": "www.google.com"
},
{
"type": "refinement_chips_option",
"title": "Last 3 days",
"url": "https://www.google.com/search?num=100&sca_esv=427163c40a0d98b7&hl=en&gl=US&glp=1&q=bristol+temp+agencies+in+the+last+3+days&uds=ADvngMjcH0KdF7qGWtwTBrP0nt7dLQVdkfQJDu14-gF_eQoKa39tQdXyMUfu3HnnM3Pu4g5hOzwEez_H8t-yULnPJEgal7YGml0mtSaIuH3YeuIhPq5mBSo_ECo7hOJVwSRGkksXQg-RdTy8GhoT8Qm-ZFkyAQnSLmnlmv0Rm042YAlQ6JFqnfOW0VIOgTeTdYm6SLpzQ3a6YSvEf2tau3pEKxnGWKleL613vj0tLBWg4Jhsa0trdMkFPHDQYhc2caGQ8cmSYU4cqdB2Eq3PsNGgjgebvt7_7bbvjixC19O4L9ZB02rwY0EP30_mYAeTG9lYAx8ZJvGDslVLp0DHS93P8ynaiA7Bbw&sa=X&ved=2ahUKEwjEjMPzrvyIAxVgpIkEHYTyBqEQkbEKegQIDxAE",
"domain": "www.google.com"
}
]
}
]
},
"item_types": [
"answer_box",
"app",
"carousel",
"multi_carousel",
"featured_snippet",
"google_flights",
"google_reviews",
"google_posts",
"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",
"math_solver",
"mention_carousel",
"recipes",
"top_sights",
"scholarly_articles",
"popular_products",
"podcasts",
"questions_and_answers",
"find_results_on",
"stocks_box",
"visual_stories",
"commercial_units",
"local_services",
"google_hotels",
"currency_box",
"found_on_web",
"short_videos",
"refine_products",
"explore_brands",
"perspectives",
"discussions_and_forums",
"compare_sites",
"courses",
"ai_overview"
],
"se_results_count": 85600000,
"pages_count": 1,
"items_count": 96,
"items": [
{
"type": "carousel",
"rank_group": 1,
"rank_absolute": 3,
"page": 1,
"position": "left",
"xpath": "/html[1]/body[1]/div[7]/div[1]/div[11]/div[1]/div[2]/div[2]/div[1]/div[1]/div[1]/div[1]/div[1]/div[2]/div[2]/div[2]/div[1]/div[1]/div[1]/div[1]/div[1]",
"title": null,
"items": [
{
"type": "carousel_element",
"title": "Natalie Portman",
"subtitle": "Padmé Amidala",
"image_url": "https://api.dataforseo.com/cdn/i/01131446-1535-0139-0000-5bd5531716be:1"
},
{
"type": "carousel_element",
"title": "Hayden Christensen",
"subtitle": "Darth Vader",
"image_url": "https://api.dataforseo.com/cdn/i/01131446-1535-0139-0000-5bd5531716be:2"
},
{
"type": "carousel_element",
"title": "Daisy Ridley",
"subtitle": "Rey",
"image_url": "https://api.dataforseo.com/cdn/i/01131446-1535-0139-0000-5bd5531716be:3"
}
],
"rectangle": {
"x": 181,
"y": 360,
"width": 652,
"height": 176
}
},
{
"type": "multi_carousel",
"rank_group": 1,
"rank_absolute": 2,
"page": 1,
"position": "right",
"xpath": "/html[1]/body[1]/div[7]/div[2]/div[5]/div[1]/div[3]/div[1]/div[1]/div[1]/sticky-header[1]/div[2]/div[1]/g-flippy-carousel[1]/div[1]/div[1]/ol[1]/li[1]/span[1]/div[1]/div[1]/div[1]/div[3]/div[8]/div[1]/div[1]/div[1]/div[1]/div[1]/div[1]",
"items": [
{
"type": "multi_carousel_element",
"title": "Types of molds",
"multi_carousel_snippets": [
{
"type": "multi_carousel_snippet",
"title": "Aspergillus niger",
"subtitle": null,
"image_url": null
},
{
"type": "multi_carousel_snippet",
"title": "Penicillium chrysogen...",
"subtitle": null,
"image_url": null
},
{
"type": "multi_carousel_snippet",
"title": "Black bread mold",
"subtitle": null,
"image_url": null
}
]
}
],
"rectangle": {
"x": 181,
"y": 360,
"width": 652,
"height": 176
}
},
{
"type": "top_stories",
"rank_group": 1,
"rank_absolute": 3,
"page": 1,
"position": "left",
"xpath": "/html[1]/body[1]/div[7]/div[3]/div[10]/div[1]/div[2]/div[1]/div[2]/div[2]/div[1]/div[1]/div[2]/div[1]/g-section-with-header[1]/div[2]",
"title": null,
"items": [
{
"type": "top_stories_element",
"source": "Sky News",
"domain": "news.sky.com",
"title": "UK takes charge of coalition Gulf mission to protect ships from Iran",
"date": "2 hours ago",
"amp_version": false,
"timestamp": "2020-09-11 14:42:55 +00:00",
"url": "https://news.sky.com/story/uk-takes-charge-of-coalition-gulf-mission-to-protect-ships-from-iran-11921404",
"image_url": null,
"badges": null
},
{
"type": "top_stories_element",
"source": "The Jerusalem Post",
"domain": "www.jpost.com",
"title": "Iranian factory makes Israeli and American flags to burn",
"date": "6 hours ago",
"amp_version": false,
"timestamp": "2020-09-11 14:42:55 +00:00",
"url": "https://www.jpost.com/International/Iranian-factory-makes-Israeli-and-American-flags-to-burn-615902",
"image_url": null,
"badges": null
},
{
"type": "top_stories_element",
"source": "Reuters",
"domain": "www.reuters.com",
"title": "Iranian factory makes U.S. and Israeli flags to burn",
"date": "7 hours ago",
"amp_version": false,
"timestamp": "2020-09-11 14:42:55 +00:00",
"url": "https://www.reuters.com/article/us-iran-flags/iranian-factory-makes-us-and-israeli-flags-to-burn-idUSKBN1ZT065",
"image_url": null,
"badges": null
}
],
"rectangle": {
"x": 181,
"y": 360,
"width": 652,
"height": 176
}
},
{
"type": "math_solver",
"rank_group": 1,
"rank_absolute": 1,
"page": 1,
"position": "left",
"xpath": "/html[1]/body[1]/div[7]/div[1]/div[9]/div[1]/div[1]/div[2]/div[2]/div[1]/div[1]/div[1]",
"title": "3x^2-1x^2=50",
"result": "x=5 x=-5",
"items": [
{
"type": "math_solver_element",
"title": "Quadratic formula",
"expanded_element": [
{
"type": "math_solver_expanded_element",
"title": "Combine like terms",
"solution": [
"3x^2-x^2=50",
"2x^2=50"
]
},
{
"type": "math_solver_expanded_element",
"title": "Move terms to the left side",
"solution": [
"2x^2=50",
"2x^2-50=0"
]
},
{
"type": "math_solver_expanded_element",
"title": "Common factor",
"solution": [
"2x^2-50=0",
"2(x^2-25)=0"
]
}
]
},
{
"type": "math_solver_element",
"title": "Factor",
"expanded_element": [
{
"type": "math_solver_expanded_element",
"title": "Combine like terms",
"solution": [
"3x^2-x^2=50",
"2x^2=50"
]
}
]
}
],
"links": [
{
"type": "link_element",
"title": "Tiger Algebra",
"description": null,
"url": "https://www.tiger-algebra.com/en/solvetext/3x%5E2-x%5E2%3D50/?origin=googlemath",
"domain": "www.tiger-algebra.com"
},
{
"type": "link_element",
"title": "Symbolab",
"description": null,
"url": "https://www.symbolab.com/solver?or=gms&query=3x%5E2-x%5E2%3D50",
"domain": "www.symbolab.com"
},
{
"type": "link_element",
"title": "Mathway",
"description": null,
"url": "https://www.mathway.com/?asciimath=3x%5E2-x%5E2%3D50",
"domain": "www.mathway.com"
}
]
},
{
"type": "answer_box",
"rank_group": 1,
"rank_absolute": 1,
"page": 1,
"position": "left",
"xpath": "/html[1]/body[1]/div[5]/div[1]/div[12]/div[1]/div[2]/div[2]/div[1]/div[1]/div[1]/div[1]/block-component[1]/div[1]/div[1]/div[1]/div[1]/div[1]",
"text": [
"jeudi",
"31 octobre",
"Halloween 2024"
],
"links": null,
"rectangle": null
},
{
"type": "video",
"rank_group": 1,
"rank_absolute": 5,
"page": 1,
"position": "left",
"xpath": "/html[1]/body[1]/div[7]/div[3]/div[10]/div[1]/div[2]/div[1]/div[2]/div[2]/div[1]/div[1]/div[7]/div[1]/g-section-with-header[1]/div[2]",
"items": [
{
"type": "video_element",
"source": "YouTube",
"title": "Google Pixel 4 XL vs. iPhone 11 Pro Max Speed Test",
"timestamp": "2020-09-11 14:42:55 +00:00",
"url": "https://www.youtube.com/watch?v=Osp8K7W3qDY"
},
{
"type": "video_element",
"source": "YouTube",
"title": "iPhone XR vs iPhone 11 - Which Should You Choose?",
"timestamp": "2020-09-11 14:42:55 +00:00",
"url": "https://www.youtube.com/watch?v=BZ5fdNNHVu0"
},
{
"type": "video_element",
"source": "YouTube",
"title": "Why iPhone 11 Is Apple's Least Innovative iPhone Yet",
"timestamp": "2020-09-11 14:42:55 +00:00",
"url": "https://www.youtube.com/watch?v=7YyTCa6IMKA"
}
],
"rectangle": {
"x": 181,
"y": 360,
"width": 652,
"height": 176
}
},
{
"type": "organic",
"rank_group": 26,
"rank_absolute": 30,
"page": 1,
"position": "left",
"xpath": "/html[1]/body[1]/div[7]/div[1]/div[9]/div[1]/div[1]/div[2]/div[2]/div[1]/div[1]/div[29]",
"domain": "www.t-mobile.com",
"title": "Apple iPhone 12 Pro 5G | 4 colors in 512GB, 256GB & 128GB",
"url": "https://www.t-mobile.com/cell-phone/apple-iphone-12-pro",
"cache_url": null,
"related_search_url": null,
"breadcrumb": "https://www.t-mobile.com › Phones › Apple",
"website_name": "T-Mobile",
"is_image": false,
"is_video": false,
"is_featured_snippet": false,
"is_malicious": false,
"is_web_story": false,
"description": "Get a great deal on the 5G-ready Apple iPhone 12 Pro. See all the features, specs, price and get it on T-Mobile.",
"pre_snippet": null,
"extended_snippet": "Rating: 4 · 231 reviews · US$30.00 to US$899.99 · In stock",
"images": null,
"amp_version": false,
"rating": {
"rating_type": "Max5",
"value": 4,
"votes_count": 231,
"rating_max": 5
},
"price": {
"current": 30,
"regular": null,
"max_value": 899.99,
"currency": "USD",
"is_price_range": true,
"displayed_price": "US$30.00 to US$899.99"
},
"highlighted": null,
"links": null,
"faq": null,
"extended_people_also_search": null,
"about_this_result": {
"type": "about_this_result_element",
"url": "https://www.t-mobile.com/cell-phone/apple-iphone-12-pro",
"source": "Wikipedia",
"source_info": "T-Mobile is the brand name used by the mobile communications subsidiaries of the German telecommunications company Deutsche Telekom AG. The brand is also active in the Czech Republic, the Netherlands, Poland, and the United States.",
"source_url": "https://en.wikipedia.org/wiki/T-Mobile",
"language": "English",
"location": null,
"search_terms": [
"apple",
"iphone",
"12"
],
"related_terms": null
},
"related_result": [
{
"type": "related_result",
"xpath": "/html[1]/body[1]/div[7]/div[1]/div[9]/div[1]/div[1]/div[2]/div[2]/div[1]/div[1]/div[29]/div[1]/div[2]/ul[1]/li[1]",
"domain": "www.t-mobile.com",
"title": "Apple iPhone 12 | 5 colors in 64GB & 128GB | T-Mobile",
"url": "https://www.t-mobile.com/cell-phone/apple-iphone-12",
"cache_url": null,
"related_search_url": null,
"breadcrumb": "https://www.t-mobile.com › Phones › Apple",
"is_image": false,
"is_video": false,
"description": "iPhone 12. 5G to download movies on the fly and stream 

















































