Google

Google Shopping Product

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.

post/v1/google/shopping/product

Request

  • Base URL: https://api.prismcrawl.com
  • URL: https://api.prismcrawl.com/v1/google/shopping/product
  • Auth: API key in header x-api-key

Request body

idstring

Use product_id from an item in a Google Shopping result.

querystring

Keep the query that returned this product_id so Google can supply its current product details. At most 8,192 UTF-8 bytes.

countrystring

Two-letter country or storefront code, such as us or gb.

languagestring

Provider-supported language code, such as en.

htmlboolean

Return the encoded original response rather than parsed JSON.

zero_traceboolean

Do not archive source or parsed response artifacts.

page_tokenstring

Product selection token returned by Google Shopping or product results. Carries the original product, offer, query and locale.

offer_viewboolean

Include the selected merchant offer view for a product ID lookup.

output'json' | 'html' | 'md' | 'null' nullable

Response content format. md returns Markdown in data.content with data.format=md; the JSON success/request envelope remains. Accept: text/markdown also selects Markdown unless output or html=true is explicit. html is an alias for html=true and retains the existing Brotli/Base64 source format.

json_restrictorstring nullable

Select fields within data.content for JSON or Markdown. Supports comma-separated paths, non-negative array indices, half-open slices [0:3] (either bound may be omitted), [] and .{nested,subqueries}. Up to128 selections and16 levels. Missing fields are omitted; selected declared fields retain their zero defaults. The request envelope and credit headers remain. Include next_page_token when pagination is needed. Incompatible with HTML output. This changes response presentation only; tracing-enabled history retains the complete JSON result.

no_cacheboolean nullable

Accepted for compatibility. Searches are always fetched without a result cache for either value; normal successful-request billing applies.

Example request

{
  "json_restrictor": "results[].{title,url},has_next_page,next_page_token"
}

Response

Request completed. One credit is charged, including an empty result when current Shopping results omit the requested ID or the product viewer reports unavailability. Inspect search_parameters.product_unavailable and product_unavailable_reason. Retrieved product details remain billable when offers are out of stock or absent.

successtrue required
request_idstring uuid required

Changes

No recorded changes to this operation across all 1 revision of this API.