Live {{up_se_name}} {{up_se_type}} SERP Advanced

‌
Live SERP provides real-time data on top search engine results for the specified keyword, search engine, and location. This endpoint will supply a complete overview of featured snippets and other extra elements of SERPs.

checked POST
Pricing

Your account will be charged for each request.
The cost can be calculated on the Pricing page.

All POST data should be sent in the JSON format (UTF-8 encoding). When setting a task, you should send all task parameters in the task array of the generic POST array. You can send up to 2000 API calls per minute, each Live SERP API call can contain only one task.

Below you will find a detailed description of the parameters that are required or recommended for setting a task.

Main Parameters

Field name Type Description
keyword string

keyword
required field
you can specify up to 700 characters in the keyword field
all %## will be decoded (plus character ‘+’ will be decoded to a space character)
if you need to use the “%” character for your keyword, please specify it as “%25”;
if you need to use the “+” character for your keyword, please specify it as “%2B”;
if this field contains such parameters as ‘allinanchor:’, ‘allintext:’, ‘allintitle:’, ‘allinurl:’, ‘define:’, ‘definition:’, ‘filetype:’, ‘id:’, ‘inanchor:’, ‘info:’, ‘intext:’, ‘intitle:’, ‘inurl:’, ‘link:’, ‘site:’, the charge per task will be multiplied by 5
Note: queries containing the ‘cache:’ parameter are not supported and will return a validation errorlearn more about rules and limitations of keyword and keywords fields in DataForSEO APIs in this Help Center article
location_code integer

search engine location code
required field if you don't specify location_name or location_coordinate
if you use this field, you don't need to specify location_name or location_coordinate
you can receive the list of available locations of the search engines with their location_code by making a separate request to the https://api.dataforseo.com/v3/serp/{{low_se_name}}/locations
example:
2840
language_code string

search engine language code
optional field if you specify language_name
if you use this field, you don't need to specify language_name
you can receive the list of available languages of the search engine with their language_code by making a separate request to the https://api.dataforseo.com/v3/serp/{{low_se_name}}/languages
example:
en
depth integer

parsing depth
optional field
number of results in SERP
default value: 10
max value: 200
device string

device type
optional field
can take the values:desktop, mobile
default value: desktop
load_async_ai_overview boolean

load asynchronous ai overview
optional field
set to true to obtain ai_overview items is SERPs even if they are loaded asynchronously;
if set to false, you will only obtain ai_overview items from cache;
default value: false
Note: you will be charged extra $0.002 for using this parameter;
if the element is absent or contains "asynchronous_ai_overview": false, all extra charges will be returned to your account balance

Below you will find a drop-down list with the additional parameters you can use for setting a task.

Additional Parameters
Field name Type Description
location_name string

full name of search engine location
required field if you don't specify location_code or location_coordinate
if you use this field, you don't need to specify location_code or location_coordinate
you can receive the list of available locations of the search engine with their location_name by making a separate request to the https://api.dataforseo.com/v3/serp/{{low_se_name}}/locations
example:
London,England,United Kingdom
language_name string

full name of search engine language
optional field if you specify language_code
if you use this field, you don't need to specify language_code
you can receive the list of available languages of the search engine with their language_name by making a separate request to the https://api.dataforseo.com/v3/serp/{{low_se_name}}/languages
example:
English
os string

device operating system
optional field
if you specify desktop in the device field, choose from the following values: windows, macos
default value: windows
if you specify mobile in the device field, choose from the following values: android, ios
default value: android
tag string

user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response
stop_crawl_on_match array

array of targets to stop crawling
optional field
if specified, the response will contain SERP results up to and including the specified match_value;
you can specify up to 10 target values in this array
example:
"stop_crawl_on_match":[{"match_value":"dataforseo.com","match_type":"with_subdomains"}]
learn more about this parameter on our Help Center
match_type string

target match type
required field if stop_crawl_on_match is specified;
type of match for the match_value
possible values: domain, with_subdomains, wildcard
match_value string

target domain or wildcard value
required field if stop_crawl_on_match is specified;
specify a target domain or wildcard value;
Note: domain name must be specified without a request protocol;
example: dataforseo.com
max_crawl_pages integer

page crawl limit
optional field
number of search results pages to crawl
max value: 100
Note: you will be charged for each page crawled (10 organic results per page);
learn more about pricing on our Pricing page;
Note#2: the max_crawl_pages and depth parameters complement each other;
learn more at our help center
search_param string

