Google Ads Transparency scraper API

Scrapes Google's Ads Transparency Center (adstransparency.google.com): search creatives by text/region, list every…

Ad libraries 3 capabilities stable 98.5% success rate

Capabilities

Every capability is one POST /execute call that returns structured JSON.

List Advertiser Creatives


            google-adstransparency.advertiser-ads.list

1 credit / request Endpoint docs Copy coding prompt

Lists every creative run by a specific advertiser, identified by their Google advertiser id (e.g. AR…), within a region. Returns raw creative payloads.

Request

curl -X POST https://data.upscrape.com/execute \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":{"advertiser_id":"AR06910682252145491969","limit":5,"region":"anywhere"},"capability":"google-adstransparency.advertiser-ads.list"}'

Input

Field	Type	Required	Description
`advertiser_id`	string	required	Google advertiser id (e.g. "AR06910682252145491969"). Obtain via advertiser.search.
`cursor`	string	optional	Page token from a previous response's next_cursor.
`limit`	integer	optional	Maximum number of creatives to return (default: 50).
`region`	string	optional	ISO-3166 alpha-2 region code, or "anywhere" (default: anywhere).

Search Advertisers


            google-adstransparency.advertiser.search

1 credit / request Endpoint docs Copy coding prompt

Resolves an advertiser name or domain to its Google advertiser id(s) and disclosed metadata. Use the returned advertiser id with advertiser-ads.list.

Request

curl -X POST https://data.upscrape.com/execute \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":{"limit":5,"query":"nike"},"capability":"google-adstransparency.advertiser.search"}'

Input

Field	Type	Required	Description
`limit`	integer	optional	Maximum number of advertisers to return (default: 20).
`query`	string	required	Advertiser name or domain to resolve to an advertiser id.

Search Creatives


            google-adstransparency.creative.search

1 credit / request Endpoint docs Copy coding prompt

Searches the Ads Transparency Center by text (brand, advertiser name, or domain) within a region. Returns raw creative payloads. Use advertiser.search first when you only know the advertiser by name.

Request

curl -X POST https://data.upscrape.com/execute \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":{"limit":5,"query":"nike","region":"US"},"capability":"google-adstransparency.creative.search"}'

Input

Field	Type	Required	Description
`cursor`	string	optional	Page token from a previous response's next_cursor.
`limit`	integer	optional	Maximum number of creatives to return (default: 50).
`query`	string	required	Free text: advertiser name, brand, or domain.
`region`	string	optional	ISO-3166 alpha-2 region code, or "anywhere" (default: US).

Related scrapers

Facebook Ad Library TikTok Ad Library

Run Google Ads Transparency in under a minute

Get an API key