Google AI Mode product results schema

Product results are the merchant offers behind each product cluster in a Google AI Mode response — merchant URL, price, installment terms, and stock, delivery and returns badges. Set include.expandProducts to get them as result.productResults.

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

Without the flag, products are reported at cluster level only: shopping cards and inline products carry a headline price and a link to Google’s product viewer. Expansion opens that viewer and returns the offers inside it. Both arrays are unchanged either way.

Product viewer opened from an AI Mode product

Same shape as Google Search product results, where the panel is already in the SERP and needs no flag.

Limits and cost

Each entry is one product cluster, deduplicated across shoppingCards and inlineProducts, and costs one extra fetch of Google’s product viewer:

+1 credit per entry returned, charged after the scrape completes
6 clusters expanded per scrape at most, so the surcharge tops out at +6
clusters that fail to fetch are dropped from the array, and not charged

See providers for the pricing table.

Product result structure

Each entry describes one product cluster and its merchant offers.

Field	Type	Description
`title`	string	Product cluster title, as Google displayed it
`stores`	array	Merchant offers. See store structure
`aboutTheProduct`	object	`description` (Google’s prose blurb) and `features` (bullets, when shown)
`specifications`	object	Spec tables grouped by category. See specifications
`images`	array	`mainUrl` and `thumbnailUrl` per image, often identical

Only title is guaranteed — anything Google’s panel omits is left out of the object rather than sent as null. Panels can also carry brand, rating, reviews, priceRange, typicalPrices, variants, relatedProducts, userReviews, videos, discussionsAndForums and highlights, emitted under those names when present, though most carry none of them.

Specifications

A category name mapped to a flat set of spec key/value pairs:

{
  "specifications": {
    "general": {
      "Brand": "Sennheiser",
      "Noise cancellation": "Yes"
    }
  }
}

Category names and spec keys arrive in the response language — a country: "MX" request returns {"general": {"Marca": "Sennheiser"}}. Iterate the object; don’t read a hard-coded key like specifications.general.Brand.

Store structure

Field	Type	Description
`name`	string	Merchant name (e.g. `"Amazon"`)
`link`	string	Merchant product URL, passed through from Google verbatim
`price`	object	See price shape. Omitted entirely when the displayed text can’t be parsed
`installments`	string	Installment terms as displayed (e.g. `"for 24 mo, $0 now, $798.96 total"`)
`description`	string	Merchant’s listing title, naming the exact SKU sold (e.g. `"iPhone 17 256GB White - Apple"`) — unlike `title`, which names the product overall
`buyingOptions`	array	Merchant badges in display order — stock status, rating, delivery promise, returns window. Google varies these per merchant and locale, so they stay an unparsed list of strings
`logo`	string	Merchant logo URL
`shipping`	string	Shipping cost or promise as displayed
`condition`	string	Item condition (e.g. `"New"`, `"Refurbished"`)
`rating`	number	Merchant rating
`reviews`	string	Merchant review count, abbreviated (e.g. `"384"`, `"2.3k"`)

Expect the first six on most offers and the rest only occasionally. Everything beyond name is optional and omitted when absent — Google shows different combinations per merchant, so an “Out of stock” listing may have no price or link at all.

link is not validated against the cluster. Google occasionally serves a merchant URL for an unrelated SKU, so an offer’s link can point at a different product than its description names. Verify against description if link correctness matters.

Price shape

Field	Type	Description
`value`	number	Parsed numeric price; always present when `price` is emitted. On installment offers this is the monthly payment
`currency`	string	ISO 4217 code (e.g. `"USD"`). Unrecognized symbols fall through as the glyph itself (e.g. `"R$"`)
`raw`	string	Visible price text verbatim (e.g. `"$149.99"`)

currency here is an ISO code ("USD"), while shopping cards and inline products carry the raw symbol ("$"). Normalize before comparing across surfaces.

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" },
        "store": "Amazon"
      }
    ],
    "productResults": [
      {
        "title": "Sony WH-CH720N Noise Cancelling Headphones",
        "aboutTheProduct": {
          "description": "Wireless noise-canceling headphones with up to 35-hour battery life and multipoint connection."
        },
        "specifications": {
          "general": {
            "Brand": "Sony",
            "Noise cancellation": "Yes",
            "Wireless technology type": "Bluetooth"
          }
        },
        "images": [
          {
            "mainUrl": "https://encrypted-tbn3.gstatic.com/shopping?q=tbn:ANd9Gc...",
            "thumbnailUrl": "https://encrypted-tbn3.gstatic.com/shopping?q=tbn:ANd9Gc..."
          }
        ],
        "stores": [
          {
            "name": "Amazon",
            "link": "https://www.amazon.com/sony-wh-ch720n",
            "price": {
              "value": 149.99,
              "currency": "USD",
              "raw": "$149.99"
            },
            "description": "Sony WH-CH720N Wireless Noise Canceling Headphones, Black",
            "shipping": "Free delivery by Thu, Aug 14",
            "condition": "New",
            "rating": 4.6,
            "reviews": "2.3k",
            "buyingOptions": [
              "In stock online",
              "4.6/5",
              "Free delivery",
              "30-day returns"
            ]
          },
          {
            "name": "Best Buy",
            "link": "https://www.bestbuy.com/site/sony-wh-ch720n",
            "price": {
              "value": 33.33,
              "currency": "USD",
              "raw": "$33.33"
            },
            "installments": "for 6 mo, $0 now, $199.98 total",
            "description": "Sony - WH-CH720N Wireless Noise Cancelling Headphones - Black",
            "buyingOptions": [
              "In stock online",
              "Free shipping"
            ]
          }
        ]
      }
    ]
  }
}

Note the two currency conventions in the same payload: shoppingCards[].price.currency is the raw symbol ("$"), while productResults[].stores[].price.currency is an ISO code ("USD").

Overview

ChatGPT

Google

Perplexity

Copilot

AI Mode

Grok

Gemini

Google News

Utilities

Google AI Mode product results schema

Limits and cost

Product result structure

Specifications

Store structure

Price shape

Response example

​Limits and cost

​Product result structure

​Specifications

​Store structure

​Price shape

​Response example

Limits and cost

Product result structure

Specifications

Store structure

Price shape

Response example