Live SERP provides real-time data on top 100 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.
Instead of ‘login’ and ‘password’ use your credentials from https://app.dataforseo.com/api-dashboard
# Instead of 'login' and 'password' use your credentials from https://app.dataforseo.com/api-dashboard \
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-dashboard
$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;
?>
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-dashboard
//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:
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 fields you can use for setting a task.
Description of the fields for setting a task:
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:’, ‘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 error
learn more about rules and limitations of keyword and keywords fields in DataForSEO APIs in this Help Center article
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
depth
integer
parsing depth
optional field
number of results in SERP
default value: 100
max value: 700 Note: your account will be billed per each SERP containing up to 100 results;
thus, setting a depth above 100 may result in additional charges if the search engine returns more than 100 results;
if the specified depth is higher than the number of results in the response, the difference will be refunded automatically to your account balance
max_crawl_pages
integer
page crawl limit
optional field
number of search results pages to crawl
max value: 100 Note: the max_crawl_pages and depth parameters complement each other;
learn more at our help center
location_name
string
full name of search engine location required field if you don’t specifylocation_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
location_code
integer
search engine location code required field if you don’t specifylocation_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
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
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
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
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.
device
string
device type
optional field
can take the values:desktop, mobile
default value: desktop
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
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
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: if set to true, the charge per task will be multiplied by 2
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
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
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 asynchronically;
if set to false, you will only obtain ai_overview items from cache;
default value: false Note your account will be billed $0.002 extra for each request;
if the element is absent or contains "asynchronous_ai_overview": false, all extra charges will be returned to your account balance
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
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
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
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 relevant 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
URL to a similar search
URL to a new search for the same keyword(s) on related sites
breadcrumb
string
breadcrumb in SERP
is_image
boolean
indicates whether the element contains an image
is_video
boolean
indicates whether the element contains a video
description
string
description of the results element in SERP
pre_snippet
string
includes additional information appended before the result description in SERP
extended_snippet
string
includes additional information appended after the result description in SERP
images
array
images of the element
type
string
type of element = ‘images_element‘
alt
string
alt tag of the image
url
string
relevant URL
image_url
string
URL of the image
the URL leading to the image on the original resource or DataForSEO storage (in case the original source is not available)
amp_version
boolean
Accelerated Mobile Pages
indicates whether an item has the Accelerated Mobile Page (AMP) version
rating
object
the item’s rating
the popularity rate based on reviews and displayed in SERP
rating_type
string
the type of rating
here you can find the following elements: Max5, Percents, CustomMax
value
float
the value of the rating
votes_count
integer
the amount of feedback
rating_max
integer
the maximum value for a rating_type
price
object
pricing details
contains the pricing details of the product or service featured in the result
current
float
current price
indicates the current price of the product or service featured in the result
regular
float
regular price
indicates the regular price of the product or service with no discounts applied
max_value
float
the maximum price
the maximum price of the product or service as indicated in the result
currency
string
currency of the listed price
ISO code of the currency applied to the price
is_price_range
boolean
price is provided as a range
indicates whether a price is provided in a range
displayed_price
string
price string in the result
raw price string as provided in the result
highlighted
array
words highlighted in bold within the results description
about_this_result
object
contains information from the ‘About this result’ panel ‘About this result’ panel provides additional context about why Google returned this result for the given query;
this feature appears after clicking on the three dots next to most results
type
string
type of element = ‘about_this_result_element‘
url
string
result’s URL
source
string
source of additional information about the result
source_info
string
additional information about the result
description of the website from Wikipedia or another additional context
source_url
string
URL to full information from the source
language
string
the language of the result
location
string
location for which the result is relevant
search_terms
array
matching search terms that appear in the result
related_terms
array
related search terms that appear in the result
timestamp
string
date and time when the result was published
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example: 2019-11-15 12:57:46 +00:00
timestamp
string
date and time when the result was published
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example: 2019-11-15 12:57:46 +00:00
rectangle
object
rectangle parameters
contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP
equals null if calculate_rectangles in the POST request is not set to true
x
float
x-axis coordinate
x-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin
y
float
y-axis coordinate
y-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin
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
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
rectangle
object
rectangle parameters
contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP
equals null if calculate_rectangles in the POST request is not set to true
x
float
x-axis coordinate
x-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin
y
float
y-axis coordinate
y-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin
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
additional items present in the element
if there are none, equals null
type
string
type of element = ‘carousel_element‘
title
string
title of the item
subtitle
string
subtitle of the item
image_url
string
URL of the image
the URL leading to the image on the original resource or DataForSEO storage (in case the original source is not available)
rectangle
object
rectangle parameters
contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP
equals null if calculate_rectangles in the POST request is not set to true
x
float
x-axis coordinate
x-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin
y
float
y-axis coordinate
y-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin
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
additional items present in the element
if there are none, equals null
type
string
type of element = ‘multi_carousel_element‘
title
string
title of the item
multi_carousel_snippets
array
multi_carousel_snippet results
type
string
type of element = ‘multi_carousel_snippet‘
title
string
title of a particular item
subtitle
string
subtitle of the item
image_url
string
URL of the image
the URL leading to the image on the original resource or DataForSEO storage (in case the original source is not available)
rectangle
object
rectangle parameters
contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP
equals null if calculate_rectangles in the POST request is not set to true
x
float
x-axis coordinate
x-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin
y
float
y-axis coordinate
y-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin
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
sitelinks
the links shown below some of Google’s search results
if there are none, equals null
type
string
type of element = ‘link_element‘
title
string
title of the link
description
string
description of the results element in SERP
url
string
URL link
domain
string
domain in SERP
rectangle
object
rectangle parameters
contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP
equals null if calculate_rectangles in the POST request is not set to true
x
float
x-axis coordinate
x-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin
y
float
y-axis coordinate
y-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin
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
additional items present in the element
if there are none, equals null
rectangle
object
rectangle parameters
contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP
equals null if calculate_rectangles in the POST request is not set to true
x
float
x-axis coordinate
x-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin
y
float
y-axis coordinate
y-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin
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
additional items present in the element
if there are none, equals null
rectangle
object
rectangle parameters
contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP
equals null if calculate_rectangles in the POST request is not set to true
x
float
x-axis coordinate
x-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin
y
float
y-axis coordinate
y-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin
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
the item’s rating
the popularity rate based on reviews and displayed in SERP
rating_type
string
the type of rating
here you can find the following elements: Max5, Percents, CustomMax
value
float
the value of the rating
votes_count
integer
the amount of feedback
rating_max
integer
the maximum value for a rating_type
cid
string
google-defined client id
unique id of a local establishment;
can be used with Google Reviews API to get a full list of reviews
rectangle
object
rectangle parameters
contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP
equals null if calculate_rectangles in the POST request is not set to true
x
float
x-axis coordinate
x-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin
y
float
y-axis coordinate
y-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin
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
starting date of stay
in the format “year-month-date”
example:
2019-11-15
date_to
string
ending date of stay
in the format “year-month-date”
example:
2019-11-17
items
array
contains results featured in the ‘hotels_pack’ element of SERP
type
string
type of element = ‘hotels_pack_element’
price
object
price of booking a place for the specified dates of stay
current
float
current price
indicates the current price of booking a place for the specified dates of stay
regular
float
regular price
indicates the regular price of booking a place for the specified dates of stay
max_value
float
the maximum price
the maximum price of booking a place for the specified dates of stay
currency
string
currency of the listed price
ISO code of the currency applied to the price
is_price_range
boolean
price is provided as a range
indicates whether a price is provided in a range
displayed_price
string
price string in the result
raw price string as provided in the result
title
string
title of the place
desription
string
description of the place in SERP
hotel_identifier
string
unique hotel identifier
unique hotel identifier assigned by Google;
example: "CgoIjaeSlI6CnNpVEAE"
domain
string
domain in SERP
url
string
relevant URL
is_paid
boolean
indicates whether the element is an ad
rating
object
the item’s rating
the popularity rate based on reviews and displayed in SERP
rating_type
string
the type of rating
here you can find the following elements: Max5, Percents, CustomMax
value
float
the value of the rating
votes_count
integer
the amount of feedback
rating_max
integer
the maximum value for a rating_type
rectangle
object
rectangle parameters
contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP
equals null if calculate_rectangles in the POST request is not set to true
x
float
x-axis coordinate
x-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin
y
float
y-axis coordinate
y-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin
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
position
string
the alignment of the element in SERP
can take the following values: left, right
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
position
string
the alignment of the element in SERP
can take the following values: left, right
rectangle parameters
contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP
equals null if calculate_rectangles in the POST request is not set to true
x
float
x-axis coordinate
x-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin
y
float
y-axis coordinate
y-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin
width
float
width of the element in pixels
height
float
height of the element in pixels
type
string
type of element = ‘knowledge_graph_list_item‘
rank_group
integer
group rank in SERP
position within a group of elements with identical type values;
positions of elements with different type values are omitted from rank_group;
always equals 0 for desktop
rank_absolute
integer
absolute rank in SERP
absolute position among all the elements in SERP
always equals 0 for desktop
position
string
the alignment of the element in SERP
can take the following values: left, right
rectangle parameters
contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP
equals null if calculate_rectangles in the POST request is not set to true
x
float
x-axis coordinate
x-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin
y
float
y-axis coordinate
y-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin
width
float
width of the element in pixels
height
float
height of the element in pixels
type
string
type of element = ‘knowledge_graph_ai_overview_item‘‘
rank_group
integer
group rank in SERP
position within a group of elements with identical type values;
positions of elements with different type values are omitted from rank_group;
always equals 0 for desktop
rank_absolute
integer
absolute rank in SERP
absolute position among all the elements in SERP
always equals 0 for desktop
position
string
the alignment of the element in SERP
can take the following values: left, right
indicates whether the element is loaded asynchronically
if true, the ai_overview element is loaded asynchronically;
if false, the ai_overview element is loaded from cache;
items
array
items present in the element
type
string
type of element = ‘ai_overview_element‘
title
string
title of the element
text
string
text or description of the element in SERP
images
array
images of the element
type
string
type of element = ‘images_element‘
alt
string
alt tag of the image
url
string
relevant URL
image_url
string
URL of the image
the URL leading to the image on the original resource or DataForSEO storage (in case the original source is not available)
references
array
references relevant to the element
type
string
type of element = ‘ai_overview_reference‘
source
string
reference source name or title
domain
string
domain name of the reference
url
string
reference page URL
title
string
reference page title
text
string
reference text
text snippet from the page that was used to generate the ai_overview_element
references
array
additional references relevant to the item
includes references to webpages that may have been used to generate the ai_overview
type
string
type of element = ‘ai_overview_reference‘
source
string
reference source name or title
domain
string
domain name of the reference
url
string
reference page URL
title
string
reference page title
text
string
reference text
text snippet from the page that was used to generate the ai_overview_element
rectangle
object
rectangle parameters
contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP
equals null if calculate_rectangles in the POST request is not set to true
x
float
x-axis coordinate
x-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin
y
float
y-axis coordinate
y-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin
width
float
width of the element in pixels
height
float
height of the element in pixels
type
string
type of element = ‘knowledge_graph_description_item‘
rank_group
integer
group rank in SERP
position within a group of elements with identical type values;
positions of elements with different type values are omitted from rank_group;
always equals 0 for desktop
rank_absolute
integer
absolute rank in SERP
absolute position among all the elements in SERP
always equals 0 for desktop
position
string
the alignment of the element in SERP
can take the following values: left, right
rectangle parameters
contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP
equals null if calculate_rectangles in the POST request is not set to true
x
float
x-axis coordinate
x-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin
y
float
y-axis coordinate
y-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin
width
float
width of the element in pixels
height
float
height of the element in pixels
type
string
type of element = ‘knowledge_graph_row_item‘
rank_group
integer
group rank in SERP
position within a group of elements with identical type values;
positions of elements with different type values are omitted from rank_group;
always equals 0 for desktop
rank_absolute
integer
absolute rank in SERP
absolute position among all the elements in SERP
always equals 0 for desktop
position
string
the alignment of the element in SERP
can take the following values: left, right
rectangle parameters
contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP
equals null if calculate_rectangles in the POST request is not set to true
x
float
x-axis coordinate
x-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin
y
float
y-axis coordinate
y-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin
width
float
width of the element in pixels
height
float
height of the element in pixels
type
string
type of element = ‘knowledge_graph_carousel_item‘
rank_group
integer
group rank in SERP
position within a group of elements with identical type values;
positions of elements with different type values are omitted from rank_group;
always equals 0 for desktop
rank_absolute
integer
absolute rank in SERP
absolute position among all the elements in SERP
always equals 0 for desktop
position
string
the alignment of the element in SERP
can take the following values: left, right
rectangle parameters
contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP
equals null if calculate_rectangles in the POST request is not set to true
x
float
x-axis coordinate
x-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin
y
float
y-axis coordinate
y-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin
width
float
width of the element in pixels
height
float
height of the element in pixels
type
string
type of element = ‘knowledge_graph_part_item‘
rank_group
integer
group rank in SERP
position within a group of elements with identical type values;
positions of elements with different type values are omitted from rank_group;
always equals 0 for desktop
rank_absolute
integer
absolute rank in SERP
absolute position among all the elements in SERP
always equals 0 for desktop
position
string
the alignment of the element in SERP
can take the following values: left, right
rectangle parameters
contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP
equals null if calculate_rectangles in the POST request is not set to true
x
float
x-axis coordinate
x-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin
y
float
y-axis coordinate
y-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin
width
float
width of the element in pixels
height
float
height of the element in pixels
type
string
type of element = ‘knowledge_graph_expanded_item‘
rank_group
integer
group rank in SERP
position within a group of elements with identical type values;
positions of elements with different type values are omitted from rank_group;
always equals 0 for desktop
rank_absolute
integer
absolute rank in SERP
absolute position among all the elements in SERP
always equals 0 for desktop
position
string
the alignment of the element in SERP
can take the following values: left, right
google defined data attribute ID
example: kc:/local:place qa
expanded_element
array
link of the element
type
string
type of element = ‘knowledge_graph_expanded_element‘
featured_title
string
title of a given element
url
string
source URL
domain
string
source domain
title
string
source title
snippet
string
text alongside the title
timestamp
string
date and time when the result was published
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example: 2019-11-15 12:57:46 +00:00
images
array
images of the element
type
string
type of element = ‘images_element‘
alt
string
alt tag of the image
url
string
relevant URL
image_url
string
URL of the image
the URL leading to the image on the original resource or DataForSEO storage (in case the original source is not available)
table
object
table element
table_element
string
name assigned to the table element
possible values: table_element
table_header
array
column names
table_content
array
the content of the table
one line of the table in this element of the array
rectangle
object
rectangle parameters
contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP
equals null if calculate_rectangles in the POST request is not set to true
x
float
x-axis coordinate
x-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin
y
float
y-axis coordinate
y-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin
width
float
width of the element in pixels
height
float
height of the element in pixels
type
string
type of element = ‘knowledge_graph_shopping_item‘
rank_group
integer
group rank in SERP
position within a group of elements with identical type values;
positions of elements with different type values are omitted from rank_group;
always equals 0 for desktop
rank_absolute
integer
absolute rank in SERP
absolute position among all the elements in SERP
always equals 0 for desktop
position
string
the alignment of the element in SERP
can take the following values: left, right
google defined data attribute ID
example: kc:/shopping/gpc:organic-offers
items
array
link of the element
type
string
type of element = ‘knowledge_graph_shopping_element‘
title
string
title of a given shopping element
url
string
URL
domain
string
domain in url
price
object
price indicated in the element
current
float
current price
refers to the current price indicated in the element
regular
float
regular price
refers to the regular price indicated in the element
max_value
float
the maximum price
refers to the maximum price indicated in the element
currency
string
currency of the listed price
ISO code of the currency applied to the price
is_price_range
boolean
price is provided as a range
indicates whether a price is provided in a range
displayed_price
string
price string in the result
raw price string as provided in the result
source
string
web source of the shopping element
indicates the source of information included in the element
snippet
string
description of the shopping element
marketplace
string
merchant account provider
ecommerce site that hosts products or websites of individual sellers under the same merchant account
example: by Google
marketplace_url
string
URL to the merchant account provider
ecommerce site that hosts products or websites of individual sellers under the same merchant account
rectangle
object
rectangle parameters
contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP
equals null if calculate_rectangles in the POST request is not set to true
x
float
x-axis coordinate
x-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin
y
float
y-axis coordinate
y-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin
width
float
width of the element in pixels
height
float
height of the element in pixels
type
string
type of element = ‘knowledge_graph_hotels_booking_item‘
rank_group
integer
group rank in SERP
position within a group of elements with identical type values;
positions of elements with different type values are omitted from rank_group;
always equals 0 for desktop
rank_absolute
integer
absolute rank in SERP
absolute position among all the elements in SERP
always equals 0 for desktop
position
string
the alignment of the element in SERP
can take the following values: left, right
starting date of stay
in the format “year-month-date”
example:
2019-11-15
date_to
string
ending date of stay
in the format “year-month-date”
example:
2019-11-17
data_attrid
string
google defined data attribute ID
example: kc:/local:hotel booking
items
array
contains arrays of elements available in the list
type
string
type of element = ‘knowledge_graph_hotels_booking_element‘
source
string
web source of the hotel booking element
indicates the source of information included in the element
description
string
description of the hotel booking element
url
string
URL
domain
string
domain in the URL
price
object
price indicated in the element
current
float
current price
refers to the current price indicated in the element
regular
float
regular price
refers to the regular price indicated in the element
max_value
float
the maximum price
refers to the maximum price indicated in the element
currency
string
currency of the listed price
ISO code of the currency applied to the price
is_price_range
boolean
price is provided as a range
indicates whether a price is provided in a range
displayed_price
string
price string in the result
raw price string as provided in the result
is_paid
boolean
indicates whether the element is an ad
rectangle
object
rectangle parameters
contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP
equals null if calculate_rectangles in the POST request is not set to true
x
float
x-axis coordinate
x-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin
y
float
y-axis coordinate
y-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin
width
float
width of the element in pixels
height
float
height of the element in pixels
rectangle
object
rectangle parameters
contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP
equals null if calculate_rectangles in the POST request is not set to true
x
float
x-axis coordinate
x-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin
y
float
y-axis coordinate
y-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin
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
date and time when the result was published
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example: 2019-11-15 12:57:46 +00:00
url
string
relevant URL
images
array
images of the element
type
string
type of element = ‘images_element‘
alt
string
alt tag of the image
url
string
relevant URL
image_url
string
URL of the image
the URL leading to the image on the original resource or DataForSEO storage (in case the original source is not available)
table
object
results table
if there are none, equals null
table_header
array
column names
table_content
array
the content of the table
one line of the table in this element of the array
rectangle
object
rectangle parameters
contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP
equals null if calculate_rectangles in the POST request is not set to true
x
float
x-axis coordinate
x-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin
y
float
y-axis coordinate
y-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin
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
additional items present in the element
if there are none, equals null
type
string
type of element = ‘top_stories_element‘
source
string
source of the element
indicates the source of information included in the top_stories_element
domain
string
domain in SERP
title
string
title of the result in SERP
date
string
the date when the page source of the element was published
amp_version
boolean
Accelerated Mobile Pages
indicates whether an item has the Accelerated Mobile Page (AMP) version
timestamp
string
date and time when the result was published
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example: 2019-11-15 12:57:46 +00:00
url
string
URL
image_url
string
URL of the image
the URL leading to the image on the original resource or DataForSEO storage (in case the original source is not available)
badges
array
badges relevant to the element
rectangle
object
rectangle parameters
contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP
equals null if calculate_rectangles in the POST request is not set to true
x
float
x-axis coordinate
x-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin
y
float
y-axis coordinate
y-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin
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
additional items present in the element
if there are none, equals null
type
string
type of element = ‘twitter_element‘
tweet
string
tweet message
date
string
the posting date
timestamp
string
date and time when the result was published
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example: 2019-11-15 12:57:46 +00:00
url
string
URL
rectangle
object
rectangle parameters
contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP
equals null if calculate_rectangles in the POST request is not set to true
x
float
x-axis coordinate
x-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin
y
float
y-axis coordinate
y-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin
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
rectangle parameters
contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP
equals null if calculate_rectangles in the POST request is not set to true
x
float
x-axis coordinate
x-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin
y
float
y-axis coordinate
y-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin
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
additional items present in the element
if there are none, equals null
type
string
type of element = ‘google_flights_element‘
description
string
description
url
string
URL
rectangle
object
rectangle parameters
contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP
equals null if calculate_rectangles in the POST request is not set to true
x
float
x-axis coordinate
x-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin
y
float
y-axis coordinate
y-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin
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
the element’s rating
the popularity rate based on reviews and displayed in SERP
rating_type
string
the type of rating
here you can find the following elements: Max5, Percents, CustomMax
value
integer
the value of the rating
votes_count
integer
the amount of feedback
rating_max
integer
the maximum value for a rating_type
place_id
string
the identifier of a place
feature
string
the additional feature of the review
cid
string
google-defined client id
unique id of a local establishment;
can be used with Google Reviews API to get a full list of reviews
rectangle
object
rectangle parameters
contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP
equals null if calculate_rectangles in the POST request is not set to true
x
float
x-axis coordinate
x-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin
y
float
y-axis coordinate
y-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin
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
google-defined client id
unique id of a local establishment;
can be used with Google Reviews API to get a full list of reviews
rectangle
object
rectangle parameters
contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP
equals null if calculate_rectangles in the POST request is not set to true
x
float
x-axis coordinate
x-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin
y
float
y-axis coordinate
y-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin
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
additional items present in the element
if there are none, equals null
type
string
type of element = ‘video_element‘
source
string
source of the element
indicates the source of the video
title
string
title of the result in SERP
timestamp
string
date and time when the result was published
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example: 2019-11-15 12:57:46 +00:00
url
string
URL
rectangle
object
rectangle parameters
contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP
equals null if calculate_rectangles in the POST request is not set to true
x
float
x-axis coordinate
x-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin
y
float
y-axis coordinate
y-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin
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
additional items present in the element
if there are none, equals null
type
string
type of element = ‘app_element‘
description
string
description of the results element in SERP
title
string
title of the result in SERP
url
string
URL
price
object
price of the app element
current
float
current price
refers to the current price indicated in the app element
regular
float
regular price
refers to the regular price indicated in the app element
max_value
float
the maximum price
refers to the maximum price indicated in the app element
currency
string
currency of the listed price
ISO code of the currency applied to the price
is_price_range
boolean
price is provided as a range
indicates whether a price is provided in a range
displayed_price
string
price string in the result
raw price string as provided in the result
rectangle
object
rectangle parameters
contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP
equals null if calculate_rectangles in the POST request is not set to true
x
float
x-axis coordinate
x-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin
y
float
y-axis coordinate
y-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin
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
type of element = ‘people_also_ask_expanded_element‘
featured_title
string
title
url
string
relevant URL
domain
string
domain in SERP
title
string
title of the result in SERP
description
string
description of the results element in SERP
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
rectangle
object
rectangle parameters
contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP
equals null if calculate_rectangles in the POST request is not set to true
x
float
x-axis coordinate
x-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin
y
float
y-axis coordinate
y-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin
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
additional items present in the element
if there are none, equals null
type
string
type of element = ‘images_element‘
alt
string
alt tag of the image
url
string
original URL of the image
the URL leading to the image on the original resource
image_url
string
URL to the compressed image
the URL leading to the image on DataForSEO storage
related_image_searches
array
contains keywords and images related to the specified search term
if there are none, equals null
type
string
type of element = ‘related_image_searches_element‘
title
string
title of the element
indicates keyword that may be used with the specified term to refine image search
alt
string
alt tag of the featured image
url
string
original URL of the featured image
the URL leading to the image on the original resource
image_url
string
URL to the compressed featured image
the URL leading to the image on DataForSEO storage
rectangle
object
rectangle parameters
contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP
equals null if calculate_rectangles in the POST request is not set to true
x
float
x-axis coordinate
x-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin
y
float
y-axis coordinate
y-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin
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
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
rectangle
object
rectangle parameters
contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP
equals null if calculate_rectangles in the POST request is not set to true
x
float
x-axis coordinate
x-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin
y
float
y-axis coordinate
y-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin
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
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
author
string
author
job_posted_time
string
the time when the job was posted
timestamp
string
date and time when the result was published
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example: 2019-11-15 12:57:46 +00:00
contract_type
string
contract type
salary
string
salary
url
string
URL
rectangle
object
rectangle parameters
contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP
equals null if calculate_rectangles in the POST request is not set to true
x
float
x-axis coordinate
x-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin
y
float
y-axis coordinate
y-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin
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
additional items present in the element
if there are none, equals null
type
string
type of element = ‘events_element‘
title
string
title of the item
description
string
snippet of the element
url
string
events_element URL
rectangle
object
rectangle parameters
contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP
equals null if calculate_rectangles in the POST request is not set to true
x
float
x-axis coordinate
x-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin
y
float
y-axis coordinate
y-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin
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
additional items present in the element
if there are none, equals null
type
string
type of element = ‘mention_carousel_element‘
title
string
title of the item
price
object
price of the mention carousel element
current
float
current price
indicates the current price of the mention carousel element
regular
float
regular price
indicates the regular price of the mention carousel element
max_value
float
the maximum price
indicates the maximum price of the mention carousel element
currency
string
currency of the listed price
ISO code of the currency applied to the price
is_price_range
boolean
price is provided as a range
indicates whether a price is provided in a range
displayed_price
string
price string in the result
raw price string as provided in the result
rating
object
the item’s rating
the popularity rate based on reviews and displayed in SERP
rating_type
string
the type of rating
here you can find the following elements: Max5, Percents, CustomMax
value
float
the value of the rating
votes_count
integer
the amount of feedback
rating_max
integer
the maximum value for a rating_type
mentioned_in
array
additional elements in the mention_carousel item
type
string
type of element = ‘link_element‘
title
string
title of the item
snippet
string
snippet of the element
URL
string
link_element URL
rectangle
object
rectangle parameters
contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP
equals null if calculate_rectangles in the POST request is not set to true
x
float
x-axis coordinate
x-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin
y
float
y-axis coordinate
y-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin
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
additional items present in the element
if there are none, equals null
type
string
type of element = ‘recipes_element‘
title
string
title of the item
url
string
recipes_element URL
domain
string
domain in SERP
source
string
source of the element
indicates the source of information included in the recipes_element
description
string
snippet of the element
time
string
the total time it takes to prepare the cook the dish
rating
object
the item’s rating
the popularity rate based on reviews and displayed in SERP
rating_type
string
the type of rating
here you can find the following elements: Max5, Percents, CustomMax
value
float
the value of the rating
votes_count
integer
the amount of feedback
rating_max
integer
the maximum value for a rating_type
rectangle
object
rectangle parameters
contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP
equals null if calculate_rectangles in the POST request is not set to true
x
float
x-axis coordinate
x-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin
y
float
y-axis coordinate
y-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin
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
additional items present in the element
if there are none, equals null
type
string
type of element = ‘top_sights_element‘
title
string
title of the item
url
string
top_sights_element URL
description
string
snippet of the element
rating
object
the item’s rating
the popularity rate based on reviews and displayed in SERP
rating_type
string
the type of rating
here you can find the following elements: Max5, Percents, CustomMax
value
float
the value of the rating
votes_count
integer
the amount of feedback
rating_max
integer
the maximum value for a rating_type
rectangle
object
rectangle parameters
contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP
equals null if calculate_rectangles in the POST request is not set to true
x
float
x-axis coordinate
x-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin
y
float
y-axis coordinate
y-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin
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
additional items present in the element
if there are none, equals null
type
string
type of element = ‘scholarly_articles_element‘
title
string
title of the item
url
string
scholarly_articles_element URL
author
string
author
description
string
snippet of the element
rectangle
object
rectangle parameters
contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP
equals null if calculate_rectangles in the POST request is not set to true
x
float
x-axis coordinate
x-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin
y
float
y-axis coordinate
y-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin
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
additional items present in the element
if there are none, equals null
type
string
type of element = ‘popular_products_element‘
title
string
title of the item
description
string
snippet of the element
seller
string
seller of the product
image_url
string
URL of the product’s image
price
object
price of the popular products element
current
float
current price
indicates the current price of the popular products element
regular
float
regular price
indicates the regular price of the popular products element
max_value
float
the maximum price
indicates the maximum price of the popular products element
currency
string
currency of the listed price
ISO code of the currency applied to the price
is_price_range
boolean
price is provided as a range
indicates whether a price is provided in a range
displayed_price
string
price string in the result
raw price string as provided in the result
rating
object
the item’s rating
the popularity rate based on reviews and displayed in SERP
rating_type
string
the type of rating
here you can find the following elements: Max5, Percents, CustomMax
value
float
the value of the rating
votes_count
integer
the amount of feedback
rating_max
integer
the maximum value for a rating_type
rectangle
object
rectangle parameters
contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP
equals null if calculate_rectangles in the POST request is not set to true
x
float
x-axis coordinate
x-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin
y
float
y-axis coordinate
y-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin
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
additional items present in the element
if there are none, equals null
type
string
type of element = ‘podcasts_element‘
title
string
title of the item
url
string
podcasts_element URL
description
string
snippet of the element
timestamp
string
date and time when the episode was added
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example: 2019-11-15 12:57:46 +00:00
time_to_play
string
the total time it will take to play an episode
rectangle
object
rectangle parameters
contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP
equals null if calculate_rectangles in the POST request is not set to true
x
float
x-axis coordinate
x-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin
y
float
y-axis coordinate
y-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin
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
additional items present in the element
if there are none, equals null
type
string
type of element = ‘questions_and_answers_element‘
url
string
questions_and_answers_element URL
question_text
string
question included in the item
answer_text
string
answer included in the item
source
string
source of the element
indicates the source of information included in the questions_and_answers_element
domain
string
domain name of the source
votes
integer
answer upvotes from the source
rectangle
object
rectangle parameters
contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP
equals null if calculate_rectangles in the POST request is not set to true
x
float
x-axis coordinate
x-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin
y
float
y-axis coordinate
y-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin
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
additional items present in the element
if there are none, equals null
type
string
type of element = ‘find_results_on_element‘
title
string
title of the result in SERP
domain
string
domain name of the source
url
string
find_results_on_element URL
source
string
source of the element
indicates the source of information included in the find_results_on_element
rectangle
object
rectangle parameters
contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP
equals null if calculate_rectangles in the POST request is not set to true
x
float
x-axis coordinate
x-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin
y
float
y-axis coordinate
y-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin
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
source of the element
indicates the source of information provided in the stocks_box element
snippet
string
snippet of the element
price
object
price quote featured on Google at the time when our API pulled the results
note that stock prices displayed in the stocks_box element may be delayed according to Google Finance disclaimer
current
float
current price
indicates the current price quote featured on Google at the time when our API pulled the results
regular
float
regular price
indicates the regular price quote featured on Google at the time when our API pulled the results
max_value
float
the maximum price
indicates the maximum price quote featured on Google at the time when our API pulled the results
currency
string
currency of the listed price
ISO code of the currency applied to the price
is_price_range
boolean
price is provided as a range
indicates whether a price is provided in a range
displayed_price
string
price string in the result
raw price string as provided in the result
url
string
relevant URL
domain
string
domain in SERP
rectangle
object
rectangle parameters
contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP
equals null if calculate_rectangles in the POST request is not set to true
x
float
x-axis coordinate
x-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin
y
float
y-axis coordinate
y-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin
width
float
width of the element in pixels
height
float
height of the element in pixels
table
object
results table
if there are none, equals null
table_header
array
column names
if there are none, equals null
table_content
array
the content of the table
additional information about the stock prices displayed below the graph
if there is none, equals null
graph
object
contains data provided in the graph of the element
items
array
data provided for the date and time when our API pulled the results
type
string
type of element = ‘graph_element’
corresponds to one point on the graph that indicates the stock price for a specific date and time
date
string
date and time
in the yyyy-mm-ddThh:mm:ssISO 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:ssISO 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
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
items
array
contains results featured in the visual_stories element of SERP
type
string
type of element = ‘visual_stories_element’
title
string
title of the visual story
url
string
relevant URL
domain
string
domain in SERP
rectangle
object
rectangle parameters
contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP
equals null if calculate_rectangles in the POST request is not set to true
x
float
x-axis coordinate
x-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin
y
float
y-axis coordinate
y-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin
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
items
array
contains results featured in the commercial_units element of SERP
type
string
type of element = ‘commercial_units_element’
title
string
title of the commercial unit
url
string
relevant URL
domain
string
domain in SERP
price
object
price indicated in the element
current
float
current price
indicates the current price of the commercial units element
regular
float
regular price
indicates the regular price of the commercial units element
max_value
float
the maximum price
indicates the maximum price of the commercial units element
currency
string
currency of the listed price
ISO code of the currency applied to the price
is_price_range
boolean
price is provided as a range
indicates whether a price is provided in a range
displayed_price
string
price string in the result
raw price string as provided in the result
source
string
source of the element
rating
object
the item’s rating
the popularity rate based on reviews and displayed in SERP
rating_type
string
the type of rating
here you can find the following elements: Max5, Percents, CustomMax
value
float
the value of the rating
votes_count
integer
the amount of feedback
rating_max
integer
the maximum value for a rating_type
rectangle
object
rectangle parameters
contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP
equals null if calculate_rectangles in the POST request is not set to true
x
float
x-axis coordinate
x-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin
y
float
y-axis coordinate
y-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin
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
domain
string
domain in SERP
items
array
contains results featured in the local_services element of SERP
type
string
type of element = ‘local_services_element’
title
string
title of the local services element
url
string
relevant URL
domain
string
domain in SERP
description
string
description of the local services element
rating
object
the element’s rating
the popularity rate based on reviews and displayed in SERP
rating_type
string
the type of rating
here you can find the following elements: Max5, Percents, CustomMax
value
float
the value of the rating
votes_count
integer
the amount of feedback
rating_max
integer
the maximum value for a rating_type
profile_image_url
string
URL of the image featured in the element
rectangle
object
rectangle parameters
contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP
equals null if calculate_rectangles in the POST request is not set to true
x
float
x-axis coordinate
x-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin
y
float
y-axis coordinate
y-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin
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
unique hotel identifier
unique hotel identifier assigned by Google;
example: "CgoIjaeSlI6CnNpVEAE"
url
string
URL of the element
cid
string
google-defined client id
unique id of a local establishment;
learn more about the identifier in this help center article
example: "5087410620311667698"
rectangle
object
rectangle parameters
contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP
equals null if calculate_rectangles in the POST request is not set to true
x
float
x-axis coordinate
x-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin
y
float
y-axis coordinate
y-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin
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
solution to the equation
solution to the mathematical equation specified in the keyword field when setting a task
items
array
additional items present in the element
if there are none, equals null
type
string
type of element = ‘math_solver_element‘
title
string
title of the item
expanded_element
array
expanded element
type
string
type of element = ‘math_solver_expanded_element‘
title
string
title of the element
solution
array
solution of the element
displays steps to solve the mathematical equation as specified in the element
links
array
links featured in the math_solver element
if there are none, equals null
type
string
type of element = ‘link_element‘
title
string
title of the link element
description
string
description of the link element
url
string
URL
domain
string
domain in SERP
rectangle
object
rectangle parameters
contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP
equals null if calculate_rectangles in the POST request is not set to true
x
float
x-axis coordinate
x-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin
y
float
y-axis coordinate
y-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin
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
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:ssISO 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:ssISO 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
float
x-axis coordinate
x-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin
y
float
y-axis coordinate
y-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin
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
array of course categories
contains a list of categories relevant to courses
items
array
array of courses elements
contains a list of courses elements
type
string
type of element = ‘courses_element’
title
string
name of the course
url
string
URL of the course
domain
string
domain where a link points
source
string
web source of the courses element
indicates the source of information included in the element
description
string
description of the element
date
string
date and time
date and time when the result was published
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
image_url
string
URL of the image
rating
object
the item’s rating
the popularity rate based on reviews and displayed in SERP
rating_type
string
the type of rating
here you can find the following elements: Max5, Percents, CustomMax
value
integer
the value of the rating
votes_count
integer
the amount of feedback
rating_max
integer
the maximum value for a rating_type
rectangle
object
rectangle parameters
contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP
equals null if calculate_rectangles in the POST request is not set to true
x
float
x-axis coordinate
x-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin
y
float
y-axis coordinate
y-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin
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
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
object
product consideration info
contains an answer to the question articulated in the title
type
string
type of element = ‘product_considerations_expanded_element’
title
string
title of the expanded element
featured_title
string
alternative title featured in the element
breadcrumb
string
breadcrumb in SERP
snippet
string
text snippet
domain
string
source domain
url
string
source url
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
rectangle
object
rectangle parameters
contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP
equals null if calculate_rectangles in the POST request is not set to true
x
float
x-axis coordinate
x-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin
y
float
y-axis coordinate
y-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin
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
additional items present in the element
if there are none, equals null
type
string
type of element = ‘short_videos_element‘
title
string
title of the result in SERP
url
string
URL
domain
string
domain in SERP
source
string
source of the element
indicates the source of information included in the top_stories_element
rectangle
object
rectangle parameters
contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP
equals null if calculate_rectangles in the POST request is not set to true
x
float
x-axis coordinate
x-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin
y
float
y-axis coordinate
y-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin
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
additional items present in the element
if there are none, equals null
type
string
type of element = ‘found_on_web_element‘
title
string
title of the result in SERP
subtitle
string
subtitle of the result in SERP
image
object
image of the element
type
string
type of element = ‘images_element‘
alt
string
alt tag of the image
url
string
relevant URL
image_url
string
URL of the image
the URL leading to the image on the original resource or DataForSEO storage (in case the original source is not available)
rectangle
object
rectangle parameters
contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP
equals null if calculate_rectangles in the POST request is not set to true
x
float
x-axis coordinate
x-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin
y
float
y-axis coordinate
y-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin
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
rectangle parameters
contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP
equals null if calculate_rectangles in the POST request is not set to true
x
float
x-axis coordinate
x-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin
y
float
y-axis coordinate
y-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin
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
rectangle parameters
contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP
equals null if calculate_rectangles in the POST request is not set to true
x
float
x-axis coordinate
x-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin
y
float
y-axis coordinate
y-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin
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
additional items present in the element
if there are none, equals null
type
string
type of element = ‘perspectives_element‘
title
string
title of the result in SERP
description
string
description of the result in SERP
url
string
URL
domain
string
domain in SERP
date
string
the date or time when the page source of the element was published
example: 13 hours ago
source
string
source of additional information about the result
timestamp
string
date and time when the result was published
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example: 2019-11-15 12:57:46 +00:00
rectangle
object
rectangle parameters
contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP
equals null if calculate_rectangles in the POST request is not set to true
x
float
x-axis coordinate
x-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin
y
float
y-axis coordinate
y-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin
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
additional items present in the element
if there are none, equals null
type
string
type of element = ‘discussions_and_forums_element‘
title
string
title of the result in SERP
url
string
URL to the source
domain
string
domain in SERP
source
string
source of additional information about the result
description
string
description of the result in SERP
timestamp
string
date and time when the result was published
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example: 2019-11-15 12:57:46 +00:00
posts_count
integer
number of posts from the discussion on the related source
rectangle
object
rectangle parameters
contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP
equals null if calculate_rectangles in the POST request is not set to true
x
float
x-axis coordinate
x-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin
y
float
y-axis coordinate
y-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin
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
additional items present in the element
if there are none, equals null
type
string
type of element = ‘compare_sites_element‘
title
string
title of the result in SERP
url
string
URL to the source
domain
string
domain in SERP
image_url
string
URL to the image
source
string
website name, source of the result
rectangle
object
rectangle parameters
contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP
equals null if calculate_rectangles in the POST request is not set to true
x
float
x-axis coordinate
x-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin
y
float
y-axis coordinate
y-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin
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
indicates whether the element is loaded asynchronically
if true, the ai_overview element is loaded asynchronically;
if false, the ai_overview element is loaded from cache;
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 ai_overview
type
string
type of element = ‘ai_overview_reference‘
source
string
reference source name or title
domain
string
domain name of the reference
url
string
reference page URL
title
string
reference page title
text
string
reference text
text snippet from the page that was used to generate the ai_overview_element
rectangle
object
rectangle parameters
contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP
equals null if calculate_rectangles in the POST request is not set to true
x
float
x-axis coordinate
x-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin
y
float
y-axis coordinate
y-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin