## Ads in AI Mode

This section documents the **ads** data returned by the [Google AI Mode endpoint](/content/docs/api-reference/endpoint/monitor-aimode/index.html): 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](/content/ai-mode/shopping/index.html) 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](/content/docs/api-reference/endpoint/chatgpt/ads/index.html)) 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](/content/docs/api-reference/endpoint/aimode/ads#ad-item-structure/index.html) |

## 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](/content/docs/api-reference/endpoint/aimode/inline-products#price-and-oldprice/index.html) 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"
        }
      ]
    }
  }
}
```