This endpoint provides review data on products listed on the Google Shopping marketplace, including top mentioned keywords, review titles, images, ratings, review content, reviewer info, review publication dates, and more. The results are specific to the product_id indicated in the POST request.
We emulate set parameters 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-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="04011058-0696-0199-0000-2196151a15cb"
curl --location --request GET "https://api.dataforseo.com/v3/merchant/google/reviews/task_get/advanced/${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-access
$client = new RestClient($api_url, null, 'login', 'password');
try {
$result = array();
// #1 - using this method you can get a list of completed tasks
// GET /v3/merchant/google/reviews/tasks_ready
$tasks_ready = $client->get('/v3/merchant/google/reviews/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/merchant/google/reviews/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/merchant/google/reviews/task_get/advanced/$id
/*
if (isset($task_ready['id'])) {
$result[] = $client->get('/v3/merchant/google/reviews/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 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")
# get the task results by id
# GET /v3/merchant/google/reviews/task_get/advanced/$id
id = "06141103-2692-0309-1000-980b778b6d25"
response = client.get("/v3/merchant/google/reviews/task_get/advanced/" + id)
# 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 Newtonsoft.Json;
using System;
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 merchant_google_reviews_task_get_by_id()
{
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"))) }
};
// get the task results by id
// GET /v3/merchant/google/reviews/task_get/advanced/$id
// use the task identifier that you recieved upon setting a task
string id = "06141103-2692-0309-1000-980b778b6d25";
var taskGetResponse = await httpClient.GetAsync("/v3/merchant/google/reviews/task_get/advanced/" + id);
var result = JsonConvert.DeserializeObject<dynamic>(await taskGetResponse.Content.ReadAsStringAsync());
if (result.tasks != null)
{
var fst = result.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
// do something with result
Console.WriteLine(String.Join(Environment.NewLine, fst));
}
else
Console.WriteLine($"error. Code: {result.status_code} Message: {result.status_message}");
}
}
}
The above command returns JSON structured like this:
{
"version": "0.1.20231117",
"status_code": 20000,
"status_message": "Ok.",
"time": "0.1668 sec.",
"cost": 0,
"tasks_count": 1,
"tasks_error": 0,
"tasks": [
{
"id": "02051618-1535-0415-0000-15db91a87aa6",
"status_code": 20000,
"status_message": "Ok.",
"time": "0.1101 sec.",
"cost": 0,
"result_count": 1,
"path": [
"v3",
"merchant",
"google",
"reviews",
"task_get",
"advanced",
"02051618-1535-0415-0000-15db91a87aa6"
],
"data": {
"se_type": "reviews",
"api": "merchant",
"function": "reviews",
"se": "google",
"language_code": "en",
"location_code": 2840,
"product_id": "4485466949985702538",
"device": "desktop",
"os": "windows"
},
"result": [
{
"product_id": "4485466949985702538",
"type": "reviews",
"se_domain": "google.com",
"location_code": 2840,
"language_code": "en",
"check_url": "https://www.google.com/shopping/product/4485466949985702538/reviews?hl=en&gl=US&gws_rd=cr&ie=UTF-8&oe=UTF-8&uule=w+CAIQIFISCQs2MuSEtepUEUK33kOSuTsc",
"url": "https://www.google.com/shopping/product/4485466949985702538?hl=en&gl=US&gws_rd=cr&ie=UTF-8&oe=UTF-8&uule=w+CAIQIFISCQs2MuSEtepUEUK33kOSuTsc&prds=pid:14335253671845480120,rsk:PC_6811745323585508222&opi=95576897&sa=U&ved=0ahUKEwjn_sOlspSEAxWOEVkFHevLCRkQyJ0ECAM&usg=AOvVaw1RF28DOhCRZ94Do6PXHmRF",
"datetime": "2024-02-05 14:19:03 +00:00",
"spell": null,
"title": "iPhone Xs - 64GB Space Gray - Verizon - Apple (with installments plan)",
"image_url": "https://encrypted-tbn1.gstatic.com/shopping?q=tbn:ANd9GcTposScZ_220r-1386ZJSTIuEHhc34sEsaSBPsMvs1LVlgqvAkrckSWUA-RecfGfPURWKBFBHh_ZTPkDQuFcrBUkT1ByFVKIVXi06qHO8GO-srTZr1Mw4SX&usqp=CAY",
"rating": {
"type": "rating_element",
"position": "left",
"rating_type": "Max5",
"value": 4.6,
"votes_count": 20051,
"rating_max": 5
},
"rating_groups": [
{
"type": "rating_element",
"position": "left",
"rating_type": "Max5",
"value": 5,
"votes_count": 15352,
"rating_max": 5
},
{
"type": "rating_element",
"position": "left",
"rating_type": "Max5",
"value": 4,
"votes_count": 2687,
"rating_max": 5
},
{
"type": "rating_element",
"position": "left",
"rating_type": "Max5",
"value": 3,
"votes_count": 714,
"rating_max": 5
},
{
"type": "rating_element",
"position": "left",
"rating_type": "Max5",
"value": 2,
"votes_count": 450,
"rating_max": 5
},
{
"type": "rating_element",
"position": "left",
"rating_type": "Max5",
"value": 1,
"votes_count": 848,
"rating_max": 5
}
],
"top_keywords": [
{
"keyword": "Quality camera",
"count": 591
},
{
"keyword": "Easy to use",
"count": 560
},
{
"keyword": "Performs well",
"count": 388
},
{
"keyword": "Long battery life",
"count": 308
},
{
"keyword": "Attractive",
"count": 313
},
{
"keyword": "Durability",
"count": 242
},
{
"keyword": "Large display",
"count": 176
},
{
"keyword": "Easy to set up",
"count": 115
},
{
"keyword": "Comfortable to use",
"count": 111
},
{
"keyword": "Weight",
"count": 118
},
{
"keyword": "Quality display",
"count": 104
},
{
"keyword": "Good sound quality",
"count": 55
},
{
"keyword": "Charges quickly",
"count": 37
},
{
"keyword": "Good call quality",
"count": 21
},
{
"keyword": "Doesn't show dirt",
"count": 1
}
],
"reviews_count": 20051,
"item_types": [
"google_shopping_review_item"
],
"items_count": 10,
"items": [
{
"type": "google_shopping_review_item",
"rank_group": 1,
"rank_absolute": 1,
"position": "left",
"images": null,
"title": null,
"url": "https://www.influenster.com/reviews/apple-iphone-xs-256gb-silver/92445355",
"review_text": "Pros: Stunning Display: The iPhone XS features a beautiful 5.8-inch OLED display with vibrant colors and deep blacks, providing an immersive viewing experience. Excellent Performance: Powered by Apple's A12 Bionic chip and 4GB of RAM, the iPhone XS delivers exceptional performance, handling demanding tasks and graphics-intensive games with ease. Impressive Camera: The dual 12-megapixel rear cameras on the iPhone XS capture stunning photos with excellent detail, dynamic range, and accurate colors. The Smart HDR feature further enhances image quality. Face ID: The Face ID facial recognition technology on the iPhone XS is fast, reliable, and secure, allowing for convenient unlocking of the device and secure authentication for apps and payments. Premium Build Quality: The iPhone XS features a sleek and premium design with a glass back and stainless steel frame, giving it a premium feel in hand. Water and Dust Resistance: With an IP68 rating, the iPhone XS is water and dust resistant, providing peace of mind for everyday usage. Cons: Battery Life: The battery life on the iPhone XS is decent but not exceptional. Heavy usage may require a mid-day recharge to get through the day. Expensive: The iPhone XS is a high-end device with a premium price tag, making it less accessible to budget-conscious consumers. Limited Storage Expandability: The iPhone XS does not support expandable storage, meaning you are limited to the 256GB internal storage and cannot add additional storage via microSD cards. Updates as of September 2021: 4. Aging Hardware: While the iPhone XS can still handle most tasks well, it is now a few years old and may not receive the latest software updates or features as compared to newer iPhone models. Lack of 5G Support: The iPhone XS does not support 5G connectivity, which may be a consideration for users looking for the fastest wireless speeds.",
"provided_by": "influenster.com",
"author": "member-22f2a1",
"publication_date": "2023-07-13 00:00:00 +00:00",
"rating": {
"rating_type": "Max5",
"value": 5,
"votes_count": null,
"rating_max": 5
}
},
{
"type": "google_shopping_review_item",
"rank_group": 2,
"rank_absolute": 2,
"position": "left",
"images": null,
"title": "Great product! But just be aware...",
"url": "http://c1.ugc.bazaarvoice.com/18193-en_ca/15336375/review/245224371/redirect.htm?ctc_referralType=Shopping&ctc_referralDescription=Google",
"review_text": "The phone arrived in pretty near-perfect condition. No noticeable scratches, extremely little wear... it practically looked brand new. Over the last few days it's been fully operational. The battery's capacity was at 87%, but that's fairly reasonable for a used product. My only gripe so far is that the charging cable that came with it felt non-legitimate, but eh, fair enough.
However... be cautious as to which seller is offering the phone. I've seen the sold and shipped section change from Device Care to Lucells. My purchase was from Device Care, not anyone else.
From looking at Device Care's overall reviews, it looks like they'll replace broken screens / batteries them with non-legitimate / non-certified parts. If that's a big deal to you, then you may want to take some caution when deciding if this is a good option.
Just be aware to look into the seller's reviews to get a general consensus first. Would be a hassle for you to get a broken phone and have to send it back.",
"provided_by": "bestbuy.ca",
"author": "Ethan",
"publication_date": "2023-04-06 00:00:00 +00:00",
"rating": {
"rating_type": "Max5",
"value": 5,
"votes_count": null,
"rating_max": 5
}
},
{
"type": "google_shopping_review_item",
"rank_group": 3,
"rank_absolute": 3,
"position": "left",
"images": [
{
"type": "images_element",
"alt": null,
"url": null,
"image_url": "https://encrypted-tbn2.gstatic.com/shopping?q=tbn:ANd9GcTJuT8I36RAYAPtfn46f1SZkkLv1yEx9vPKetQovB5Hg22pI426bo6m0RTaGzdP6IKcGEvcwlxfFy5pErou17OyZhmnw8sPVQ&usqp=CAY"
},
{
"type": "images_element",
"alt": null,
"url": null,
"image_url": "https://encrypted-tbn0.gstatic.com/shopping?q=tbn:ANd9GcRxXQrc2MsiZak63tyWan0O0QuWclhyE714WeUsVj1lgkrfwQRVu5hqADHt_IjnfGQCaGKqKhCs7FROpnOyXi3aVy6UqBS97w&usqp=CAY"
},
{
"type": "images_element",
"alt": null,
"url": null,
"image_url": "https://encrypted-tbn3.gstatic.com/shopping?q=tbn:ANd9GcR2I35SiZkqLsbLDSchvxbh7gQZXbuZ1g3_-aF8OThGE8npTkHiB_06pvpV2srodggIHcAgq-gLpmw7jKj7CQc5i28qPdkh&usqp=CAY"
}
],
"title": null,
"url": "https://www.mydeal.com.au/apple-iphone-xs-256gb-space-grey-as-new-7502338",
"review_text": "Firstly I must say that this is my very first iPhone after deciding to change from Android to Apple. I went for a refurbished phone with the modern shape and look & OLED screen & lots of storage without paying beauty $2,000 for a new model after all it’s a PHONE! Okay. I think this iPhone XS 256gb deserves a 6 star rating . I have no reason to be biased but this is very impressive & in AS NEW condition. Even the dreaded iPhone battery charges to 100% still😁 It’s fast feature rich & is (now) updated to IOS 17.2. It cost around $480 AUD as the best quality available refurbished I went for an Australian company & it took 6 weeks to get the order filled correctly (after returning the original one, of lesser quality) The end result is brilliant but I’d probably go with a well known refurbishment company next time, the prices are almost the same. Love this iPhone.",
"provided_by": "mydeal.com.au",
"author": "David",
"publication_date": "2024-01-18 00:00:00 +00:00",
"rating": {
"rating_type": "Max5",
"value": 5,
"votes_count": null,
"rating_max": 5
}
},
{
"type": "google_shopping_review_item",
"rank_group": 4,
"rank_absolute": 4,
"position": "left",
"images": null,
"title": "In need of a replacement",
"url": "http://c1.ugc.bazaarvoice.com/18193-en_ca/15336375/review/265156421/redirect.htm?ctc_referralType=Shopping&ctc_referralDescription=Google",
"review_text": "The phone arrived on time in near-perfect condition. No scratches, extremely little wear, camera works lovely... it practically looks brand new. No issues with it thus far and over the last few days it's been fully operational. The battery life is above 85% which is very reasonable. I am very satisfied with this phone and provider. Thank you so much!
** Be cautious as to which seller is offering the phone. The sold and shipped section changed from Device Care to Lucells. My purchase was from Device Care as well, not anyone else. Just be aware to look into the seller's reviews to get an overall consensus first. It would be a hassle for you to get a broken phone and have to send it back. **",
"provided_by": "bestbuy.ca",
"author": "Nick",
"publication_date": "2023-12-05 00:00:00 +00:00",
"rating": {
"rating_type": "Max5",
"value": 5,
"votes_count": null,
"rating_max": 5
}
},
{
"type": "google_shopping_review_item",
"rank_group": 5,
"rank_absolute": 5,
"position": "left",
"images": null,
"title": null,
"url": "https://www.influenster.com/reviews/apple-iphone-xs-256gb-silver/93230461",
"review_text": "This iPhone came in excellent condition. No scratches or dings. I ordered the phone on a Friday and it arrived that Tuesday. Phone was unlocked and cleared as promised so set up was easy. There are some minor issues. Battery capacity reads 100%, however, it's not. When the phone gets to 12% or so, it turns itself off with no warning and will not come back on until it gets put on a charger for a bit. This is a bit of an annoying issue but isn't the end of the world, I guess. It's gotten hot a few times to where it starts acting wonky. When hot, it gets slow and the apps start to freeze up and glitch. When the phone cools down (gets restarted as well), it returns back to it's normal functionality. Overall good product for what I paid for it",
"provided_by": "influenster.com",
"author": "nhung.b",
"publication_date": "2023-08-27 00:00:00 +00:00",
"rating": {
"rating_type": "Max5",
"value": 5,
"votes_count": null,
"rating_max": 5
}
},
{
"type": "google_shopping_review_item",
"rank_group": 6,
"rank_absolute": 6,
"position": "left",
"images": null,
"title": null,
"url": "https://www.influenster.com/reviews/apple-iphone-xs-256gb-silver/92043706",
"review_text": "I’ve had this same iPhone for years and I love it! I’m not even sure if they still make or sell it anymore since it’s so old and wasn’t/not so popular. I like the higher size of Gbs too! I did however have have to purchase more iCloud storage since I’ve used it all up. I love the size of it too. I’m not a huge fan of the big phones and how they keep getting bigger and bigger and bigger. I love how this size phone can easily fit into my back pockets, small bags like wristlets, purses, and so on. It’s a perfect fit in my hands too! If they still make this version of iPhones and you want something that’s not not so big, then I highly recommend this Xs iPhone version!",
"provided_by": "influenster.com",
"author": "alexis.k",
"publication_date": "2023-06-13 00:00:00 +00:00",
"rating": {
"rating_type": "Max5",
"value": 4,
"votes_count": null,
"rating_max": 5
}
},
{
"type": "google_shopping_review_item",
"rank_group": 7,
"rank_absolute": 7,
"position": "left",
"images": null,
"title": "Looks great, but……",
"url": "http://c1.ugc.bazaarvoice.com/18193-en_ca/16057869/review/265655878/redirect.htm?ctc_referralType=Shopping&ctc_referralDescription=Google",
"review_text": "Giving the review 2 stars due to the physical quality of the phone. As advertised it was 9/10 cosmetically. What this and I can only assume the rest of the sellers on BB marketplace don’t tell you nor is it indicated in the listing itself is the fact these refurbished phones are most likely trade in’s from plan upgrades. So, as stated they might be data purged etc but the battery is not new and can be as low as 83% health per BB refurb policy (which is very are to find). So beware these are not refurbed to manufacturer standards otherwise they would have 100% battery health. IMO avoid these phones and buy new from apple directly. You always roll the dice when getting a used product.",
"provided_by": "bestbuy.ca",
"author": "Rammer",
"publication_date": "2023-12-11 00:00:00 +00:00",
"rating": {
"rating_type": "Max5",
"value": 2,
"votes_count": null,
"rating_max": 5
}
},
{
"type": "google_shopping_review_item",
"rank_group": 8,
"rank_absolute": 8,
"position": "left",
"images": null,
"title": "Love the phone but the company sucks",
"url": "http://reviews.walmart.com/1336/579558414/review/326217427/redirect.htm",
"review_text": "Honestly, the reviews scared me bc I ordered the phone before I read the reviews… the phone is awesome. I’m writing my review on it rn. However, the shipping was absolutely terrible and I’m really offended as a customer that I spent that much money on this phone for someone to LEAVE IT IN THE RAIN AND NOT NOTIFY ME . I’ve been home all day waiting for this phone and the phone was “delivered” to me by someone THROWING THE BOX into my yard in the rain… the phone box was super beat up and I was scared the phone would be cracked or messed up when I opened the box. Thankfully, the phone is great but the shipping and even the logistics service of Walmart should be ashamed. I love the phone but I will never purchase another phone from Walmart ever again…",
"provided_by": "walmart.com",
"author": "Kristen",
"publication_date": "2023-12-03 00:00:00 +00:00",
"rating": {
"rating_type": "Max5",
"value": 3,
"votes_count": null,
"rating_max": 5
}
},
{
"type": "google_shopping_review_item",
"rank_group": 9,
"rank_absolute": 9,
"position": "left",
"images": null,
"title": "Verizon defective phone and won’t replace it or even give me a better phone",
"url": "http://verizonwireless.ugc.bazaarvoice.com/6543-en_us/dev12720001/review/229467604/redirect.htm?ctc_referralType=Shopping&ctc_referralDescription=Google",
"review_text": "I got this phone from verizon. The phone is defective. It doesn’t get service only Wi-Fi the sound is very low sound like it’s muffled and I just haven’t had a good experience with this phone. I have called Verizon about six times now about this problem that I’m having and nothing has been done. I asked him to send me to the store to get a new one they wouldn’t send me to store but they offered me to take the phone to the store so they can try and fix it. This is unacceptable. I spent $158 on my first months bill and nothing has been done and then when I call, I asked them for a new phone where I upgrade they want me to spend more money to get a replacement or do we get a better phone Verizon need to get the stuff together",
"provided_by": "vzw.com",
"author": null,
"publication_date": "2023-11-14 00:00:00 +00:00",
"rating": {
"rating_type": "Max5",
"value": 1,
"votes_count": null,
"rating_max": 5
}
},
{
"type": "google_shopping_review_item",
"rank_group": 10,
"rank_absolute": 10,
"position": "left",
"images": null,
"title": "A Great Phone!",
"url": "https://www.ebay.com/urw/product-reviews/6023706166",
"review_text": "The iPhone size is perfect for me. The display images are very crisp and text easy to read. Takes great photographs. Very easy to setup. Transferring data from my old iPhone to the iPhone Xs was very simple process. The space gray color was nice too. Also, having 256 GB of storage space was plenty photographs, videos, apps, and documents. One more thing, this iPhone Xs is brand new and came in its original sealed packaging. It included the charging adapter, lightning cable, earphones and documentation.",
"provided_by": "ebay.com",
"author": "speed_demon_1",
"publication_date": "2023-07-19 00:00:00 +00:00",
"rating": {
"rating_type": "Max5",
"value": 5,
"votes_count": null,
"rating_max": 5
}
}
]
}
]
}
]
}
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.
You can also get all available SERP features by making a request to the following Sandbox URL: https://sandbox.dataforseo.com/v3/merchant/google/reviews/task_get/advanced/00000000-0000-0000-0000-000000000000
The response will include all available items in the Google Shopping Reviews 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
product_id
string
product_id received in a POST array
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
title
string
title of the product on Google Shopping
the title of the product for which the reviews are collected
image_url
string
URL to the product image
rating
object
rating of the product on Google Shopping
popularity rate based on reviews and displayed in SERP
type
string
type of element = ‘rating_element’
position
string
the alignment of the element in Google Shopping SERP
can take the following values: left, right
rating_type
string
type of rating
here you can find the following values: Max5
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
rating_groups
array
rating distribution by value (from 1 to 5) and the number of votes of the product on Google Shopping
array of five rating_element objects
rating_element
string
type of element = ‘rating_element’
position
string
the alignment of the element in Google Shopping SERP
can take the following values: left, right
rating_type
string
type of rating
possible values: Max5
value
integer
rating value
possible values: 1, 2, 3, 4, 5
votes_count
integer
the number of votes
rating_max
integer
the maximum value for a rating_type
top_keywords
array
top keywords relevant to the product
top keywords represent certain qualities of the product;
array of objects containing a keyword and the number of reviews mentioning it
keyword
string
keyword that represents a certain product quality
count
string
the number of reviews that contain a keyword
reviews_count
integer
the total number of reviews
item_types
array
type of search results in Google Shopping SERP
contains types of search results (items) found in Google Shopping SERP;
possible item types: google_shopping_review_item
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
product 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_shopping_review_item"
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
images
array
images of the product submitted by the reviewer
type
string
type of element = ‘images_element’
alt
string
alt tag of the image
url
string
relevant URL
image_url
string
URL of the product image featured in the review
title
string
title of the review
url
string
URL to the review
review_text
string
content of the review
provided_by
string
domain where review was published
author
string
nickname of the reviewer
publication_date
string
date and time when the review was published
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”;
example: 2019-11-15 12:57:46 +00:00
rating
object
the rating score submitted by the reviewer
rating_type
string
the type of the rating
can take the following values: Max5
value
float
the value of the rating
votes_count
integer
the amount of feedback
in this case, the value will be null
rating_max
integer
the maximum value for a rating_type
the maximum value for Max5 is 5