Google Ads Transparency API reference
Get the ads any brand runs on Google from the Ads Transparency Center, as JSON. Search by brand or domain, list an advertiser's ads, and filter by country, format and Search or YouTube.
The Google Ads Transparency API has 4 endpoints, called the same way: POST /execute with the endpoint ID as capability and its fields as input, or pin Google Ads Transparency in the MCP server and call each one as a tool. The data comes back as JSON in results[0].data, with what the call cost in billing.credits_charged.
The inputs you send most are advertiser_id and query. Prices run from 1 credit to 1.5–6 credits per call, and a failed call costs nothing.
Endpoints
Open an endpoint for its input, the fields it returns and the request in cURL, Python and Node.js.
| Endpoint | What it returns | Price |
|---|---|---|
google-adstransparency.creative.search |
Search by brand, advertiser name or domain and get that advertiser's ads, filtered by country, format and Search or YouTube. | 1.5–6 credits |
google-adstransparency.advertiser.search |
Find an advertiser's Google advertiser ID from its name or domain, with its region, verification status and how many ads it runs. | 1 credit |
google-adstransparency.advertiser-ads.list |
List every ad of one advertiser by its advertiser ID, page by page, with the same filters. | 1.5–6 credits |
google-adstransparency.creative.get |
Get one ad from its advertiser and ad IDs: every version of it, the regions it ran in and when it was last shown. | 1.5 credits |
What to know
- Google's own fields Ad records keep every field the Transparency Center returns, under Google's own field numbers, so nothing is lost or renamed.
- One brand, many accounts A brand can have several advertiser accounts in different regions. Advertiser search lists them all, each with its own ID.
- Country and platform filters Country filters cover the US and Germany. The Search and YouTube filter covers ads shown since September 2023.
- Ad counts are ranges Advertiser search reports how many ads an advertiser runs as a low and a high figure, as Google shows it.
- Next pages Lists come a page at a time. Send next_cursor back with the same filters to continue.
Something missing or unclear? Ask the team that builds the Google Ads Transparency endpoints.