additional parameters of the search query
optional field
get the list of available parameters and additional details here
remove_from_url array

remove specific parameters from URLs
optional field
using this field, you can specify up to 10 parameters to remove from URLs in the result
example:
"remove_from_url": ["srsltid"]
Note: if the target field is specified, the specified URL parameters will be removed before the search
people_also_ask_click_depth integer

clicks on the corresponding element
optional field
specify the click depth on the people_also_ask element to get additional people_also_ask_element items;
Note your account will be billed $0.00015 extra for each click;
if the element is absent or we perform fewer clicks than you specified, all extra charges will be returned to your account balance
possible values: from 1 to 4
group_organic_results boolean

display related results
optional field
if set to true, the related_result element in the response will be provided as a snippet of its parent organic result;
if set to false, the related_result element will be provided as a separate organic result;
default value: true
calculate_rectangles boolean

calcualte pixel rankings for SERP elements in advanced results
optional field
pixel ranking refers to the distance between the result snippet and top left corner of the screen;
Visit Help Center to learn more>>
by default, the parameter is set to false;
Note: you will be charged extra $0.002 for using this parameter
browser_screen_width integer

browser screen width
optional field
you can set a custom browser screen width to calculate pixel rankings for a particular device;
by default, the parameter is set to:
1920 for desktop;
360 for mobile on android;
375 for mobile on iOS;
Note: to use this parameter, set calculate_rectangles to true
browser_screen_height integer

browser screen height
optional field
you can set a custom browser screen height to calculate pixel rankings for a particular device;
by default, the parameter is set to:
1080 for desktop;
640 for mobile on android;
812 for mobile on iOS;
Note: to use this parameter, set calculate_rectangles to true
browser_screen_resolution_ratio integer

browser screen resolution ratio
optional field
you can set a custom browser screen resolution ratio to calculate pixel rankings for a particular device;
possible values: from 1 to 3;
by default, the parameter is set to:
1 for desktop;
3 for mobile on android;
3 for mobile on iOS;
Note: to use this parameter, set calculate_rectangles to true
url string

direct URL of the search query
optional field
you can specify a direct URL and we will sort it out to the necessary fields. Note that this method is the most difficult for our API to process and also requires you to specify the exact language and location in the URL. In most cases, we wouldn’t recommend using this method.
example:
https://www.google.co.uk/search?q=%20rank%20tracker%20api&hl=en&gl=GB&uule=w+CAIQIFISCXXeIa8LoNhHEZkq1d1aOpZS
location_coordinate string

GPS coordinates of a location
optional field if you specify location_name or location_code
if you use this field, you don't need to specify location_name or location_code
location_coordinate parameter should be specified in the "latitude,longitude,radius" format
the maximum number of decimal digits for "latitude" and "longitude": 7
the minimum value for "radius": 199.9 (mm)
the maximum value for "radius": 199999 (mm)
example:
53.476225,-2.243572,200
se_domain string

search engine domain
optional field
we choose the relevant search engine domain automatically according to the location and language you specify
however, you can set a custom search engine domain in this field
example:
google.co.uk, google.com.au, google.de, etc.
target string

target domain, subdomain, or webpage to get results for
optional field
a domain or a subdomain should be specified without https:// and www.
note that the results of target-specific tasks will only include SERP elements that contain a url string;
you can also use a wildcard (‘*’) character to specify the search pattern in SERP and narrow down the results;
examples:
example.com - returns results for the website's home page with URLs, such as https://example.com, or https://www.example.com/, or https://example.com/;
example.com* - returns results for the domain, including all its pages;
*example.com* - returns results for the entire domain, including all its pages and subdomains;
*example.com - returns results for the home page regardless of the subdomain, such as https://en.example.com;
example.com/example-page - returns results for the exact URL;
example.com/example-page* - returns results for all domain's URLs that start with the specified string
target_search_mode string

target matching mode
optional field
to enable this parameter, stop_crawl_on_match must also be enabled
defines how the crawl should stop when multiple targets are specified in stop_crawl_on_match
possible values: all, any
all – the crawl stops only when all specified targets are found
any – the crawl stops when any single target is found
default value: any
learn more about this parameter on our Help Center
find_targets_in array

SERP element types to check for targets
optional field
to enable this parameter, stop_crawl_on_match must also be enabled
specifies which SERP element types should be checked for target matches
if not specified, all first-level elements with url and domain fields are checked for targets
possible values: organic, paid, local_pack, featured_snippet, events, google_flights, images, jobs, knowledge_graph, local_service, map, scholarly_articles, third_party_reviews, twitter
Note: cannot contain the same element types as ignore_targets_in
example:
"find_targets_in": ["organic", "featured_snippet"]
learn more about this parameter on our Help Center
ignore_targets_in array

