JustSERPDocs
Google

Google Product Offers

The stores that sell a product with their prices, answered as the document: `search_metadata`, `search_parameters` (with `page`), `search_information` (`total_offers`: the number listed, not Google's total), `product` and `offers`.

GET
/v1/google/product/offers

The stores that sell a product with their prices, answered as the document: search_metadata, search_parameters (with page), search_information (total_offers: the number listed, not Google's total), product and offers. The viewer lists 4-5 offers; the rest are behind its "More stores" button, which is not pressed, so only page 1 is offered (2 and up is a 400). Not answered: delivery_price, total_price, payment_methods.

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.

hl?string

Language. Default: the token's.

location?string

The place. Default: the token's. Not with uule.

uule?string

Google's own place string. Not with location.

page?integer

Only 1; 2 and up is a 400.

Default1

Response Body

The offers, 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<>
[key: string]?any
Example Request
curl -X GET 'https://api.justserp.com/v1/google/product/offers?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",    "brand": "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"      }    }  ]}