Google AI Mode ads schema - cloro

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 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.

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. See `price`
`store`	string	Merchant/store name
`rating`	number	Product rating
`reviews`	string	Review count
`imageUrl`	string	Public URL of the ad creative image (a `https://tpc.googlesyndication.com/simgad/...` link). Omitted on text ads that render no creative.

`price`

Follows the AI Mode price shape.

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": "$",
            "raw": "$899.00"
          },
          "store": "Bambu Lab US",
          "rating": 4.7,
          "reviews": "584",
          "imageUrl": "https://tpc.googlesyndication.com/simgad/1234567890123456789"
        }
      ]
    }
  }
}