Google Gemini shopping cards schema

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.

Example request

Shopping cards are intent-detected; no flag is required.

{
  "prompt": "best running shoes for beginners",
  "country": "US"
}

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.

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

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"
      }
    ]
  }
}

Overview

ChatGPT

Google

Perplexity

Copilot

AI Mode

Grok

Gemini

Google News

Utilities

Google Gemini shopping cards schema

Example request

Shopping card structure

`price` and `oldPrice`

Response example

​Example request

​Shopping card structure

​price and oldPrice

​Response example

Example request

Shopping card structure

`price` and `oldPrice`

Response example