Core APIs
...
Shopping & Products
Reviews *New*
4 min
google product reviews parameters get get /search?search type=product reviews the google product reviews parameters are applicable when making a request with search type=product reviews to retrieve product reviews results for a given product id and gpc id the product id is specified in the product id parameter and the gpc id is specified in the gpc id parameter the request also requires a next page token specified in next page token parameter you should also specify a location parameter to geo locate the request (locations can be retrieved via the https //docs trajectdata com/valueserp/locations api/overview ) google product ids and gpc ids are returned by https //docs trajectdata com/valueserp/search api/results/google/shopping requests products & location google product pages are highly location sensitive so it is important that you specify a location that matches the location that was used to retrieve the product id in the original https //docs trajectdata com/valueserp/search api/searches/google/shopping request to ensure appropriate product details are returned, either location or gl and hl are required for search type=product reviews product reviews pagination product reviews results do not contain a traditional pagination section where a specific page of results is uniquely addressable instead, each search type=product reviews result will return a next page token in its' product results pagination object this next page token can be passed in to the next page token request parameter to retrieve the next page of product reviews results for example, to request product reviews results for the product id 2826726591980094389 and gpc id 2883234210698146338 along with next page token in the location united states , the request would be http https //api valueserp com/search?api key=demo\&search type=product reviews\&product id=2826726591980094389\&gpc id=2883234210698146338\&next page token=etgbctubiswbacdzaxesyiyei1fbgl hygxyyblcbz5frxslbs5vijba834vybmbbdtzu9ckhbktwufdkm6y9gfvrc8ji gyswxmm6p xmjphfdzcoqcx1fnwqfs 1vctnhj6ttdou 4juh 4i zgibceqhr55q09cbdmop6otstveqbkf0suicbckrim1q5p5cfmmmux81qg7l5amtrm 5sqdiwgw7cjzdj1kvmewq5elehn5dpaqblvdt5o2wbjkciesdeer2hlpfy7ylihzkjdgokkojgswg\&location=united+statescurl l get https //api valueserp com/search \\ d api key="demo" \\ d product id="13244508647295616715" \\ d search type="product" \\ d product type="reviews" \\ d location="united+states"const axios = require('axios'); // set up the request parameters const params = { api key "demo", product id "13244508647295616715", search type "product", product type "reviews", location "united+states" } // make the http get request axios get('https //api valueserp com"/search', { params }) then(response => { // print the json response console log(json stringify(response data, 0, 2)); }) catch(error => { // catch and print the error console log(error); })import requests import json \# set up the request parameters params = { 'api key' 'demo', 'product id' '13244508647295616715', 'search type' 'product', 'product type' 'reviews', 'location' 'united+states' } \# make the http get request api result = requests get('https //api valueserp com/search', params) \# print the json response print(json dumps(api result json()))\<?php \# set up the request parameters $querystring = http build query(\[ 'api key' => 'demo', 'product id' => '13244508647295616715', 'search type' => 'product', 'product type' => 'reviews', 'location' => 'united+states' ]); \# make the http get request $ch = curl init(sprintf('%s?%s', 'https //api valueserp com/search', $querystring)); curl setopt($ch, curlopt returntransfer, true); curl setopt($ch, curlopt followlocation, true); \# the following options are required if you're using an outdated openssl version \# more details https //www openssl org/blog/blog/2021/09/13/letsencryptrootcertexpire/ curl setopt($ch, curlopt ssl verifyhost, false); curl setopt($ch, curlopt ssl verifypeer, false); curl setopt($ch, curlopt timeout, 180); $api result = curl exec($ch); curl close($ch); \# print the json response echo $api result; ?> google product reviews parameters the following parameters are available for all requests made when search type=product reviews parameter required description search type required should be set to search type=product reviews product id required the google product id to retrieve google product ids are returned by https //docs trajectdata com/valueserp/search api/results/google/shopping requests gpc id required the google product gpc id to retrieve google product gpc ids are returned by https //docs trajectdata com/valueserp/search api/results/google/shopping requests note for some products like medicines, google shopping page does not return a gpc id in those cases, product reviews requests work by supplying the product id value to both product id and gpc id also, in such cases, both location + gl, hl & domain are required (as opposed to either of those required in products containing a gpc id ) next page token required product reviews results do not contain a traditional pagination section where a specific page of results is uniquely addressable instead, each search type=product reviews result will return a next page token in its' product results pagination object this next page token can be passed in to the next page token request parameter to retrieve the next page of product reviews results the next page token for first page, however, is returned in the product results reviews next page token property of the search type=product details requests and the token for second page onwards in returned in reviews array of search type=product reviews location optional determines the geographic location in which the query is executed you can enter any location as free text, but if you choose one of the value serp https //docs trajectdata com/valueserp/locations api/overview then the google domain , gl and hl parameters are automatically updated to the domain, country and language that match the built in location (note that this behaviour can be disabled via the location auto parameter) note google product requests are highly location sensitive it's important that you set a location parameter for the geographic location in which the product id was found either location or gl and hl are required to get correct product reviews location auto optional if the location field is set to a value serp https //docs trajectdata com/valueserp/locations api/overview from the https //docs trajectdata com/valueserp/locations api/overview , and location auto is set to true (default) then the google domain , gl and hl parameters are automatically updated to the domain, country and language that match the built in location valid values are true (default) to enable this behaviour or false to disable uule optional the google uule parameter use to pass through a custom uule parameter to google value serp automatically generates the uule when you use the location parameter but we allow you to overwrite it directly by specifying a uule directly google domain optional the google domain to use to run the search query view the full list of supported google domain values https //docs trajectdata com/valueserp/search api/reference/google domains defaults to google com gl optional the gl parameter determines the google country to use for the query view the full list of supported gl values https //docs trajectdata com/valueserp/search api/reference/google countries defaults to us note either location or gl and hl are required to get correct product reviews hl optional the hl parameter determines the google ui language to return results view the full list of supported hl values https //docs trajectdata com/valueserp/search api/reference/google languages defaults to en note either location or gl and hl are required to get correct product reviews next steps https //docs trajectdata com/valueserp/search api/results/google/product reviews