Google AI Mode shopping cards schema - cloro

This section documents the shopping cards data returned by the Google AI Mode endpoint: product information extracted when AI Mode detects shopping intent, part of the AI Mode response so no separate API call is needed. For use cases, pricing context, and copy-paste examples, see the AI Mode shopping API page on the product site.

Shopping cards in AI Mode

For individual product references embedded inline within the AI response text (rather than in a dedicated carousel), see inline products. Both arrays may appear in the same response.

Example request

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

{
  "prompt": "best wireless headphones under $200",
  "country": "US"
}

Shopping card structure

Field	Type	Description
`title`	string	Product title
`position`	number	1-indexed rank across the `shoppingCards` array in DOM/render order.
`price`	object	Structured pricing. See `price` and `oldPrice`
`store`	string	Merchant/store name (conditionally populated — may be absent)
`rating`	number	Product rating
`reviews`	string	Review count in Google’s abbreviated format (e.g., `"2.3k"`, `"1m"`). Parse as a string; convert client-side if you need a numeric value.
`thumbnail`	string	Product image URL
`productLink`	string	Direct product URL (conditionally populated — may be absent)
`productResultToken`	string	Token for the card’s merchant offers. Expires five minutes after the scrape. Absent when the card does not link to a Google product viewer
`productDocid`	string	Google’s ID for the product, read from `productLink`. Use it to join the product blocks. Absent when the link from Google has no ID
`oldPrice`	object	Original price before discount (conditionally populated — absent when no discount)
`snippet`	string	Product description snippet
`snippetLinks`	array	Links found within the product snippet

store, productLink, and oldPrice are conditionally populated — not every item includes all fields. Build your pipeline to handle missing fields on any individual shopping card.

`price` and `oldPrice`

Both follow the AI Mode price shape.

`snippetLinks`

Field	Type	Description
`text`	string	Link text
`link`	string	Link URL

Response example

{
  "success": true,
  "result": {
    "text": "Here are highly-rated wireless headphones under $200...",
    "shoppingCards": [
      {
        "title": "Sony WH-CH720N Noise Cancelling Headphones",
        "position": 1,
        "price": {
          "value": 149.99,
          "currency": "$",
          "raw": "$149.99"
        },
        "oldPrice": {
          "value": 199.99,
          "currency": "$",
          "raw": "$199.99"
        },
        "store": "Amazon",
        "rating": 4.5,
        "reviews": "2.3k",
        "thumbnail": "https://example.com/product.jpg",
        "productLink": "https://www.amazon.com/sony-wh-ch720n",
        "snippet": "Noise-canceling wireless headphones with 30-hour battery life",
        "snippetLinks": [
          {
            "text": "noise canceling",
            "link": "https://www.google.com/search?q=noise+canceling"
          }
        ]
      }
    ]
  }
}