Google AI Overview ads schema - cloro

This section documents the ads data in the Google AI Overview: sponsored ads that Google puts inside the AI Overview. Each entry in result.aioverview.ads is one of two sub-types, text/lead-gen or shopping/product. The type field identifies the sub-type. A field that belongs to one sub-type is present only on ads of that sub-type.

Ads in AI Overview

Ad structure

Field	Type	Always present	Description
`position`	number	Yes	Position of ad (1-indexed)
`title`	string	Yes	Ad title
`url`	string	Yes	Ad destination URL
`type`	string	Yes	Sub-type discriminator: `"TEXT"` or `"SHOPPING"`
`domain`	string	When `type` is `TEXT`	Domain name of the advertiser
`description`	string	When `type` is `TEXT`	Ad description text
`price`	object	When `type` is `SHOPPING`	Product price
`old_price`	object	When `type` is `SHOPPING`, with sale pricing	Original price before discount
`store`	string	When `type` is `SHOPPING`	Retailer name
`image`	string	When extracted	Ad image URL (product photo for shopping ads, hero image for text ads)

Ad price object

price and old_price have the same shape as Google Search ad prices.

Response example

{
  "success": true,
  "result": {
    "aioverview": {
      "ads": [
        {
          "position": 1,
          "type": "TEXT",
          "title": "Dell XPS 15 — Developer Edition",
          "url": "https://www.dell.com/xps-15-developer",
          "domain": "dell.com",
          "description": "Pre-configured for Linux development with 32GB RAM.",
          "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQ..."
        },
        {
          "position": 2,
          "type": "SHOPPING",
          "title": "ThinkPad X1 Carbon Gen 12",
          "url": "https://www.bestbuy.com/site/thinkpad-x1-carbon-gen-12/abc123",
          "price": {
            "value": 1499,
            "currency": "$",
            "raw": "$1,499"
          },
          "old_price": {
            "value": 1799,
            "currency": "$",
            "raw": "$1,799"
          },
          "store": "Best Buy",
          "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcR..."
        }
      ]
    }
  }
}