Google AI Mode ads schema

This section documents the ads data returned by the Google AI Mode endpoint: the sponsored ad section extracted when AI Mode surfaces sponsored shopping results, 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.

ads is an object, not an array. AI Mode wraps sponsored results in an AdSection object with a section title and an ads array of individual ad items. This differs from other providers (e.g., ChatGPT ads) where ads is a flat array — check the wrapper shape when parsing.

Example request

Ads are intent-detected; no flag is required.

{
  "prompt": "best 3D printers for hobbyists",
  "country": "US"
}

AdSection structure

Field	Type	Description
`title`	string	Section title for the ads (e.g., “Here are some 3D printers to consider”)
`ads`	array	Array of sponsored ad items

Ad item structure

Field	Type	Description
`title`	string	Ad product title
`url`	string	Ad click-through URL
`position`	integer	Position index of the ad
`price`	object	Structured pricing with `value` and `currency`
`store`	string	Merchant/store name
`rating`	number	Product rating
`reviews`	string	Review count

`price`

Field	Type	Description
`value`	number \| null	Parsed numeric price. `null` when the visible text can’t be unambiguously parsed.
`currency`	string \| null	Currency symbol (e.g. `"$"`, `"£"`, `"R$"`, `"€"`). `null` when no symbol was found.
`raw`	string	Visible ad text verbatim (e.g. `"$149.99"`). Always present when the parser had any input text.

See the inline products docs for the full price-shape contract; it’s shared across all AI Mode price-bearing fields.

Response example

{
  "success": true,
  "result": {
    "text": "Here are some 3D printers to consider...",
    "ads": {
      "title": "Here are some 3D printers to consider",
      "ads": [
        {
          "title": "Bambu Lab X2D",
          "url": "https://www.google.com/aclk?sa=L&ai=abc",
          "position": 1,
          "price": {
            "value": 899.0,
            "currency": "$"
          },
          "store": "Bambu Lab US",
          "rating": 4.7,
          "reviews": "584"
        }
      ]
    }
  }
}

⌘I

Overview

ChatGPT

Google

Perplexity

Copilot

AI Mode

Grok

Gemini

Google News

Utilities

Google AI Mode ads schema

Example request

AdSection structure

Ad item structure

`price`

Response example

​Example request

​AdSection structure

​Ad item structure

​price

​Response example

Example request

AdSection structure

Ad item structure

`price`

Response example