qstringrequired
Required search term from the shopping request that found the product. Google resolves the product page against it as well as the identifiers.
Google Shopping Product Details
https://api.sandbase.ai/v1/api/google-shopping/productOne Google Shopping product's merchant offers, prices, specifications, reviews and related products.
- Price
- $0.0001USD / call
- Method
- POST
- Response
- JSON
- Parameters
- 1 required · 11 optional
100 free calls / dayFirst 100 calls per day free (shared per organization) · Resets at 00:00 UTC. Pay per call after that.
Playground
Input
Required search term from the shopping request that found the product. Google resolves the product page against it as well as the identifiers.
Product cluster ID from a shopping result. Required unless prds is supplied; follow litescrape_product_link for a ready-made request.
Optional headline offer document ID from the same shopping result; use with gpcid.
Optional image document ID from the same shopping result; use with gpcid.
Google product selector token from a previous response. Mutually exclusive with gpcid and its companion document IDs.
Human-readable search location, such as Austin, Texas. At most 63 UTF-8 bytes. Mutually exclusive with uule.
Pre-encoded Google location token. Mutually exclusive with location.
Google domain used for the request.
Two-letter country code used to localize results.
Language code such as en, en-GB, or de.
Google device layout. Each device is served Google's real layout for it. Allowed values: desktop, tablet, mobile.
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 than 0 and at most 90. On expiry, the call is not billed and returns 503 request_deadline_exceeded with retryable=true an
OutputReady
Your output will appear here
Complete the inputs, then click Run.
API README
Google Shopping Product Details API
One Google Shopping product's merchant offers, prices, specifications, reviews and related products.
Request
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.
Start building
Send your first request
Platform API endpoint with unified authentication and usage tracking.
# The quoted heredoc keeps Unicode and shell metacharacters unchanged.
result=$(curl --fail-with-body --silent \
-X POST "https://api.sandbase.ai/v1/api/google-shopping/product" \
-H "Authorization: Bearer $SANDBASE_API_KEY" \
-H "Content-Type: application/json" \
--data-binary @- <<'SANDBASE_JSON'
{
"q": "coffee maker",
"hl": "en",
"device": "desktop",
"google_domain": "google.com"
}
SANDBASE_JSON
)
printf '%s\n' "$result"2. Authentication
Set your SandBase API key in your server environment. Requests use Bearer authentication.
export SANDBASE_API_KEY="YOUR_API_KEY"Keep your key on the server. Do not expose it in browser code.
3. Parameters
gpcidstring
Product cluster ID from a shopping result. Required unless prds is supplied; follow litescrape_product_link for a ready-made request.
headline_offer_docidstring
Optional headline offer document ID from the same shopping result; use with gpcid.
image_docidstring
Optional image document ID from the same shopping result; use with gpcid.
prdsstring
Google product selector token from a previous response. Mutually exclusive with gpcid and its companion document IDs.
locationstring
Human-readable search location, such as Austin, Texas. At most 63 UTF-8 bytes. Mutually exclusive with uule.
uulestring
Pre-encoded Google location token. Mutually exclusive with location.
google_domainstring
Google domain used for the request.
Default: "google.com"
glstring
Two-letter country code used to localize results.
hlstring
Language code such as en, en-GB, or de.
Default: "en"
devicestring
Google device layout. Each device is served Google's real layout for it.
Default: "desktop"
Possible values: desktop, tablet, mobile
timeoutnumber
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 than 0 and at most 90. On expiry, the call is not billed and returns 503 request_deadline_exceeded with retryable=true an
4. Response
Saved example response for this API; no live request is made when viewing it.
No saved response has been published. Run the API in Playground to inspect its response.
Explore more
Related APIs
| API | Price | Response |
|---|---|---|
Google Shopping Product DetailsThis API Google Shopping | $0.0001 per call | JSON |
Google Shopping | $0.01 per call | Async JSON |
Questions
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.