SERP element types to exclude from target search
optional field
to enable this parameter, stop_crawl_on_match must also be enabled
specifies which SERP element types should be excluded when searching for target matches
possible values: organic, paid, local_pack, featured_snippet, events, google_flights, images, jobs, knowledge_graph, local_service, map, scholarly_articles, third_party_reviews, twitter
Note: cannot contain the same element types as find_targets_in
example:
"ignore_targets_in": ["paid", "images"]
learn more about this parameter on our Help Center

‌‌‌
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.

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 character ‘+’ 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 values
positions of elements with different type values are omitted from rank_group
                rank_absolute integer absolute rank in SERP
absolute position among all the elements in SERP
                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 integer 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 integer 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 integer width of the element in pixels
                  height integer 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 values
positions of elements with different type values are omitted from rank_group
                rank_absolute integer absolute rank in SERP
absolute position among all the elements in SERP
                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 integer 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 integer 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 integer width of the element in pixels
                    height integer 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 values
positions of elements with different type values are omitted from rank_group
                rank_absolute integer absolute rank in SERP
absolute position among all the elements in SERP
                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 integer 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 integer 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 integer width of the element in pixels
                    height integer 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 values
positions of elements with different type values are omitted from rank_group
                rank_absolute integer absolute rank in SERP
absolute position among all the elements in SERP
                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 integer 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 integer 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 integer width of the element in pixels
                    height integer 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 values
positions of elements with different type values are omitted from rank_group
                rank_absolute integer absolute rank in SERP
absolute position among all the elements in SERP
                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 integer 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 integer 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 integer width of the element in pixels
                    height integer 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 values
positions of elements with different type values are omitted from rank_group
                rank_absolute integer absolute rank in SERP
absolute position among all the elements in SERP
                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 integer 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 integer 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 integer width of the element in pixels
                    height integer 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 values
positions of elements with different type values are omitted from rank_group
                rank_absolute integer absolute rank in SERP
absolute position among all the elements in SERP
                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 integer 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 integer 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 integer width of the element in pixels
                    height integer 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 values
positions of elements with different type values are omitted from rank_group
                rank_absolute integer absolute rank in SERP
absolute position among all the elements in SERP
                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 integer 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 integer 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 integer width of the element in pixels
                    height integer 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 values
positions of elements with different type values are omitted from rank_group
                rank_absolute integer absolute rank in SERP
absolute position among all the elements in SERP
                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 integer 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 integer 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 integer width of the element in pixels
                    height integer 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 values
positions of elements with different type values are omitted from rank_group
                rank_absolute integer absolute rank in SERP
absolute position among all the elements in SERP
                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
                    type 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 integer 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 integer 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 integer width of the element in pixels
                        height integer 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 integer 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 integer 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 integer width of the element in pixels
                        height integer 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 values
positions of elements with different type values are omitted from rank_group
                        rank_absolute integer absolute rank in SERP
absolute position among all the elements in SERP
                        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 integer 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 integer 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 integer width of the element in pixels
                        height integer 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 integer 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 integer 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 integer width of the element in pixels
                        height integer 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 integer 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 integer 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 integer width of the element in pixels
                        height integer 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 integer 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 integer 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 integer width of the element in pixels
                        height integer 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 integer 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 integer 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 integer width of the element in pixels
                        height integer 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 integer 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 integer 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 integer width of the element in pixels
                        height integer 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 integer 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 integer 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 integer width of the element in pixels
                        height integer 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 integer 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 integer 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 integer width of the element in pixels
                        height integer 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 integer 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 integer 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 integer width of the element in pixels
                    height integer 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 values
positions of elements with different type values are omitted from rank_group
                rank_absolute integer absolute rank in SERP
absolute position among all the elements in SERP
                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 integer 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 integer 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 integer width of the element in pixels
                    height integer 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 values
positions of elements with different type values are omitted from rank_group
                rank_absolute integer absolute rank in SERP
absolute position among all the elements in SERP
                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 integer 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 integer 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 integer width of the element in pixels
                    height integer 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 values
positions of elements with different type values are omitted from rank_group
                rank_absolute integer absolute rank in SERP
