Google AI Mode inline products schema

This section documents the inline products data returned by the Google AI Mode endpoint: product cards found within the AI response text, part of the AI Mode response so no separate API call is needed. Unlike shopping cards — which group multiple products into a dedicated carousel — inline products are stand-alone product references embedded directly in the AI’s prose. Both arrays may coexist in a single response. For use cases, pricing context, and copy-paste examples, see the AI Mode shopping API page on the product site.

Example request

Inline products are intent-detected; no flag is required.

{
  "prompt": "what are the best wireless headphones for travel",
  "country": "US"
}

Inline product structure

Field	Type	Description
`title`	string	Product title
`position`	integer	1-indexed rank across the `inlineProducts` array in DOM/render order. Always emitted.
`price`	object	Structured pricing — see price object for the shape
`oldPrice`	object	Original price before discount (same shape as `price`)
`store`	string	Merchant/store name (e.g. `"Amazon"`, `"Mercado Livre"`)
`rating`	number	Average rating out of 5, from Google’s product data. Absent when Google shows no rating
`thumbnail`	string	Product image URL. May be a `https://` URL or a `data:image/jpeg;base64,...` blob injected by Google’s client JS. Omitted when the page was captured before Google’s image loader ran.
`productLink`	string	Direct product URL
`productResultToken`	string	Token for the product’s merchant offers. Expires five minutes after the scrape. Absent when the product 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

`price` and `oldPrice`

This shape is shared by every AI Mode price field: inline products, shopping cards and ads.

Field	Type	Description
`value`	number	Parsed numeric price
`currency`	string	Currency symbol or word as displayed (e.g. `"$"`, `"£"`, `"R$"`, `"€"`), or an ISO code on structured prices
`raw`	string	Visible price text verbatim (e.g. `"$329.99"`, `"R$ 4,40/mês"`)

A field that can’t be parsed is omitted, never sent as null, so a price takes one of these shapes:

Parsed: {value, currency, raw}. Use value for math/aggregation.
Number unparseable: {currency, raw}. A currency was found but the amount wasn’t readable.
raw only: no currency was found, or the text is a monthly-payment offer such as R$ 4,40/mês. Shipping 4.40 as the product price would be wrong, so fall back to raw for display.
Structured (inline products only): {value, currency} from Google’s structured price data, with an ISO currency (e.g. "USD"), plus raw when the page also showed the price text. The product’s oldPrice then carries the ISO code too.

Response example

{
  "success": true,
  "result": {
    "text": "Based on expert reviews, here are the top wireless headphones for travel...",
    "inlineProducts": [
      {
        "title": "Sony WH-1000XM5",
        "position": 1,
        "price": {
          "value": 298.0,
          "currency": "$",
          "raw": "$298.00"
        },
        "oldPrice": {
          "value": 399.99,
          "currency": "$",
          "raw": "$399.99"
        },
        "store": "Amazon",
        "rating": 4.6,
        "thumbnail": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/...",
        "productLink": "https://www.google.com/shopping/product/example",
        "productResultToken": "nuzK-QgAV8BqrZdwQJYZopzdoFhpvKr-N2_YDZevwzg",
        "productDocid": "3625873292990915110"
      },
      {
        "title": "Short Floral Estampa Floral - Compre Já",
        "position": 2,
        "price": {
          "raw": "R$ 4,40/mês"
        },
        "store": "Mercado Livre",
        "productLink": "https://www.google.com/shopping/product/example2"
      }
    ]
  }
}

Overview

ChatGPT

Google

Google AI Mode

Bing AI Mode

Gemini

Google News

Async tasks

Utilities

Google AI Mode inline products schema

Example request

Inline product structure

`price` and `oldPrice`

Response example

Example request

Inline product structure

price and oldPrice

Response example

`price` and `oldPrice`