# Google Shopping Product Details API

> One Google Shopping product's merchant offers, prices, specifications, reviews and related products.

Source: https://www.sandbase.ai/apis/google-shopping/product
API reference: https://www.sandbase.ai/apis/google-shopping/product/docs

## Facts

- Provider: Google Shopping
- Type: Data API
- Endpoint: `POST https://api.sandbase.ai/v1/api/google-shopping/product`
- Price: $0.0001 per call
- Free allowance: 100 calls per organization per UTC day, shared across eligible APIs
- Capabilities: api, google shopping, search
- Billing: pay per use from one SandBase balance; no provider account or subscription needed

## Call it

`POST https://api.sandbase.ai/v1/api/google-shopping/product` with `Authorization: Bearer $SANDBASE_API_KEY` and the parameters as a JSON body.

| Parameter | Type | Required | Allowed values |
| --- | --- | --- | --- |
| `q` | string | yes |  |
| `gpcid` | string | no |  |
| `headline_offer_docid` | string | no |  |
| `image_docid` | string | no |  |
| `prds` | string | no |  |
| `location` | string | no |  |
| `uule` | string | no |  |
| `google_domain` | string | no |  |
| `gl` | string | no |  |
| `hl` | string | no |  |
| `device` | string | no | desktop, tablet, mobile |
| `timeout` | number | no |  |

## FAQ

### How do I use the Google Shopping Product Details API?

Send a POST request to https://api.sandbase.ai/v1/api/google-shopping/product with your SandBase API key in the Authorization header (Bearer) and the parameters as a JSON body. You can also try it in the Playground on this page without writing code.

### How much does the Google Shopping Product Details API cost?

$0.0001 per call. Every organization gets 100 free calls per UTC day, shared across eligible SandBase APIs including this one; after that each call is billed at this price from your SandBase balance. There is no subscription.

### What parameters does the Google Shopping Product Details API accept?

Required: q (string). Optional: gpcid (string), headline_offer_docid (string), image_docid (string), prds (string), location (string) and uule (string) and 5 more. The Parameters table and the Playground on this page list every field.

### What does the Google Shopping Product Details API return?

A JSON response returned in the same HTTP request (synchronous).

### Do I need a Google Shopping developer account or API key?

No. Google Shopping Product Details runs through SandBase, so one SandBase API key covers this endpoint and every other API and model in the catalog. You do not need to apply for Google Shopping API access separately.

## README

### Google Shopping Product Details API

One Google Shopping product's merchant offers, prices, specifications, reviews and related products.

#### Request

```bash
curl -X POST "https://api.sandbase.ai/v1/api/google-shopping/product" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"q": "coffee maker", "gpcid": "3753285529675071078", "headline_offer_docid": "2823574139643882398", "image_docid": "5002652757944012799"}'
```

The result is returned in `outputs[0].data`.

#### Parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `q` | string | Yes | Required search term from the shopping request that found the product. Google resolves the product page against it as well as the identifiers. |
| `device` | string | No | Google device layout. Each device is served Google's real layout for it. |
| `gl` | string | No | Two-letter country code used to localize results. |
| `google_domain` | string | No | Google domain used for the request. |
| `gpcid` | string | No | Product cluster ID from a shopping result. Required unless prds is supplied; follow litescrape_product_link for a ready-made request. |
| `headline_offer_docid` | string | No | Optional headline offer document ID from the same shopping result; use with gpcid. |
| `hl` | string | No | Language code such as en, en-GB, or de. |
| `image_docid` | string | No | Optional image document ID from the same shopping result; use with gpcid. |
| `location` | string | No | Human-readable search location, such as Austin, Texas. At most 63 UTF-8 bytes. Mutually exclusive with uule. |
| `prds` | string | No | Google product selector token from a previous response. Mutually exclusive with gpcid and its companion document IDs. |
| `timeout` | number | No | Optional budget for the entire request in seconds, measured from gateway receipt until the response is ready to send. Includes admission, queueing and settlement. Must be greater t |
| `uule` | string | No | Pre-encoded Google location token. Mutually exclusive with location. |

#### Pricing

Flat price per call. Failed calls are not charged.