> ## Documentation Index
> Fetch the complete documentation index at: https://cloro.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Google AI Overview ads schema

> Schema for the sponsored text and shopping ads that Google puts inside the AI Overview.

This section documents the **ads** data in the [Google AI Overview](https://cloro.dev/docs/api-reference/endpoint/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](https://mintcdn.com/cloro/Qv2xgJAgMecwTTRq/images/google/aioverview-ads.webp?fit=max\&auto=format\&n=Qv2xgJAgMecwTTRq\&q=85\&s=b0a843353ba6de2e816d87e65145a3e5)

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](https://cloro.dev/docs/api-reference/endpoint/google/sponsored-ads.md#price-shape).

## Response example

```json theme={null}
{
  "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..."
        }
      ]
    }
  }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.