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 51.5% success rate

Capabilities

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

List Advertiser Creatives


            google-adstransparency.advertiser-ads.list

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

Output

Field	Type	Required	Description
`items`	array<array>	required	Raw creative records returned by the SearchCreatives RPC, preserved verbatim.
`next_cursor`	string	optional	Page token for the next page, if present.
`total_items`	integer	required	Number of items returned in this response.

Search Advertisers


            google-adstransparency.advertiser.search

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.

Output

Field	Type	Required	Description
`items`	array<object>	required	Resolved advertiser records.
`items[].ad_count_max`	integer	optional	Upper bound of the disclosed ad-count range.
`items[].ad_count_min`	integer	optional	Lower bound of the disclosed ad-count range.
`items[].advertiser_id`	string	required	Google advertiser id (AR…) for use with advertiser-ads.list.
`items[].name`	string	required	Advertiser display name.
`items[].region`	string	optional	Primary disclosed region (ISO-3166 alpha-2).
`items[].verified`	boolean	optional	Whether the advertiser is identity-verified.
`total_items`	integer	required	Number of advertisers returned.

Search Creatives


            google-adstransparency.creative.search

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

Output

Field	Type	Required	Description
`items`	array<array>	required	Raw creative records returned by the SearchCreatives RPC, preserved verbatim.
`next_cursor`	string	optional	Page token for the next page, if present.
`total_items`	integer	required	Number of items returned in this response.

Related scrapers

Facebook Ad Library

Run Google Ads Transparency in under a minute

Get an API key