Google Search sponsored ads schema - cloro

Google

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"

:

"www.acmeshoes.com/running"

,

"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...

Google Search endpoint

Google ads scraper

shoppingCards

Navigate to header: Price shape

shopping card prices

Navigate to header: Example request

Navigate to header: Ad types

Navigate to header: Sponsored ad structure

Navigate to header: Ad sitelinks

Navigate to header: Response example