Google

Google Shopping Product API

Google Shopping Product API. Look up a Shopping product_id to get merchant offers, prices, shipping, availability, images, and specifications.

Retrieve a Google product by id, optionally with its original query, or by page_token returned by Google Shopping. Product tokens retain the exact source offer and locale. Returns native product details, merchant offers, images and specifications.

Try in the request builder API reference Connect with MCP

Make a request

Use your existing PrismCrawl API key and credit balance. A completed request consumes one credit, including recognized empty or unavailable results and source changes found during a valid continuation. Validation and operational errors remain uncharged. Each completed continuation request is billed separately.

POST /v1/google/shopping/product

curl 'https://api.prismcrawl.com/v1/google/shopping/product' \
  --request POST \
  --header 'content-type: application/json' \
  --header 'x-api-key: <PRISMCRAWL_API_KEY>' \
  --data '{
  "id": "17755277695162489284",
  "query": "sony wh-1000xm5"
}'

Supported parameters

Parameter	Usage
`id`	Use product_id from an item in a Google Shopping result.
`query`	Keep the query that returned this product_id so Google can supply its current product details.
`country`	Two-letter country or storefront code, such as us or gb.
`language`	Provider-supported language code, such as en.
`html`	Return the encoded original response rather than parsed JSON.
`zero_trace`	Do not archive source or parsed response artifacts.
`page_token`	Product selection token returned by Google Shopping or product results. Carries the original product, offer, query and locale.
`offer_view`	Include the selected merchant offer view for a product ID lookup.

Structured results

Read items from data.content.results. The response also includes the search metadata, pagination state, and any extracted SERP features. Optional fields appear when supplied by the provider.

When the requested ID is absent from the query's current Shopping results or Google's product viewer confirms unavailability, the API returns HTTP 200 with an empty results array and product_unavailable: true in search metadata. product_unavailable_reason is not_in_resultsor unavailable, respectively. This completed response costs one credit. An ID missing from one query does not establish that the product is unavailable everywhere. Retrieved details remain billable when offers are out of stock or absent.

availabilitybrandcurrencydescriptiongpc_ididimagesmerchantnameofferspage_tokenpositionpriceprice_textproduct_idrankratingrating_countspecificationsthumbnailtitletypeurlvariantswebsite

SDKs and guides

The official SDKs cover this endpoint with typed parameters, automatic retries, and pagination helpers.

Python SDK: pip install prismcrawl
Node.js SDK: npm install prismcrawl