The returned results are specific to the indicated local establishment name, search engine, location and language parameters. We emulate set location and search engine with the highest accuracy so that the results you receive will match the actual search results for the specified parameters at the time of task setting. You can always check the returned results accessing the check_url in the Incognito mode to make sure the received data is entirely relevant. Note that user preferences, search history, and other personalized search factors are ignored by our system and thus would not be reflected in the returned results.
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)"
id="04011058-0696-0199-0000-2196151a15cb"
curl --location --request GET "https://api.dataforseo.com/v3/business_data/google/reviews/task_get/${id}"
--header "Authorization: Basic ${cred}"
--header "Content-Type: application/json"
<?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/';
// Instead of 'login' and 'password' use your credentials from https://app.dataforseo.com/api-dashboard
$client = new RestClient($api_url, null, 'login', 'password');
try {
// get the task results by id
// GET /v3/business_data/google/reviews/task_get/$id
// use the task identifier that you recieved upon setting a task
$id = "05211333-2692-0298-0000-047fc45592ce";
$result = $client->get('/v3/business_data/google/reviews/task_get/' . $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/business_data/google/reviews/tasks_ready
response = client.get("/v3/business_data/google/reviews/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/business_data/google/reviews/task_get/$id
if(resultTaskInfo['endpoint']):
results.append(client.get(resultTaskInfo['endpoint']))
'''
# 3 - another way to get the task results by id
# GET /v3/business_data/google/reviews/task_get/$id
if(resultTaskInfo['id']):
results.append(client.get("/v3/business_data/google/reviews/task_get/" + 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 business_data_google_reviews_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-dashboard
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/business_data/google/reviews/tasks_ready
var response = await httpClient.GetAsync("/v3/business_data/google/reviews/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 != null)
{
// #2 - using this method you can get results of each completed task
// GET /v3/business_data/google/reviews/task_get/$id
var taskGetResponse = await httpClient.GetAsync((string)task.endpoint);
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/business_data/google/reviews/task_get//$id
/*
var tasksGetResponse = await httpClient.GetAsync("/v3/business_data/google/reviews/task_get/" + (string)task.id);
var taskResultObj = JsonConvert.DeserializeObject<<dynamic>>(await tasksGetResponse.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);
}
*/
}
}
}
}
}
if (tasksResponses.Count > 0)
// do something with result
Console.WriteLine(String.Join(Environment.NewLine, tasksResponses));
else
Console.WriteLine("No completed tasks");
}
else
Console.WriteLine($"error. Code: {tasksInfo.status_code} Message: {tasksInfo.status_message}");
}
}
}
The above command returns JSON structured like this:
{
"version": "0.1.20220216",
"status_code": 20000,
"status_message": "Ok.",
"time": "0.0723 sec.",
"cost": 0,
"tasks_count": 1,
"tasks_error": 0,
"tasks": [
{
"id": "03072148-1535-0298-0000-9c41dfc2e576",
"status_code": 20000,
"status_message": "Ok.",
"time": "0.0189 sec.",
"cost": 0,
"result_count": 1,
"path": [
"v3",
"business_data",
"google",
"reviews",
"task_get",
"03072148-1535-0298-0000-9c41dfc2e576"
],
"data": {
"se_type": "reviews",
"se": "google",
"api": "business_data",
"function": "reviews",
"location_name": "London,England,United Kingdom",
"language_name": "English",
"keyword": "hedonism wines",
"depth": 10,
"device": "desktop",
"os": "windows"
},
"result": [
{
"keyword": "hedonism wines",
"type": "google_reviews",
"se_domain": "google.co.uk",
"location_code": 1006886,
"language_code": "en",
"check_url": "https://www.google.co.uk/search?q=hedonism%20wines&num=10&sort=qualityScore&hl=en&gl=GB&gws_rd=cr&ie=UTF-8&oe=UTF-8&uule=w+CAIQIFISCXXeIa8LoNhHEZkq1d1aOpZS",
"datetime": "2022-03-07 19:48:46 +00:00",
"title": "Hedonism Wines",
"sub_title": "3-7 Davies St, London",
"rating": {
"rating_type": "Max5",
"value": 4.8,
"votes_count": null,
"rating_max": 5
},
"feature_id": "0x4876052ce9c2190f:0x4e1505095325804d",
"place_id": "ChIJDxnC6SwFdkgRTYAlUwkFFU4",
"cid": "5626408847077113933",
"reviews_count": 877,
"items_count": 10,
"items": [
{
"type": "google_reviews_search",
"rank_group": 1,
"rank_absolute": 1,
"position": "right",
"xpath": "/div[1]/div[1]/div[2]/div[4]/div[1]/div[2]/div[1]",
"review_text": "Their staff were really helpful as well and actually came out of the shop and offer to help you take photographs.",
"original_review_text": null,
"time_ago": "a month ago",
"timestamp": "2022-02-07 19:48:46 +00:00",
"rating": {
"rating_type": "Max5",
"value": 5,
"votes_count": null,
"rating_max": 5
},
"reviews_count": 447,
"photos_count": 3857,
"local_guide": true,
"profile_name": "na p.",
"profile_url": "https://www.google.com/maps/contrib/110397550682740157102?hl=en-US&sa=X&ved=2ahUKEwi8j4e44rT2AhU6g3IEHVH9D80QvvQBegQIARBF",
"profile_image_url": "https://lh3.googleusercontent.com/a-/AOh14GiJR27Y35FA8Bzf2qwlgfjHpXQhX-7rCRPx1PPH=s40-c-c0x00000000-cc-rp-mo-ba6-br100",
"owner_answer": null,
"original_owner_answer": null,
"owner_time_ago": null,
"owner_timestamp": null
},
{
"type": "google_reviews_search",
"rank_group": 2,
"rank_absolute": 2,
"position": "right",
"xpath": "/div[1]/div[1]/div[2]/div[4]/div[1]/div[2]/div[2]",
"review_text": "A temple to wine where you'll find your special ultra rare and premium bottle for that special occasion or a fine tipple for evening drinks. Worth going in if just to catch the theatre of it. Every time we visited we are greeted with with a unique art display to welcome us. Once in you will see wines available from the every-day to the obscene, and more if you ask the friendly and very knowledgeable staff.\nGreat whites, fizz, spirits and glassware on the ground floor. Down the iron steps you descend into the world of the Domaine de la Romanée-Contis, Rothschilds, Quintarellis, Sine Qua Nons to name but a few, many in Salamanzar, Balthazar, Nebuchanezzar and other biblical (literally) sizes for you to admire in awe (look at the price tags if you dare).\nBut probably the best feature is the row of Enomatic machines with an ever changing range of fine wines for you to sample (at a reasonable cost), which allows you to explore wines that you wouldnt find elsewhere without having to buy a while bottle first. Wanted to try that d'Yquem, Figeac or Sine Qua Non to see what the fuss is about? They've got you covered.",
"original_review_text": null,
"time_ago": "4 months ago",
"timestamp": "2021-11-07 19:48:46 +00:00",
"rating": {
"rating_type": "Max5",
"value": 5,
"votes_count": null,
"rating_max": 5
},
"reviews_count": 40,
"photos_count": 82,
"local_guide": true,
"profile_name": "Dan Ma",
"profile_url": "https://www.google.com/maps/contrib/112822637485884602580?hl=en-US&sa=X&ved=2ahUKEwi8j4e44rT2AhU6g3IEHVH9D80QvvQBegQIARBW",
"profile_image_url": "https://lh3.googleusercontent.com/a-/AOh14GhaukE-S6tTrCuca7_t0tkncZAJaDsbHQYCvOi5LQ=s40-c-c0x00000000-cc-rp-mo-ba5-br100",
"owner_answer": null,
"original_owner_answer": null,
"owner_time_ago": null,
"owner_timestamp": null
},
{
"type": "google_reviews_search",
"rank_group": 3,
"rank_absolute": 3,
"position": "right",
"xpath": "/div[1]/div[1]/div[2]/div[4]/div[1]/div[2]/div[3]",
"review_text": "I have visited many high level wine stores in my life, specially in EUA. It's hard to have proper words to define the experience Hendonism have offered to me. From the core, the variety of wines and champagnes are simply exceptional. Yes, you can find from affordable wines until very high level and expensive ones - depending on the size of your pocket. What I should mention as well is that the wines are not the only incredible attraction here. Their architecture, the very kind staff and amazing decorations transform your visiting in a unbeatable experience. So, if you enjoy different wines, nice hanging, and different high level experiences, please its mandatory to visit this store.",
"original_review_text": null,
"time_ago": "6 months ago",
"timestamp": "2021-09-07 19:48:46 +00:00",
"rating": {
"rating_type": "Max5",
"value": 5,
"votes_count": null,
"rating_max": 5
},
"reviews_count": 130,
"photos_count": 1476,
"local_guide": true,
"profile_name": "Rubens Cury",
"profile_url": "https://www.google.com/maps/contrib/103889894448456747782?hl=en-US&sa=X&ved=2ahUKEwi8j4e44rT2AhU6g3IEHVH9D80QvvQBegQIARBo",
"profile_image_url": "https://lh3.googleusercontent.com/a-/AOh14Ghkdbh4uaLAkY5hCkTXPa_M46iosdVtyMYfUWvZI9A=s40-c-c0x00000000-cc-rp-mo-ba6-br100",
"owner_answer": null,
"original_owner_answer": null,
"owner_time_ago": null,
"owner_timestamp": null
},
{
"type": "google_reviews_search",
"rank_group": 4,
"rank_absolute": 4,
"position": "right",
"xpath": "/div[1]/div[1]/div[2]/div[4]/div[1]/div[2]/div[4]",
"review_text": "After the many times I have been inside this beautiful wine paradise, it is time for me to share my experience. The store is a must visit for anybody having an interest in wine, the decoration is just superb and they have such an amazing variety you will never want to try the same bottle twice.\nThe staff is super friendly and super helpful. Although every single employee makes you feel very welcome, I would like to mention these three guys who have made my experience always fantastic.\nOliver: super friendly and energetic Hungarian guy he has given me really amazing recommendations. He will spend hours discussing what are the most suitable options for you.\nTom: he is really polite and knowledgeable, answered my most nonsense questions and helped me with my first ever purchase in the store.\nJames H. : Helped me with my Rosé. He was very patient answering my 1000 questions I had about wine. You can see he has a big passion for the industry and let me with some really nice recommendations.\nHedonism has literally become my second house, showing up every second week. So is not only the place that makes you want to return but the people who works there, in their very charming way they will always make you come for more.",
"original_review_text": null,
"time_ago": "a year ago",
"timestamp": "2021-03-07 19:48:46 +00:00",
"rating": {
"rating_type": "Max5",
"value": 5,
"votes_count": null,
"rating_max": 5
},
"reviews_count": 6,
"photos_count": 10,
"local_guide": false,
"profile_name": "isabel Rey-joly",
"profile_url": "https://www.google.com/maps/contrib/103418445528667943173?hl=en-US&sa=X&ved=2ahUKEwi8j4e44rT2AhU6g3IEHVH9D80QvvQBegQIARB7",
"profile_image_url": "https://lh3.googleusercontent.com/a-/AOh14Gjd7uc6usiVwwLfT2FC4jZHrycQn5Tcc0Yzb1thOQ=s40-c-c0x00000000-cc-rp-mo-br100",
"owner_answer": null,
"original_owner_answer": null,
"owner_time_ago": null,
"owner_timestamp": null
},
{
"type": "google_reviews_search",
"rank_group": 5,
"rank_absolute": 5,
"position": "right",
"xpath": "/div[1]/div[1]/div[2]/div[4]/div[1]/div[2]/div[5]",
"review_text": "A seriously extensive range of wine and other alcohol! Spread over two floors with a beautiful interior with little nooks in the wine cellar that illuminate when entering.\nThe staff are super pleasant and are willing to help anyone with a question! I’ve purchased a few items from here and each time I’ve left with something truly fantastic.\nFor the location and expertise this place is very well priced and located in a great area of London.\nThey also do really cool window/shop displays all year round which are worth visiting in its self.\nGo and have a visit!",
"original_review_text": null,
"time_ago": "a year ago",
"timestamp": "2021-03-07 19:48:46 +00:00",
"rating": {
"rating_type": "Max5",
"value": 5,
"votes_count": null,
"rating_max": 5
},
"reviews_count": 212,
"photos_count": 1847,
"local_guide": false,
"profile_name": "Aaron Ghastkill",
"profile_url": "https://www.google.com/maps/contrib/111282053100911487339?hl=en-US&sa=X&ved=2ahUKEwi8j4e44rT2AhU6g3IEHVH9D80QvvQBegUIARCMAQ",
"profile_image_url": "https://lh3.googleusercontent.com/a-/AOh14Gju1lqicmeOfVasG2zpIZPtnO_UwU1aD946O6mbbQ=s40-c-c0x00000000-cc-rp-mo-br100",
"owner_answer": null,
"original_owner_answer": null,
"owner_time_ago": null,
"owner_timestamp": null
},
{
"type": "google_reviews_search",
"rank_group": 6,
"rank_absolute": 6,
"position": "right",
"xpath": "/div[1]/div[1]/div[2]/div[4]/div[1]/div[2]/div[6]",
"review_text": "Quality and expertise have of course a price. I order frequently online, till now have no problems and the delivery is fast. Nothing short of 5 stars. Many thanks to Charikleia for her top service and consultation, I am looking forward to visiting the boutique when I am in London!",
"original_review_text": null,
"time_ago": "2 months ago",
"timestamp": "2022-01-07 19:48:46 +00:00",
"rating": {
"rating_type": "Max5",
"value": 5,
"votes_count": null,
"rating_max": 5
},
"reviews_count": 20,
"photos_count": 1,
"local_guide": true,
"profile_name": "Nikolaos Mavromatis",
"profile_url": "https://www.google.com/maps/contrib/101686730279233872358?hl=en-US&sa=X&ved=2ahUKEwi8j4e44rT2AhU6g3IEHVH9D80QvvQBegUIARCiAQ",
"profile_image_url": "https://lh3.googleusercontent.com/a-/AOh14GgdiVhUDnRHyf4ZF2L5ZW_NVSdTQLsMQaQ2Qut36g=s40-c-c0x00000000-cc-rp-mo-ba3-br100",
"owner_answer": null,
"original_owner_answer": null,
"owner_time_ago": null,
"owner_timestamp": null
},
{
"type": "google_reviews_search",
"rank_group": 7,
"rank_absolute": 7,
"position": "right",
"xpath": "/div[1]/div[1]/div[2]/div[4]/div[1]/div[2]/div[7]",
"review_text": "I recommend this exit to everyone through the Hedonism Wines shop, Scotch whiskey, an incredible aroma...🤙👁️🥃⚓🎨🖼️🎻",
"original_review_text": null,
"time_ago": "a month ago",
"timestamp": "2022-02-07 19:48:46 +00:00",
"rating": {
"rating_type": "Max5",
"value": 5,
"votes_count": null,
"rating_max": 5
},
"reviews_count": 8,
"photos_count": 21,
"local_guide": false,
"profile_name": "Dmitriy Afanasiev",
"profile_url": "https://www.google.com/maps/contrib/108095039253712175738?hl=en-US&sa=X&ved=2ahUKEwi8j4e44rT2AhU6g3IEHVH9D80QvvQBegUIARCtAQ",
"profile_image_url": "https://lh3.googleusercontent.com/a-/AOh14GhGpRmaf1TG5h2G-CVZAR_RRHSj6tyqyvXbh9Az=s40-c-c0x00000000-cc-rp-mo-br100",
"owner_answer": null,
"original_owner_answer": null,
"owner_time_ago": null,
"owner_timestamp": null
},
{
"type": "google_reviews_search",
"rank_group": 8,
"rank_absolute": 8,
"position": "right",
"xpath": "/div[1]/div[1]/div[2]/div[4]/div[1]/div[2]/div[8]",
"review_text": "I can’t believe I stumbled across this place once and now I have some where to go for great wines and whiskey… they have a massive collection of spirts, and the staff are always around to help out. I will definitely be returning",
"original_review_text": null,
"time_ago": "a month ago",
"timestamp": "2022-02-07 19:48:46 +00:00",
"rating": {
"rating_type": "Max5",
"value": 5,
"votes_count": null,
"rating_max": 5
},
"reviews_count": 2,
"photos_count": null,
"local_guide": false,
"profile_name": "Rachael Kersey",
"profile_url": "https://www.google.com/maps/contrib/112361837437762206097?hl=en-US&sa=X&ved=2ahUKEwi8j4e44rT2AhU6g3IEHVH9D80QvvQBegUIARC6AQ",
"profile_image_url": "https://lh3.googleusercontent.com/a-/AOh14GiKoCZBKmtNSxO6pj7uQB13E0bHaZzhmkjQMV75tg=s40-c-c0x00000000-cc-rp-mo-br100",
"owner_answer": null,
"original_owner_answer": null,
"owner_time_ago": null,
"owner_timestamp": null
},
{
"type": "google_reviews_search",
"rank_group": 9,
"rank_absolute": 9,
"position": "right",
"xpath": "/div[1]/div[1]/div[2]/div[4]/div[1]/div[2]/div[9]",
"review_text": "Amazing staff and fantastic collection of spirits, wines and champagne!",
"original_review_text": null,
"time_ago": "2 months ago",
"timestamp": "2022-01-07 19:48:46 +00:00",
"rating": {
"rating_type": "Max5",
"value": 5,
"votes_count": null,
"rating_max": 5
},
"reviews_count": 21,
"photos_count": 6,
"local_guide": true,
"profile_name": "Vlad Hudges",
"profile_url": "https://www.google.com/maps/contrib/109828475292354440876?hl=en-US&sa=X&ved=2ahUKEwi8j4e44rT2AhU6g3IEHVH9D80QvvQBegUIARDFAQ",
"profile_image_url": "https://lh3.googleusercontent.com/a-/AOh14GhZ0fFD6Bs7pG1pMcC31yamyjvkOc3_vZCOstFdWg=s40-c-c0x00000000-cc-rp-mo-ba2-br100",
"owner_answer": null,
"original_owner_answer": null,
"owner_time_ago": null,
"owner_timestamp": null
},
{
"type": "google_reviews_search",
"rank_group": 10,
"rank_absolute": 10,
"position": "right",
"xpath": "/div[1]/div[1]/div[2]/div[4]/div[1]/div[2]/div[10]",
"review_text": "Best wine shop in London. Amazing selection and the atmosphere of the store is unreal. Plus the staff are very attentive.",
"original_review_text": null,
"time_ago": "a month ago",
"timestamp": "2022-02-07 19:48:46 +00:00",
"rating": {
"rating_type": "Max5",
"value": 5,
"votes_count": null,
"rating_max": 5
},
"reviews_count": 62,
"photos_count": 89,
"local_guide": true,
"profile_name": "Diego Zamorano",
"profile_url": "https://www.google.com/maps/contrib/109127697052844428117?hl=en-US&sa=X&ved=2ahUKEwi8j4e44rT2AhU6g3IEHVH9D80QvvQBegUIARDSAQ",
"profile_image_url": "https://lh3.googleusercontent.com/a-/AOh14GjnLwgQRhxKTrM78wQPm61FUKJ6vjtvMpypwCtO_pc=s40-c-c0x00000000-cc-rp-mo-ba4-br100",
"owner_answer": null,
"original_owner_answer": null,
"owner_time_ago": null,
"owner_timestamp": null
}
]
}
]
}
]
}
Description of the fields for sending a request:
Field name
Type
Description
id
string
task identifier unique task identifier in our system in the UUID format
you will be able to use it within 30 days to request the results of the task at any time
As a response of the API server, you will receive JSON-encoded data containing a tasks array with the information specific to the set tasks.
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
title
string
title of the ‘reviews’ element in SERP
the name of the local establishment for which the reviews are collected
sub_title
string
subtitle of the ‘reviews’ element in SERP
additional information (e.g., address) on the ‘reviews’ element for which the reviews are collected
rating
object
rating of the corresponding local establishment
popularity rate based on reviews and displayed in SERP
rating_type
string
type of rating
here you can find the following elements: Max5, Percents, CustomMax
value
float
the average rating based on all reviews
votes_count
integer
the number of votes
rating_max
integer
the maximum value for a rating_type
feature_id
string
the unique identifier of the ‘reviews’ element in SERP
learn more about the identifier in this help center article
place_id
string
unique identifier of a business location assigned by Google
learn more about the identifier in this help center article
cid
string
google-defined client id
unique id of a local establishment
learn more about the identifier in this help center article
reviews_count
integer
the total number of reviews
items_count
integer
the number of reviews items in the results array
you can get more results by using the depth parameter when setting a task
items
array
found reviews
you can get more results by using the depth parameter when setting a task
type
string
the review’s type
possible review types: "google_reviews_search"
rank_group
integer
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 among all the listed reviews
absolute position among all reviews on the list
position
string
the alignment of the review in SERP
can take the following values: right