absolute position among all the elements in SERP
                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 integer 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 integer 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 integer width of the element in pixels
                    height integer 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 values
positions of elements with different type values are omitted from rank_group
                rank_absolute integer absolute rank in SERP
absolute position among all the elements in SERP
                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 integer 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 integer 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 integer width of the element in pixels
                    height integer 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 values
positions of elements with different type values are omitted from rank_group
                rank_absolute integer absolute rank in SERP
absolute position among all the elements in SERP
                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 integer 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 integer 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 integer width of the element in pixels
                    height integer 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 values
positions of elements with different type values are omitted from rank_group
                rank_absolute integer absolute rank in SERP
absolute position among all the elements in SERP
                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 integer 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 integer 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 integer width of the element in pixels
                    height integer 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 values
positions of elements with different type values are omitted from rank_group
                rank_absolute integer absolute rank in SERP
absolute position among all the elements in SERP
                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 integer 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 integer 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 integer width of the element in pixels
                    height integer 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 values
positions of elements with different type values are omitted from rank_group
                rank_absolute integer absolute rank in SERP
absolute position among all the elements in SERP
                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 integer 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 integer 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 integer width of the element in pixels
                    height integer 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 values
positions of elements with different type values are omitted from rank_group
                rank_absolute integer absolute rank in SERP
absolute position among all the elements in SERP
                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 integer 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 integer 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 integer width of the element in pixels
                    height integer 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 values
positions of elements with different type values are omitted from rank_group
                rank_absolute integer absolute rank in SERP
absolute position among all the elements in SERP
                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 integer 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 integer 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 integer width of the element in pixels
                    height integer 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 values
positions of elements with different type values are omitted from rank_group
                rank_absolute integer absolute rank in SERP
absolute position among all the elements in SERP
                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 values
positions of elements with different type values are omitted from rank_group
                        rank_absolute integer absolute rank in SERP
absolute position among all the elements in SERP
                        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 integer 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 integer 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 integer width of the element in pixels
                    height integer 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 values
positions of elements with different type values are omitted from rank_group
                rank_absolute integer absolute rank in SERP
absolute position among all the elements in SERP
                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 integer 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 integer 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 integer width of the element in pixels
                    height integer 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 values
positions of elements with different type values are omitted from rank_group
                rank_absolute integer absolute rank in SERP
absolute position among all the elements in SERP
                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 integer 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 integer 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 integer width of the element in pixels
                    height integer 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 values
positions of elements with different type values are omitted from rank_group
                rank_absolute integer absolute rank in SERP
absolute position among all the elements in SERP
                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 integer 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 integer 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 integer width of the element in pixels
                    height integer 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 values
positions of elements with different type values are omitted from rank_group
                rank_absolute integer absolute rank in SERP
absolute position among all the elements in SERP
                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 integer 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 integer 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 integer width of the element in pixels
                    height integer 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 values
positions of elements with different type values are omitted from rank_group
                rank_absolute integer absolute rank in SERP
absolute position among all the elements in SERP
                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 integer 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 integer 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 integer width of the element in pixels
                    height integer 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 values
positions of elements with different type values are omitted from rank_group
                rank_absolute integer absolute rank in SERP
absolute position among all the elements in SERP
                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 integer 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 integer 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 integer width of the element in pixels
                    height integer 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 values
positions of elements with different type values are omitted from rank_group
                rank_absolute integer absolute rank in SERP
absolute position among all the elements in SERP
                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 integer 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 integer 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 integer width of the element in pixels
                    height integer 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 values
positions of elements with different type values are omitted from rank_group
                rank_absolute integer absolute rank in SERP
absolute position among all the elements in SERP
                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 integer 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 integer 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 integer width of the element in pixels
                    height integer 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 values
positions of elements with different type values are omitted from rank_group
                rank_absolute integer absolute rank in SERP
absolute position among all the elements in SERP
                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 integer 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 integer 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 integer width of the element in pixels
                    height integer 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 values
positions of elements with different type values are omitted from rank_group
                rank_absolute integer absolute rank in SERP
absolute position among all the elements in SERP
                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 integer 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 integer 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 integer width of the element in pixels
                    height integer 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 values
positions of elements with different type values are omitted from rank_group
                rank_absolute integer absolute rank in SERP
absolute position among all the elements in SERP
                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 integer 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 integer 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 integer width of the element in pixels
                    height integer 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 values
positions of elements with different type values are omitted from rank_group
                rank_absolute integer absolute rank in SERP
