Google Search shopping cards schema - cloro
Google Search shopping cards schema
Shopping product information returned by the Google Search endpoint when ‘Popular products’ or ‘More products’ panels appear on the SERP.
Shopping cards come from Google’s organic shopping grids (“Popular products” and “More products”). The
Google Search endpoint
returns them as
result.shoppingCards
— no separate API call. For use cases, pricing context, and copy-paste examples, see the
Google Shopping scraper
page on the product site.
When a section header can be parsed, each card includes a
category
field naming its parent section, so you can tell apart coexisting shopping panels on the same SERP. Cards carry no product URL: they open a Google-side overlay rather than an external page.
promoLabel
is Google-only: AI Mode does not render the badge.
shoppingCards
is omitted from
result
when no shopping section is present — treat it as optional rather than expecting an empty array.
Shopping cards on the Google SERP ('More products' grid)
To get the merchant offers, specifications and reviews of the panel that a card opens, send the card’s
productResultToken
to
POST /v1/monitor/google/product
within five minutes.
Navigate to header: Shopping card structure Shopping card structure
| Field | Type | Description |
|---|---|---|
| title | string | Product title |
| position | number | 1-indexed rank in the shopping grid, flat across the whole shoppingCards array (does not reset per category section). |
| productResultToken | string | Token for the product panel . Expires five minutes after the scrape. Desktop first-page cards only, and only when Google serves the card with a panel reference. |
| promoLabel | string | Discount badge as displayed by Google, in the SERP language (e.g. "LOW PRICE" , "OFERTA" , "20% OFF" ). Present only on a card that carries the badge. |
| category | string | Parent section header (e.g., "Popular products" , "More products" ) |
| price | object | Structured pricing (see Price shape below) |
| oldPrice | object | Original price before discount (same shape as price ) |
| store | string | Merchant/store name |
| rating | number | Product rating |
| reviews | string | Review count (e.g., “384”, “2.3k”) |
| thumbnail | string | Product image URL |
Navigate to header: price and oldPrice price and oldPrice
Both fields carry a parsed and a raw representation:
| Field | Type | Description |
|---|---|---|
| value | number | Numeric price. Omitted when the visible number doesn’t parse |
| currency | string | Currency symbol (e.g. $ , £ , € ) |
| raw | string | Visible price text verbatim (e.g. "$169.99" ) |
currency
and
raw
are always present. The whole object is omitted when no currency appears beside the number, and no field is ever sent as
null
.
Navigate to header: Response example Response example
{
"success"
:
true
,
"result"
: {
"shoppingCards"
: [
{
"title"
:
"ASICS Women's Gel-Nimbus 28"
,
"position"
:
1
,
"promoLabel"
:
"20% OFF"
,
"category"
:
"More products"
,
"price"
: {
"value"
:
169.99
,
"currency"
:
"$"
,
"raw"
:
"$169.99"
},
"store"
:
"DICK'S Sporting Goods"
,
"rating"
:
4.5
,
"reviews"
:
"384"
}
]
}
}
Was this page helpful?
Ask a question...
Navigate to header: price and oldPrice