Google AI Mode product results schema - cloro

Documentation Index

Fetch the complete documentation index at: /docs/llms.txt

Use this file to discover all available pages before exploring further.

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.

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

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

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