JustSERPDocs
Google

Google Product

One product from Google Shopping, answered as the document: `search_metadata`, `search_parameters`, `search_information`, `product` (title, brand, description, up to 12 pictures), `offers` (the first buying options), `specifications` and `review_results` (one reviewer quote per topic).

GET
/v1/google/product

One product from Google Shopping, answered as the document: search_metadata, search_parameters, search_information, product (title, brand, description, up to 12 pictures), offers (the first buying options), specifications and review_results (one reviewer quote per topic). Takes the product_token of a google_shopping result. Not answered, because the viewer does not show them: the product's overall rating and review count, reviews_histogram, variations, editorial web_reviews. Offers carry Google's /goto redirect as link.

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. Default: the token's. Not with uule.

uule?string

Google's own place string. Not with location.

Response Body

The product, 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?
offers?array<>

The first buying options.

specifications?array<>
review_results?array<>
[key: string]?any
Example Request
curl -X GET 'https://api.justserp.com/v1/google/product?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",    "link": "string",    "product_token": "string",    "brand": "string",    "description": "string",    "images": [      "string"    ]  },  "offers": [    {      "position": 0,      "title": "string",      "link": "string",      "price": "string",      "extracted_price": 0,      "original_price": "string",      "extracted_original_price": 0,      "rating": 0,      "details": [        "string"      ],      "merchant": {        "name": "string",        "favicon": "string"      }    }  ],  "specifications": [    {      "category": "string",      "attributes": [        {          "name": "string",          "value": "string"        }      ]    }  ],  "review_results": [    {      "username": "string",      "source": "string",      "title": "string",      "text": "string",      "date": "string",      "more_reviews": 0    }  ]}