Google Search shopping cards schema - cloro

Google

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...

Google Search endpoint

Google Shopping scraper

product panel

Navigate to header: price and oldPrice

Navigate to header: Shopping card structure

Navigate to header: Response example