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"

:

"https://google.com/search?q=ASICS\+Men%27s\+Novablast\+5&prds=catalogid%3A15000182008314641842%2Cproductid%3A11413473167792520357&ibp=oshop"

,

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

Google Gemini endpoint

sources

citationPills

AI Mode shopping cards

Navigate to header: price and oldPrice

Navigate to header: Example request

Navigate to header: Shopping card structure

Navigate to header: Response example