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)"
id="09171517-0696-0242-0000-a96bc1ad0bce"
curl --location --request GET "https://api.dataforseo.com/v3/serp/google/lite/task_get/advanced/${id}" \
--header "Authorization: Basic ${cred}" \
--header "Content-Type: application/json" \
--data-raw ''
<?php
// You can download this file from here https://cdn.dataforseo.com/v3/examples/php/php_RestClient.zip
require('RestClient.php');
$api_url = 'https://api.dataforseo.com/';
try {
// Instead of 'login' and 'password' use your credentials from https://app.dataforseo.com/api-access
$client = new RestClient($api_url, null, 'login', 'password');
} catch (RestClientException $e) {
echo "n";
print "HTTP code: {$e->getHttpCode()}n";
print "Error code: {$e->getCode()}n";
print "Message: {$e->getMessage()}n";
print $e->getTraceAsString();
echo "n";
exit();
}
try {
$result = array();
// #1 - using this method you can get a list of completed tasks
// GET /v3/serp/google/lite/tasks_ready
// 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
$tasks_ready = $client->get('/v3/serp/google/lite/tasks_ready');
// you can find the full list of the response codes here https://docs.dataforseo.com/v3/appendix/errors
if (isset($tasks_ready['status_code']) AND $tasks_ready['status_code'] === 20000) {
foreach ($tasks_ready['tasks'] as $task) {
if (isset($task['result'])) {
foreach ($task['result'] as $task_ready) {
// #2 - using this method you can get results of each completed task
// GET /v3/serp/google/lite/task_get/advanced/$id
if (isset($task_ready['endpoint_advanced'])) {
$result[] = $client->get($task_ready['endpoint_advanced']);
}
// #3 - another way to get the task results by id
// GET /v3/serp/google/lite/task_get/advanced/$id
/*
if (isset($task_ready['id'])) {
$result[] = $client->get('/v3/serp/google/lite/task_get/advanced/' . $task_ready['id']);
}
*/
}
}
}
}
print_r($result);
// do something with result
} catch (RestClientException $e) {
echo "n";
print "HTTP code: {$e->getHttpCode()}n";
print "Error code: {$e->getCode()}n";
print "Message: {$e->getMessage()}n";
print $e->getTraceAsString();
echo "n";
}
$client = null;
?>
from client import RestClient
# You can download this file from here https://cdn.dataforseo.com/v3/examples/python/python_Client.zip
client = RestClient("login", "password")
# 1 - using this method you can get a list of completed tasks
# GET /v3/serp/google/lite/tasks_ready
# 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.get("/v3/serp/google/lite/tasks_ready")
# you can find the full list of the response codes here https://docs.dataforseo.com/v3/appendix/errors
if response['status_code'] == 20000:
results = []
for task in response['tasks']:
if (task['result'] and (len(task['result']) > 0)):
for resultTaskInfo in task['result']:
# 2 - using this method you can get results of each completed task
# GET /v3/serp/google/lite/advanced/$id
if(resultTaskInfo['endpoint_advanced']):
results.append(client.get(resultTaskInfo['endpoint_advanced']))
'''
# 3 - another way to get the task results by id
# GET /v3/serp/google/lite/task_get/advanced/$id
if(resultTaskInfo['id']):
results.append(client.get("/v3/serp/google/lite/task_get/advanced/" + resultTaskInfo['id']))
'''
print(results)
# do something with result
else:
print("error. Code: %d Message: %s" % (response["status_code"], response["status_message"]))
using Newtonsoft.Json;
using System;
using System.Collections.Generic;
using System.Net.Http;
using System.Net.Http.Headers;
using System.Text;
using System.Threading.Tasks;
namespace DataForSeoDemos
{
public static partial class Demos
{
public static async Task serp_task_get()
{
var httpClient = new HttpClient
{
BaseAddress = new Uri("https://api.dataforseo.com/"),
// Instead of 'login' and 'password' use your credentials from https://app.dataforseo.com/api-access
DefaultRequestHeaders = { Authorization = new AuthenticationHeaderValue("Basic", Convert.ToBase64String(Encoding.ASCII.GetBytes("login:password"))) }
};
// #1 - using this method you can get a list of completed tasks
// GET /v3/serp/google/lite/tasks_ready
// 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 response = await httpClient.GetAsync("/v3/serp/google/lite/tasks_ready");
var tasksInfo = JsonConvert.DeserializeObject<dynamic>(await response.Content.ReadAsStringAsync());
var tasksResponses = new List<object>();
// you can find the full list of the response codes here https://docs.dataforseo.com/v3/appendix/errors
if (tasksInfo.status_code == 20000)
{
if (tasksInfo.tasks != null)
{
foreach (var tasks in tasksInfo.tasks)
{
if (tasks.result != null)
{
foreach (var task in tasks.result)
{
if (task.endpoint_advanced != null)
{
// #2 - using this method you can get results of each completed task
// GET /v3/serp/google/lite/task_get/advanced/$id
var taskGetResponse = await httpClient.GetAsync((string)task.endpoint_advanced);
var taskResultObj = JsonConvert.DeserializeObject<dynamic>(await taskGetResponse.Content.ReadAsStringAsync());
if (taskResultObj.tasks != null)
{
var fst = taskResultObj.tasks.First;
// you can find the full list of the response codes here https://docs.dataforseo.com/v3/appendix/errors
if (fst.status_code >= 40000 || fst.result == null)
Console.WriteLine($"error. Code: {fst.status_code} Message: {fst.status_message}");
else
tasksResponses.Add(fst.result);
}
// #3 - another way to get the task results by id
// GET /v3/serp/google/lite/task_get/advanced/$id
/*
var tasksGetResponse = await httpClient.GetAsync("/v3/serp/google/lite/task_get/advanced/" + (string)task.id);
var tasksResultObj = JsonConvert.DeserializeObject<dynamic>(await tasksGetResponse.Content.ReadAsStringAsync());
if (tasksResultObj.tasks != null)
{
var fst = taskResultObj.tasks.First;
// you can find the full list of the response codes here https://docs.dataforseo.com/v3/appendix/errors
if (fst.status_code >= 40000 || fst.result == null)
Console.WriteLine($"error. Code: {fst.status_code} Message: {fst.status_message}");
else
tasksResponses.Add(fst.result);
}
*/
}
}
}
}
}
if (tasksResponses.Count > 0)
// do something with result
Console.WriteLine(String.Join(Environment.NewLine, tasksResponses));
else
Console.WriteLine("No completed tasks");
}
else
Console.WriteLine($"error. Code: {tasksInfo.status_code} Message: {tasksInfo.status_message}");
}
}
}
The above command returns JSON structured like this:
task identifier unique task identifier in our system in the UUID format
you will be able to use it within 30 days to request the results of the task at any time
As a response of the API server, you will receive JSON-encoded data containing a tasks array with the information specific to the set tasks.
You can also get all available SERP features by making a request to the following Sandbox URL: https://sandbox.dataforseo.com/v3/serp/google/lite/task_get/advanced/00000000-0000-0000-0000-000000000000
The response will include all available items in the Google Lite SERP advanced endpoint with the fields containing dummy data.
You won’t be charged for using Sandbox endpoints.
Description of the fields in the results array:
Field name
Type
Description
version
string
the current version of the API
status_code
integer
general status code
you can find the full list of the response codes here Note: we strongly recommend designing a necessary system for handling related exceptional or error conditions
status_message
string
general informational message
you can find the full list of general informational messages here
time
string
execution time, seconds
cost
float
total tasks cost, USD
tasks_count
integer
the number of tasks in the tasks array
tasks_error
integer
the number of tasks in the tasks array 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
