Google Gemini shopping cards schema - cloro
Gemini
Google Gemini shopping cards schema
Schema for product cards returned by the Google Gemini endpoint on shopping answers, with prices, stores, ratings, images, and product IDs.
This section documents the
shopping cards
data returned by the
Google Gemini endpoint
: the product cards Gemini shows in an answer when it detects shopping intent, part of the Gemini response so no separate API call is needed. Cards appear in the order Gemini shows them.
Gemini’s product cards are not sources, and they do not appear in
sources
or
citationPills
. The field names follow the
AI Mode shopping cards
, with extra fields that only Gemini supplies.
Navigate to header: Example request Example request
Shopping cards are intent-detected; no flag is required.
{
"prompt"
:
"best running shoes for beginners"
,
"country"
:
"US"
}
Navigate to header: Shopping card structure Shopping card structure
| Field | Type | Description |
|---|---|---|
| position | integer | 1-indexed rank across the shoppingCards array, in the order Gemini shows the cards |
| title | string | Product title |
| productLink | string | Google Shopping URL for the product |
| productId | string | Google Shopping product ID |
| price | object | Current price — see price object |
| oldPrice | object | Price before a discount (same shape as price ). Absent when there is no discount |
| store | string | Store that sells the product at price (e.g. "Marathon Sports" ) |
| storeLink | string | Direct URL of the product on the store’s site |
| storeCount | integer | Number of stores that sell the product. Gemini shows ”& more” after the store name when it is above 1 |
| shipping | string | Shipping cost as Gemini displays it (e.g. "Free" , "$8.95" ) |
| deliveryTime | string | Delivery time as Gemini displays it (e.g. "3-4 days" ) |
| rating | number | Product rating (0-5) |
| reviews | integer | Number of reviews |
| brand | string | Product brand |
| description | string | Product description |
| thumbnail | string | Image URL that the card shows |
| images | array | All product image URLs. The first one is thumbnail |
| catalogId | string | Google Shopping catalog ID |
| gpcId | string | Google Shopping product cluster ID |
Only
position
,
title
,
productLink
and
productId
are always present. The other fields are absent for cards that carry no such value.
rating
and
reviews
are absent for a product with no reviews.
Navigate to header: price and oldPrice price and oldPrice
| Field | Type | Description |
|---|---|---|
| value | number | Parsed numeric price |
| currency | string | Currency symbol or code as displayed (e.g. "$" , "R$" , "¥" , "MXN" ) |
| raw | string | Price text as Gemini displays it (e.g. "$129.95" ) |
When several stores sell a product at different prices, Gemini shows a range and names no store. Then
raw
is the range (e.g.
"884.41MXN - 1069MXN"
),
value
is the lowest price, and
store
is absent.
price
is absent for a product that Gemini shows with no price.
For an installment offer,
price
has only
raw
(e.g.
"now + 166.33MXN for 3 months"
). The amount is per month, not the product price, so
value
and
currency
are absent.
Navigate to header: Response example Response example
{
"success"
:
true
,
"result"
: {
"text"
:
"Here are some of the best running shoes for beginners..."
,
"shoppingCards"
: [
{
"position"
:
1
,
"title"
:
"ASICS Men's Novablast 5"
,
"productLink"
:
,
"productId"
:
"11413473167792520357"
,
"price"
: {
"value"
:
129.95
,
"currency"
:
"$"
,
"raw"
:
"$129.95"
},
"oldPrice"
: {
"value"
:
149.99
,
"currency"
:
"$"
,
"raw"
:
"$149.99"
},
"store"
:
"Marathon Sports"
,
"storeLink"
:
"https://www.marathonsports.com/products/asics-mens-novablast-5"
,
"storeCount"
:
2
,
"shipping"
:
"Free"
,
"deliveryTime"
:
"Up to 5 days"
,
"rating"
:
4.8
,
"reviews"
:
11558
,
"brand"
:
"ASICS"
,
"description"
:
"The ASICS Novablast is a multi-talented running shoe..."
,
"thumbnail"
:
"https://encrypted-tbn1.gstatic.com/shopping?q=tbn:example"
,
"images"
: [
"https://encrypted-tbn1.gstatic.com/shopping?q=tbn:example"
,
"https://encrypted-tbn2.gstatic.com/shopping?q=tbn:example2"
],
"catalogId"
:
"15000182008314641842"
,
"gpcId"
:
"1340101364570861215"
}
]
}
}
Was this page helpful?
Ask a question...
Navigate to header: price and oldPrice
Navigate to header: Example request