absolute position among all the elements in SERP
                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 integer 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 integer 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 integer width of the element in pixels
                    height integer 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 values
positions of elements with different type values are omitted from rank_group
                rank_absolute integer absolute rank in SERP
absolute position among all the elements in SERP
                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 integer 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 integer 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 integer width of the element in pixels
                    height integer 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 format
indicates 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 format
indicates the date and time for which the value field provides previous close price
for 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 values
positions of elements with different type values are omitted from rank_group
                rank_absolute integer absolute rank in SERP
absolute position among all the elements in SERP
                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 integer 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 integer 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 integer width of the element in pixels
                    height integer 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 values
positions of elements with different type values are omitted from rank_group
                rank_absolute integer absolute rank in SERP
absolute position among all the elements in SERP
                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 integer 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 integer 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 integer width of the element in pixels
                    height integer 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 values
positions of elements with different type values are omitted from rank_group
                rank_absolute integer absolute rank in SERP
absolute position among all the elements in SERP
                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 integer 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 integer 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 integer width of the element in pixels
                    height integer 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 values
positions of elements with different type values are omitted from rank_group
                rank_absolute integer absolute rank in SERP
absolute position among all the elements in SERP
                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 integer 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 integer 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 integer width of the element in pixels
                    height integer 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 values
positions of elements with different type values are omitted from rank_group
                rank_absolute integer absolute rank in SERP
absolute position among all the elements in SERP
                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 integer 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 integer 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 integer width of the element in pixels
                    height integer 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 values
positions of elements with different type values are omitted from rank_group
                rank_absolute integer absolute rank in SERP
absolute position among all the elements in SERP
                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 format
indicates date and time for which the exchange rate in the value field is provided
                            value float exchange rate
exchange rate for the date and time provided in the date field
                    previous_items array exchange rates on the preceding time period
contains exchange rate data based on the preceding time period
if there are none, equals null
                            type string type of element = ‘graph_element’
corresponds to one point on the graph that indicates the exchange rate for a specific date and time
                            date string date and time
in the yyyy-mm-ddThh:mm:ss ISO 8601 format
indicates the date and time for which the value field provides previous exchange rate
                            value float previous exchange rate
exchange rate on the preceding time period
                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 integer 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 integer 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 integer width of the element in pixels
                    height integer 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 values
positions of elements with different type values are omitted from rank_group
                rank_absolute integer absolute rank in SERP
absolute position among all the elements in SERP
                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 integer 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 integer 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 integer width of the element in pixels
                    height integer 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 values
positions of elements with different type values are omitted from rank_group
                rank_absolute integer absolute rank in SERP
absolute position among all the elements in SERP
                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 integer 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 integer 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 integer width of the element in pixels
                    height integer 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 values
positions of elements with different type values are omitted from rank_group
                rank_absolute integer absolute rank in SERP
absolute position among all the elements in SERP
                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 integer 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 integer 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 integer width of the element in pixels
                    height integer 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 values
positions of elements with different type values are omitted from rank_group
                rank_absolute integer absolute rank in SERP
absolute position among all the elements in SERP
                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 integer 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 integer 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 integer width of the element in pixels
                    height integer 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 values
positions of elements with different type values are omitted from rank_group
                rank_absolute integer absolute rank in SERP
absolute position among all the elements in SERP
                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 integer 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 integer 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 integer width of the element in pixels
                    height integer 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 values
positions of elements with different type values are omitted from rank_group
                rank_absolute integer absolute rank in SERP
absolute position among all the elements in SERP
                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 integer 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 integer 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 integer width of the element in pixels
                    height integer 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 values
positions of elements with different type values are omitted from rank_group
                rank_absolute integer absolute rank in SERP
absolute position among all the elements in SERP
                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 integer 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 integer 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 integer width of the element in pixels
                    height integer 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 values
positions of elements with different type values are omitted from rank_group
                rank_absolute integer absolute rank in SERP
absolute position among all the elements in SERP
                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 integer 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 integer 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 integer width of the element in pixels
                    height integer 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 values
positions of elements with different type values are omitted from rank_group
                rank_absolute integer absolute rank in SERP
absolute position among all the elements in SERP
                position string the alignment of the element in SERP
can take the following values:
left, right
                xpath string the XPath of the element
                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 integer 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 integer 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 integer width of the element in pixels
                    height integer 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 values
positions of elements with different type values are omitted from rank_group
                rank_absolute integer absolute rank in SERP
absolute position among all the elements in SERP
                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 values
