Skip to main content
GET
Google immersive product detail

Identifying the product

This endpoint does not take an arbitrary product_id. To look a product up you must supply its gpcid — Google’s Shopping product identifier — together with the original search query q that surfaced it. Pass the gpcid value in the product_id parameter:
cURL
The gpcid is returned as the gpcid (also surfaced as product_id) field on every /v1/google/shopping/search result tile. The q is required because Google’s RPC re-renders the SERP for that exact query to mint the session tokens used to fetch the detail page — so the product must be discoverable via q.
Prefer page_token for new integrations. Each /v1/google/shopping/search tile also returns a bundled page_token that encodes the gpcid, q, gl, hl, and domain for you. Passing page_token alone takes precedence over the legacy product_id + q form, so you don’t have to track the original query yourself.

Authorizations

x-api-key
string
header
required

Query Parameters

product_id
string
required

Google Shopping product identifier (gpcid). Returned as product_id/gpcid on /shopping/search tiles.

q
string
required

Original search query that surfaced the product. Required by Google's /async/oapv RPC — the page-level ei/xsrf and per-tile oapvfc tokens are extracted from the SERP Google renders for this exact query, so the product must be discoverable via this query.

gl
string | null

Country code (ISO 3166 alpha-2). Defaults to the country implied by domain (e.g. google.com.auau), falling back to us when domain doesn't carry a country hint.

hl
string
default:en

Language code.

domain
string
default:google.com

Google domain ("google.com" / "google.co.uk" / …) — used to localise the SERP render that produces the session tokens.

include_offers
boolean
default:false

When true, return the full merchant-offer list with deep product URLs for every merchant Google ships an offer-block for. Offers come from the primary oapv response (top ~5 panel merchants: DICK'S, Kohl's, Zappos, etc.) plus a parallel paginated fan-out of /async/oapv with async_context=MORE_STORES at offsets sori=5..60 — which surfaces an additional ~50 sellers including GOAT, eBay sub-sellers, Macy's, StockX, Poshmark, Flight Club, etc. (+5 parallel RPCs, ~1 s wall-clock).

include_variants
boolean
default:false

When true, also fetch size/colour variants via /async/toy_v (+1 secondary RPC, ~1 s).

resolve_deep_urls
boolean
default:false

When true (only meaningful with include_offers=true), browser-render the Shopping SERP so additional merchant deep URLs surface from the rendered HTML. Best-effort: catalog-feed retailers (DSW / Famous Footwear / Shoe Carnival / Myer / rebel) get deep URLs; paid-Shopping-Ads merchants (Zappos, GOAT, Academy, etc.) still get their homepage because their click-through URLs are signed by Google's aclk redirect and can't be reproduced server-side. Adds ~5–8 s latency.

Response

Successful Response

Response for GET /api/v1/products/detail.

title
string | null
description
string | null
brand
string | null
rating
number | null
reviews_count
integer | null
price_range
string | null
sellers
ProductSeller · object[]
specs
Specs · object
images
string[]
product_id
string | null