Google AI Overview ads schema - cloro
AI Overview
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
: 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
Navigate to header: Ad structure 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) |
Navigate to header: Ad price object Ad price object
price
and
old_price
have the same shape as
Google Search ad prices
.
Navigate to header: Response example 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..."
}
]
}
}
}
Was this page helpful?
Ask a question...
Navigate to header: Ad structure