Google

Google Shopping Product API

Look up a product_id returned by Google Shopping using the original Shopping query. Returns the current product details, merchant offers, images, and specifications supplied by Google. A recognized unavailable product returns a successful, billable empty response with search_parameters.product_unavailable:true and product_unavailable_reason:not_in_results when the ID is absent from the current query's Shopping cards, or unavailable when the product viewer reports no details. Retrieved product details are also successful and billable when offers are out of stock or absent.

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`Required	Use product_id from an item in a Google Shopping result.
`query`Required	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.

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.

idtitlenameurlpositionthumbnailratingproduct_idgpc_idbranddescriptionwebsiterating_countimagesspecificationsvariantsoffers