Google Lite SERP API provides top 100 search engine results by default. This endpoint retrieves core SERP data without extra features, allowing for fast and bulk data retrieval. The results are specific to the selected location (see the List of Locations) and language (see the List of Languages) settings.
Note: the Google Lite search engine consistently returns organic items in SERPs. However, other item types described in documentation may also occasionally appear in search results.
Instead of ‘login’ and ‘password’ use your credentials from https://app.dataforseo.com/api-access
# Instead of 'login' and 'password' use your credentials from https://app.dataforseo.com/api-access
login="login"
password="password"
cred="$(printf ${login}:${password} | base64)"
curl --location --request POST "https://api.dataforseo.com/v3/serp/google/lite/live/advanced" \
--header "Authorization: Basic ${cred}" \
--header "Content-Type: application/json" \
--data-raw '[
{
"language_code": "en",
"location_code": 2840,
"keyword": "albert einstein"
}
]'
<?php
// You can download this file from here https://cdn.dataforseo.com/v3/examples/php/php_RestClient.zip
require('RestClient.php');
$api_url = 'https://api.dataforseo.com/';
try {
// Instead of 'login' and 'password' use your credentials from https://app.dataforseo.com/api-access
$client = new RestClient($api_url, null, 'login', 'password');
} catch (RestClientException $e) {
echo "n";
print "HTTP code: {$e->getHttpCode()}n";
print "Error code: {$e->getCode()}n";
print "Message: {$e->getMessage()}n";
print $e->getTraceAsString();
echo "n";
exit();
}
$post_array = array();
// You can set only one task at a time
$post_array[] = array(
"language_code" => "en",
"location_code" => 2840,
"keyword" => mb_convert_encoding("albert einstein", "UTF-8")
);
try {
// POST /v3/serp/google/lite/live/advanced
// in addition to 'google' and 'lite' 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/google/lite/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"
)
# POST /v3/serp/google/lite/live/advanced
# in addition to 'google' and 'lite' 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/google/lite/live/advanced", post_data)
# you can find the full list of the response codes here https://docs.dataforseo.com/v3/appendix/errors
if response["status_code"] == 20000:
print(response)
# do something with result
else:
print("error. Code: %d Message: %s" % (response["status_code"], response["status_message"]))
using Newtonsoft.Json;
using System;
using System.Collections.Generic;
using System.Net.Http;
using System.Threading.Tasks;
namespace DataForSeoDemos
{
public static partial class Demos
{
public static async Task serp_live_advanced()
{
var httpClient = new HttpClient
{
BaseAddress = new Uri("https://api.dataforseo.com/"),
// Instead of 'login' and 'password' use your credentials from https://app.dataforseo.com/api-access
//DefaultRequestHeaders = { Authorization = new AuthenticationHeaderValue("Basic", Convert.ToBase64String(Encoding.ASCII.GetBytes("login:password"))) }
};
var postData = new List<object>();
// You can set only one task at a time
postData.Add(new
{
language_code = "en",
location_code = 2840,
keyword = "albert einstein"
});
// POST /v3/serp/google/lite/live/advanced
// in addition to 'google' and 'lite' 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/google/lite/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). The task setting is done using the POST method. 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
priority
integer
task priority
optional field
can take the following values:
1 – normal execution priority (set by default);
2 – high execution priority
depth
integer
parsing depth
optional field
number of results in SERP default value: 100
max value: 700
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/google/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/google/locations
example: 2840
location_coordinate
string
GPS coordinates of a location required field if you don’t specifylocation_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 required field if you don’t specifylanguage_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/google/languages
example: English
language_code
string
search engine language code required field if you don’t specifylanguage_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/google/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
calculate_rectangles
boolean
calcualte pixel rankings for SERP elements in advanced results
optional field
pixel ranking refers to the distance between the result snippet and top left corner of the screen; Visit Help Center to learn more>>
by default, the parameter is set to false Note: you will be charged extra $0.0006 for using this parameter
browser_screen_width
integer
browser screen width
optional field
you can set a custom browser screen width to calculate pixel rankings for a particular device;
by default, the parameter is set to: 1920 for desktop; 360 for mobile on android; 375 for mobile on iOS; Note: to use this parameter, set calculate_rectangles to true
browser_screen_height
integer
browser screen height
optional field
you can set a custom browser screen height to calculate pixel rankings for a particular device;
by default, the parameter is set to: 1080 for desktop; 640 for mobile on android; 812 for mobile on iOS; Note: to use this parameter, set calculate_rectangles to true
browser_screen_resolution_ratio
integer
browser screen resolution ratio
optional field
you can set a custom browser screen resolution ratio to calculate pixel rankings for a particular device;
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
remove specific parameters from URLs
optional field
using this field, you can specify up to 10 parameters to remove from URLs in the result
example: "remove_from_url": ["srsltid"]
tag
string
user-defined task identifier
optional field the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response
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 that were returned 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 keyword is returned with decoded %## (plus symbol ‘+’ will be decoded to a space character)
type
string
search engine type in a POST array
se_domain
string
search engine domain in a POST array
location_code
integer
location code in a POST array
language_code
string
language code in a POST array
check_url
string
direct URL to search engine results
you can use it to make sure that we provided accurate results
datetime
string
date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example: 2019-11-15 12:57:46 +00:00
spell
object
autocorrection of the search engine
if the search engine provided results for a keyword that was corrected, we will specify the keyword corrected by the search engine and the type of autocorrection
keyword
string
keyword obtained as a result of search engine autocorrection
the results will be provided for the corrected keyword
type
string
type of autocorrection
possible values: did_you_mean, showing_results_for, no_results_found_for, including_results_for note: Yahoo supports only the following autocorrection type: including_results_for
types of search results found in SERP
contains types of all search results (items) found in the returned SERP
possible item types: organic, paid, local_services, commercial_units, people_also_search, images, shopping, popular_products, local_pack, hotels_pack
se_results_count
integer
total number of results in SERP
pages_count
integer
total search results pages retrieved
total number of retrieved SERPs in the result
group rank in SERP
position within a group of elements with identical type values
positions of elements with different type values are omitted from rank_group
rank_absolute
integer
absolute rank in SERP
absolute position among all the elements in SERP
page
integer
search results page number
indicates the number of the SERP page on which the element is located
position
string
the alignment of the element in SERP
can take the following values: left, right
URL to a similar search
URL to a new search for the same keyword(s) on related sites
breadcrumb
string
breadcrumb in SERP
website_name
string
name of the website in SERP
is_image
boolean
indicates whether the element contains an image
is_video
boolean
indicates whether the element contains a video
is_featured_snippet
boolean
indicates whether the element is a featured_snippet
is_malicious
boolean
indicates whether the element is marked as malicious
is_web_story
boolean
indicates whether the element is marked as Google web story
description
string
description of the results element in SERP
pre_snippet
string
includes additional information appended before the result description in SERP
extended_snippet
string
includes additional information appended after the result description in SERP
images
array
images of the element
type
string
type of element = ‘images_element‘
alt
string
alt tag of the image
url
string
relevant URL
image_url
string
URL of the image
the URL leading to the image on the original resource or DataForSEO storage (in case the original source is not available)
amp_version
boolean
Accelerated Mobile Pages
indicates whether an item has the Accelerated Mobile Page (AMP) version
rating
object
the item’s rating
the popularity rate based on reviews and displayed in SERP
rating_type
string
the type of rating
here you can find the following elements: Max5, Percents, CustomMax
value
float
the value of the rating
votes_count
integer
the amount of feedback
rating_max
integer
the maximum value for a rating_type
price
object
pricing details
contains the pricing details of the product or service featured in the result
current
float
current price
indicates the current price of the product or service featured in the result
regular
float
regular price
indicates the regular price of the product or service with no discounts applied
max_value
float
the maximum price
the maximum price of the product or service as indicated in the result
currency
string
currency of the listed price
ISO code of the currency applied to the price
is_price_range
boolean
price is provided as a range
indicates whether a price is provided in a range
displayed_price
string
price string in the result
raw price string as provided in the result
highlighted
array
words highlighted in bold within the results description
links
array
sitelinks
the links shown below some of Google’s search results
if there are none, equals null
type
string
type of element = ‘link_element‘
title
string
title of the result in SERP
description
string
description of the results element in SERP
url
string
sitelink URL
domain
string
domain in SERP
faq
object
frequently asked questions
questions and answers extension shown below some of Google’s search results
if there are none, equals null
type
string
type of element = ‘faq_box‘
items
array
items featured in the faq_box
type
string
type of element = ‘faq_box_element‘
title
string
question related to the result
description
string
answer provided in the drop-down block
links
array
links featured in the faq_box_element
type
string
type of element = ‘link_element‘
title
string
link anchor text
url
string
link URL
domain
string
domain in SERP
extended_people_also_search
array
extension of the organic element
extension of the organic result containing related search queries Note: extension appears in SERP upon clicking on the result and then bouncing back to search results
about_this_result
object
contains information from the ‘About this result’ panel ‘About this result’ panel provides additional context about why Google returned this result for the given query;
this feature appears after clicking on the three dots next to most results
type
string
type of element = ‘about_this_result_element‘
url
string
result’s URL
source
string
source of additional information about the result
source_info
string
additional information about the result
description of the website from Wikipedia or another additional context
source_url
string
URL to full information from the source
language
string
the language of the result
location
string
location for which the result is relevant
search_terms
array
matching search terms that appear in the result
related_terms
array
related search terms that appear in the result
related_result
array
related result from the same domain
related result from the same domain appears as a part of the main result snippet;
you can derive the related_result snippets as "type": "organic" results by setting the group_organic_results parameter to false in the POST request
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
page
integer
search results page number
indicates the number of the SERP page on which the element is located
position
string
the alignment of the element in SERP
can take the following values: left, right
URL of the image
the URL leading to the image on the original resource or DataForSEO storage (in case the original source is not available)
highlighted
array
words highlighted in bold within the results description
extra
object
additional information about the result
ad_aclk
string
the identifier of the ad
description
string
description of the results element in SERP
description_rows
array
extended description
if there is none, equals null
links
array
sitelinks
the links shown below some of Google’s search results
if there are none, equals null
type
string
type of element = ‘link_element‘
title
string
title of the link element
description
string
description of the results element in SERP
url
string
URL link
domain
string
domain in SERP
ad_aclk
string
the identifier of the ad
price
object
pricing details
contains the pricing details of the product or service featured in the result
current
float
current price
indicates the current price of the product or service featured in the result
regular
float
regular price
indicates the regular price of the product or service with no discounts applied
max_value
float
the maximum price
the maximum price of the product or service as indicated in the result
currency
string
currency of the listed price
ISO code of the currency applied to the price
is_price_range
boolean
price is provided as a range
indicates whether a price is provided in a range
displayed_price
string
price string in the result
raw price string as provided in the result
rating
object
the element’s rating
the popularity rate based on reviews and displayed in SERP
rating_type
string
the type of rating
here you can find the following elements: Max5, Percents, CustomMax
value
float
the value of the rating
votes_count
integer
the amount of feedback
rating_max
integer
the maximum value for a rating_type
rectangle
object
rectangle parameters
contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP
equals null if calculate_rectangles in the POST request is not set to true
x
float
x-axis coordinate
x-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin
y
float
y-axis coordinate
y-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin
group rank in SERP
position within a group of elements with identical type values
positions of elements with different type values are omitted from rank_group
rank_absolute
integer
absolute rank in SERP
absolute position among all the elements in SERP
page
integer
search results page number
indicates the number of the SERP page on which the element is located
position
string
the alignment of the element in SERP
can take the following values: left, right
domain
string
domain in SERP
items
array
contains results featured in the local_services element of SERP
type
string
type of element = ‘local_services_element’
title
string
title of the local services element
url
string
relevant URL
domain
string
domain in SERP
description
string
description of the local services element
rating
object
the element’s rating
the popularity rate based on reviews and displayed in SERP
rating_type
string
the type of rating
here you can find the following elements: Max5, Percents, CustomMax
value
float
the value of the rating
votes_count
integer
the amount of feedback
rating_max
integer
the maximum value for a rating_type
profile_image_url
string
URL of the image featured in the element
rectangle
object
rectangle parameters
contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP
equals null if calculate_rectangles in the POST request is not set to true
x
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
page
integer
search results page number
indicates the number of the SERP page on which the element is located
position
string
the alignment of the element in SERP
can take the following values: left, right
items
array
contains results featured in the commercial_units element of SERP
type
string
type of element = ‘commercial_units_element’
title
string
title of the commercial unit
url
string
relevant URL
domain
string
domain in SERP
price
object
price indicated in the element
current
float
current price
indicates the current price of the commercial units element
regular
float
regular price
indicates the regular price of the commercial units element
max_value
float
the maximum price
indicates the maximum price of the commercial units element
currency
string
currency of the listed price
ISO code of the currency applied to the price
is_price_range
boolean
price is provided as a range
indicates whether a price is provided in a range
displayed_price
string
price string in the result
raw price string as provided in the result
source
string
source of the element
rating
object
the item’s rating
the popularity rate based on reviews and displayed in SERP
rating_type
string
the type of rating
here you can find the following elements: Max5, Percents, CustomMax
value
float
the value of the rating
votes_count
integer
the amount of feedback
rating_max
integer
the maximum value for a rating_type
rectangle
object
rectangle parameters
contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP
equals null if calculate_rectangles in the POST request is not set to true
x
float
x-axis coordinate
x-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin
y
float
y-axis coordinate
y-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin
group rank in SERP
position within a group of elements with identical type values
positions of elements with different type values are omitted from rank_group
rank_absolute
integer
absolute rank in SERP
absolute position among all the elements in SERP
page
integer
search results page number
indicates the number of the SERP page on which the element is located
position
string
the alignment of the element in SERP
can take the following values: left, right
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
page
integer
search results page number
indicates the number of the SERP page on which the element is located
position
string
the alignment of the element in SERP
can take the following values: left, right
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
page
integer
search results page number
indicates the number of the SERP page on which the element is located
position
string
the alignment of the element in SERP
can take the following values: left, right
additional items present in the element
if there are none, equals null
type
string
type of element = ‘shopping_element‘
title
string
title of the result in SERP
price
object
price of the shopping element
current
float
current price
indicates the current price of the shopping element
regular
float
regular price
indicates the regular price of the shopping element
max_value
float
the maximum price
indicates the maximum price of the shopping element
currency
string
currency of the listed price
ISO code of the currency applied to the price
is_price_range
boolean
price is provided as a range
indicates whether a price is provided in a range
displayed_price
string
price string in the result
raw price string as provided in the result
source
string
source of the element
indicates the source of information included in the shopping_element
description
string
the description of the results element in SERP
marketplace
string
merchant account provider
commerce site that hosts products or websites of individual sellers under the same merchant account
example: by Google
marketplace_url
string
relevant marketplace URL
URL of the page on the marketplace website where the product is hosted
url
string
URL
rating
object
the element’s rating
the popularity rate based on reviews and displayed in SERP
rating_type
string
the type of rating
here you can find the following elements: Max5, Percents, CustomMax
value
float
the value of the rating
votes_count
integer
the amount of feedback
rating_max
integer
the maximum value for a rating_type
rectangle
object
rectangle parameters
contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP
equals null if calculate_rectangles in the POST request is not set to true
x
float
x-axis coordinate
x-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin
y
float
y-axis coordinate
y-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin
group rank in SERP
position within a group of elements with identical type values
positions of elements with different type values are omitted from rank_group
rank_absolute
integer
absolute rank in SERP
absolute position among all the elements in SERP
page
integer
search results page number
indicates the number of the SERP page on which the element is located
position
string
the alignment of the element in SERP
can take the following values: left, right
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
page
integer
search results page number
indicates the number of the SERP page on which the element is located
position
string
the alignment of the element in SERP
can take the following values: left, right
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
page
integer
search results page number
indicates the number of the SERP page on which the element is located
position
string
the alignment of the element in SERP
can take the following values: left, right
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