positions of elements with different type values are omitted from rank_group
                    rank_absolute integer absolute rank in SERP
absolute position among all the elements in SERP
                    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 integer 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 integer 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 integer width of the element in pixels
                    height integer 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)" 
curl --location --request POST "https://api.dataforseo.com/v3/serp/{{low_se_name}}/{{low_se_type}}/live/advanced" 
--header "Authorization: Basic ${cred}"  
--header "Content-Type: application/json" 
--data-raw "[
    {
        "language_code": "en",
        "location_code": 2840,
        "keyword": "albert einstein",
        "calculate_rectangles": true
    }
]"
<?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();
}
$post_array = array();
// You can set only one task at a time
$post_array[] = array(
    "language_code" => "en",
    "location_code" => 2840,
    "keyword" => mb_convert_encoding("albert einstein", "UTF-8"),
    "calculate_rectangles" => true
);
try {
    // POST /v3/serp/{{low_se_name}}/{{low_se_type}}/live/advanced
    // in addition to '{{low_se_name}}' and '{{low_se_type}}' you can also set other search engine and type parameters
    // the full list of possible parameters is available in documentation
    $result = $client->post('/v3/serp/{{low_se_name}}/{{low_se_type}}/live/advanced', $post_array);
    print_r($result);
    // do something with post 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 axios = require('axios');

axios({
    method: 'post',
    url: 'https://api.dataforseo.com/v3/serp/{{low_se_name}}/{{low_se_type}}/live/advanced',
    auth: {
        username: 'login',
        password: 'password'
    },
    data: [{
        "keyword": encodeURI("albert einstein"),
        "calculate_rectangles": true,
        "language_code": "en",
        "location_code": 2840
    }],
    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")
post_data = dict()
# You can set only one task at a time
post_data[len(post_data)] = dict(
language_code="en",
location_code=2840,
keyword="albert einstein",
calculate_rectangles=True
)
# POST /v3/serp/{{low_se_name}}/{{low_se_type}}/live/advanced
# in addition to '{{low_se_name}}' and '{{low_se_type}}' you can also set other search engine and type parameters
# the full list of possible parameters is available in documentation
response = client.post("/v3/serp/{{low_se_name}}/{{low_se_type}}/live/advanced", post_data)
# you can find the full list of the response codes here https://docs.dataforseo.com/v3/appendix/errors
if response["status_code"] == 20000:
print(response)
# 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.Threading.Tasks;

namespace DataForSeoDemos
{
    public static partial class Demos
    {
        public static async Task serp_live_advanced()
        {
            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"))) }
            };
            var postData = new List<object>();
            // You can set only one task at a time
            postData.Add(new
            {
                language_code = "en",
                location_code = 2840,
                keyword = "albert einstein",
                calculate_rectangles = true
            });
            // POST /v3/serp/{{low_se_name}}/{{low_se_type}}/live/advanced
            // in addition to '{{low_se_name}}' and '{{low_se_type}}' you can also set other search engine and type parameters
            // the full list of possible parameters is available in documentation
            var taskPostResponse = await httpClient.PostAsync("/v3/serp/{{low_se_name}}/{{low_se_type}}/live/advanced", new StringContent(JsonConvert.SerializeObject(postData)));
            var result = JsonConvert.DeserializeObject<dynamic>(await taskPostResponse.Content.ReadAsStringAsync());
            // you can find the full list of the response codes here https://docs.dataforseo.com/v3/appendix/errors
            if (result.status_code == 20000)
            {
                // do something with result
                Console.WriteLine(result);
            }
            else
                Console.WriteLine($"error. Code: {result.status_code} Message: {result.status_message}");
        }
    }
}

The above command returns JSON structured like this:

{
  "version": "0.1.20200129",
  "status_code": 20000,
  "status_message": "Ok.",
  "time": "0.3059 sec.",
  "cost": 0.003,
  "tasks_count": 1,
  "tasks_error": 0,
  "tasks": [
    {
      "id": "11151456-0696-0066-0000-002a5915da37",
      "status_code": 20000,
      "status_message": "Ok.",
      "time": "0.0952 sec.",
      "cost": 0.003,
      "result_count": 1,
      "path": [
        "v3",
        "serp",
        "google",
        "organic",
        "advanced",
        "live"
      ],
      "data": {
        "api": "serp",
        "function": "live",
        "se": "google",
        "se_type": "organic",
        "language_name": "English",
        "location_name": "United States",
        "keyword": "flight ticket new york san francisco",
        "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.