JustSERPDocs
Google

Google Product Reviews

What reviewers say about a product, answered as the document: `product` (id, title) and `review_results`, one quote per topic with the reviewer, the site and the age.

GET
/v1/google/product/reviews

What reviewers say about a product, answered as the document: product (id, title) and review_results, one quote per topic with the reviewer, the site and the age. The viewer shows each topic's top quote and no star ratings, histogram or further pages, so rating, sort_by and next_page_token are answered 400 rather than ignored. A product with no insights answers review_results: [].

Authorization

headerX-API-Key<token>

Your API key.

Query Parameters

cancel_token?string

A name you make up for this request (a UUID is fine), so you can later GET /v1/cancel with it. Only you know it, so only you can cancel. Use a new one for every request, retries included: a cancelled token stays cancelled for a few minutes.

Length1 <= length <= 128
product_token*string

The product_token of a google_shopping result.

gl?string

Country, two letters. Default: the token's, else us.

hl?string

Language. Default: the token's, else en.

location?string

The place. Not with uule.

uule?string

Google's own place string. Not with location.

Response Body

The quotes, as the document. When the page could not be parsed, the usual envelope.

application/json
  1. response

The first three keys of every parsed 200 (the answer is the document itself, no success/data envelope): what the search was (search_metadata), what it asked (search_parameters), the parser's own search_information ({} when it has none). The engine's blocks follow, at the same level. An engine whose answer is a list puts it under results.

search_metadata*
search_parameters*

The request's own fields as sent, engine first, without cancel_token.

search_information*

The parser's own, e.g. yelp_search's; otherwise {}.

product?
review_results?array<>
[key: string]?any
Example Request
curl -X GET 'https://api.justserp.com/v1/google/product/reviews?product_token=eyJxIjoi...&gl=us&hl=en'
Example Response
{  "search_metadata": {    "id": "string",    "status": "Success",    "created_at": "string",    "request_url": "string",    "html_url": "string"  },  "search_parameters": {},  "search_information": {},  "product": {    "product_id": "string",    "title": "string"  },  "review_results": [    {      "username": "string",      "source": "string",      "title": "string",      "text": "string",      "date": "string",      "more_reviews": 0    }  ]}