Google Search sponsored ads schema - cloro
Google Search sponsored ads schema
Schema for sponsored ad results returned by the Google Search endpoint, including text ads and shopping-style cards from top-of-page and side carousels.
Sponsored ads are the paid placements Google injects into the SERP: classic text ads (top and bottom of the page) and shopping-style sponsored cards (right-hand-side and top-of-page carousels, and hotel cards inside some text ads). They arrive in the
ads[]
array of the
Google Search endpoint
response — no separate API call, no opt-in. For use cases, pricing context, and copy-paste examples, see the
Google ads scraper
page on the product site.
Sponsored ads in Google Search
Navigate to header: Example request Example request
{
"query"
:
"running shoes"
,
"country"
:
"US"
}
Navigate to header: Ad types Ad types
Each ad carries a
type
discriminator with two values:
RESULT — plain text ad. Displayed at the top or bottom of the main column with ad copy, sitelinks, and a normal destination URL.
SHOPPING_CARD — shopping-style sponsored card. Carries a product image, price, optional MSRP / oldPrice , merchant name, and a Google-redirected aclk? destination URL.
SHOPPING_CARD
ads come from four surfaces, distinguished by
blockPosition
and
category
:
| Surface | blockPosition | category examples |
|---|---|---|
| Right-hand-side PLA carousel | rhs | Sponsored products |
| Top-of-page PLA carousel | top | Sponsored products |
| Top-of-page sponsored shopping-card carousel | top | Sponsored vehicles , Sponsored products , Sponsored hotels |
| Hotel cards inside a text ad | Same as the text ad: top , middle , or bottom | Sponsored |
Top-of-page 'Sponsored products' shopping-card carousel on the Google SERP
Do not confuse
type: SHOPPING_CARD
ads with the organic
shoppingCards
field. Sponsored cards live in
ads[]
, are paid placements, and use Google
aclk?
-redirected URLs. Organic shopping cards live in
shoppingCards[]
, come from the “Popular products” / “More products” grids, and carry no product URL.
Navigate to header: Sponsored ad structure Sponsored ad structure
Fields shared across all ad types:
| Field | Type | Description |
|---|---|---|
| position | number | Position within the ad block (1-indexed) |
| blockPosition | string | Where the ad appeared: top , bottom , middle , or rhs (see “Ad types”) |
| type | string | RESULT for text ads; SHOPPING_CARD for shopping-style cards |
| title | string | Ad title |
| url | string | Destination URL of the ad (Google aclk? redirect for SHOPPING_CARD ) |
| page | number | Page number where the ad was found |
| description | string | Ad description text (see note below) |
For
type: RESULT
items,
description
is classic ad copy. For
type: SHOPPING_CARD
items it carries category-specific subtitle fragments joined with
·
— for example
Used - 94k miles · Greeley
on a “Sponsored vehicles” card.
Fields specific to
type: RESULT
text ads:
| Field | Type | Description |
|---|---|---|
| displayedUrl | string | Formatted URL as displayed in the ad |
| domain | string | Domain name of the advertiser |
| sitelinks | array | Sitelinks displayed under the ad |
Fields specific to
type: SHOPPING_CARD
ads:
| Field | Type | Description |
|---|---|---|
| category | string | Carousel header label (e.g. Sponsored products , Sponsored vehicles ) |
| price | object | Product price (see Price shape below) |
| oldPrice | object | Original price before discount / MSRP, same shape as price |
| store | string | Merchant or dealer name. On a hotel card inside a text ad, the advertiser (e.g. Booking.com ) |
| imageUrl | string | Hero image URL served by Google’s encrypted-tbn CDN |
| rating | number | Average star rating (0–5), on hotel and travel cards |
| reviews | string | Review count as Google shows it (e.g. 3.3k ), on hotel and travel cards |
Navigate to header: Price shape Price shape
price
and
oldPrice
have the same shape as
shopping card prices
. Installment / down-payment labels (common on phone-contract cards) parse the leading
"$0"
as
value: 0
, with the full text in
raw
(e.g.
"$0 down with 24 monthly payments"
) — use
raw
to disambiguate genuine free items from down-payment phrasing.
Navigate to header: Ad sitelinks Ad sitelinks
| Field | Type | Description |
|---|---|---|
| url | string | Sitelink URL |
| title | string | Sitelink title |
| description | string | Sitelink description |
Navigate to header: Response example Response example
{
"success"
:
true
,
"result"
: {
"ads"
: [
{
"position"
:
1
,
"blockPosition"
:
"top"
,
"type"
:
"RESULT"
,
"title"
:
"Running Shoes Sale - Up to 40% Off"
,
"url"
:
"https://www.acmeshoes.com/running"
,
"page"
:
1
,
"displayedUrl"
:
,
"domain"
:
"acmeshoes.com"
,
"description"
:
"Shop top brands of running shoes with free shipping on orders over $50."
,
"sitelinks"
: [
{
"url"
:
"https://www.acmeshoes.com/running/road"
,
"title"
:
"Road Running"
,
"description"
:
"Lightweight shoes for paved surfaces."
},
{
"url"
:
"https://www.acmeshoes.com/running/trail"
,
"title"
:
"Trail Running"
,
"description"
:
"Durable shoes for off-road terrain."
}
]
},
{
"position"
:
1
,
"blockPosition"
:
"top"
,
"type"
:
"SHOPPING_CARD"
,
"category"
:
"Sponsored vehicles"
,
"title"
:
"2021 Ford F-150 XLT"
,
"url"
:
"https://www.google.com/aclk?sa=L&ai=..."
,
"page"
:
1
,
"description"
:
"Used - 94k miles · Greeley"
,
"price"
: {
"value"
:
32915
,
"currency"
:
"$"
,
"raw"
:
"$32,915"
},
"oldPrice"
: {
"value"
:
35900
,
"currency"
:
"$"
,
"raw"
:
"$35,900"
},
"store"
:
"Acme Ford"
,
"imageUrl"
:
"https://encrypted-tbn0.gstatic.com/images?q=tbn:..."
},
{
"position"
:
1
,
"blockPosition"
:
"rhs"
,
"type"
:
"SHOPPING_CARD"
,
"category"
:
"Sponsored products"
,
"title"
:
"Nike Pegasus 41"
,
"url"
:
"https://www.google.com/aclk?sa=L&ai=..."
,
"page"
:
1
,
"price"
: {
"value"
:
139.99
,
"currency"
:
"$"
,
"raw"
:
"$139.99"
},
"store"
:
"Nike.com"
,
"imageUrl"
:
"https://encrypted-tbn0.gstatic.com/images?q=tbn:..."
}
]
}
}
Was this page helpful?
Ask a question...
Navigate to header: Price shape
Navigate to header: Example request
Navigate to header: Sponsored ad structure