Skip to main content
This section documents the ads data returned by the Google AI Mode endpoint. Ads are part of the AI Mode response — no separate API call is needed.

​
Example request

Ads are intent-detected: send a prompt with high commercial intent (for example, comparing or buying a specific product category). No flag is required. 
{
  "prompt": "best 3D printers for hobbyists",
  "country": "US"
}
This produces a response containing the ads object documented below.

​
Overview

Sponsored ad section extracted from the response when AI Mode surfaces sponsored shopping results.
Ads in AI Mode
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.

​
AdSection structure

FieldTypeDescription
titlestringSection title for the ads (e.g., “Here are some 3D printers to consider”)
adsarrayArray of sponsored ad items

​
Ad item structure

FieldTypeDescription
titlestringAd product title
urlstringAd click-through URL
positionintegerPosition index of the ad
priceobjectStructured pricing with value and currency
storestringMerchant/store name
ratingnumberProduct rating
reviewsstringReview count

​
price

FieldTypeDescription
valuenumber | nullParsed numeric price. null when the visible text can’t be unambiguously parsed.
currencystring | nullCurrency symbol (e.g. "$", "£", "R$", "€"). null when no symbol was found.
rawstringVisible 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"
        }
      ]
    }
  }
}