Every ad a company runs on Google — by country, format and platform — with EU reach and election spend
The Google Ads Transparency Center API turns adstransparency.google.com into JSON in six actions.
6 active endpoints, on 1 and 2 credit tiers.
- POST/google-ads-transparency/v1/search
- POST/google-ads-transparency/v1/advertisers
- POST/google-ads-transparency/v1/advertiser
- POST/google-ads-transparency/v1/ads
- POST/google-ads-transparency/v1/political_ads
- POST/google-ads-transparency/v1/ad
What Google Ads Transparency Center endpoints does ReefAPI ship?
6 live read endpoints. Read-only data API: no writes, no account actions, no dashboard access on the target site.
Google Ads Transparency Center API
4 of 6 endpoints, ready to run
All ads of an advertiser or a domain, newest first, with format and dates.
// Press "Try it" and this pane shows exactly what the // live site returned this second — including an empty // result, if that is the truth. No key, no account.
How the Google Ads Transparency Center API works
Google Ads Transparency Center is a normal ReefAPI surface — the same four rules that hold for every other engine on the key.
No OAuth app, no request signing, no per-site account. One key covers all 598 engines.
Every route is a POST with a JSON body. Parameters are validated against the published schema before anything is charged.
Credits, not seats. Failed and blocked calls are never charged, and nothing is cached: every call reads the source live.
One envelope everywhere. meta carries latency_ms, record_count and the endpoint that answered.
See every ad a competitor runs in one country
Three calls, from a brand name to its ads and the reach of one of them.
Advertisers named Nike with country, ad count and verified status; Nike, Inc. is AR16735076323512287233.
Nike's image ads shown in Germany, newest first, with the ad image and first / last shown date.
One ad: the 27 countries it ran in, impressions per EU country and platform, and the audience selection.
Which ads a competitor runs where, since when, and how many people saw them in the EU.
curl -X POST https://api.reefapi.com/google-ads-transparency/v1/ads \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"advertiser_id":"AR16735076323512287233","region":"US"}'{
"ok": true,
"data": { … },
"meta": {
"api": "google-ads-transparency",
"endpoint": "ads",
"mode": "live",
"latency_ms": …,
"record_count": …
},
"error": null
}Which number is which
The Transparency Center publishes ranges, not exact counts, and different ranges in different places. Field names as the API returns them, measured 2026-11-03.
| field | what it is | example |
|---|---|---|
| meta.total_min / total_max (ads) | The source's range for how many ads match | Nike, Inc.: 8,000 – 9,000; region DE: 90 |
| meta.total (political_ads) | Exact number of election ads in the country | United States: 981,207 |
| ads_count_min / ads_count_max (search) | The advertiser's ad count as the search box shows it | Nike, Inc.: 9,000 – 10,000 |
| days_shown | Days the ad was shown | 143 for an ad first shown 2026-04-28, last 2026-11-03 |
| regions[].impressions_min / max (ad) | Times shown in that EU country | Germany: 0 – 1,000 |
| eu.impressions_min / max (ad) | Times shown in the EU in total | 1,000 – 2,000 |
| spend.min / spend.max (election) | Amount spent, advertiser's currency | USD 10,000 – 15,000 |
The search-box count and the ads total for the same advertiser can differ (9,000 – 10,000 vs 8,000 – 9,000 for Nike, Inc.); both are the source's own figures. On an election ad that ran in more than one country, the political_ads row shows the figures listed for the country you searched and ad shows the ad's total: a US + Germany ad read 0 – 1,000 impressions in the Germany list and 30,000 – 35,000 in its detail.
What the Transparency Center publishes — measured 2026-11-03
Google's Ads Transparency Center lists the ads advertisers run on Google Search, YouTube, Shopping, Maps and Play. These are the numbers and limits measured on the live site.
Search by name or domain; advertisers pages through every matching advertiser with verified legal name and country (broad words such as bank report 500 matches on the first page and more as you page).
Nike, Inc. 8,000 – 9,000 ads, Shopify Inc. 40,000 – 50,000, Booking.com 15.4 – 15.5 million; domain temu.com 2.8 – 2.9 million. Up to 100 per page, paged with page_token.
244 countries and territories, format (text, image, video), platform (Search, YouTube, Shopping, Maps, Play) and a date range. Totals are ranges, as the source publishes them.
Every variation, topic, every country with last shown date; for EU countries first shown date and impressions range per country and per platform, the EU total and the audience selection.
Per country with an exact total: United States 981,207, India 75,285, United Kingdom 25,606, Brazil 18,270, Germany 16,451, France 16,243. Spend and impressions ranges, age, gender and location targeting.
Text ads come as an image of the ad as shown on Search; image and video ads as Google's preview link and, where provided, an image. Image width and height are the displayed size; the file is twice that.
Median 0.76 – 0.91 s per call across the six actions (80 calls).
Exact impression counts (only ranges), spend for non-election ads, impressions outside the EU for non-election ads, the text of image and video ads as separate fields, and older ads (a January 2025 date window returned none; December 2025 still returned ads).
What people build with Google Ads Transparency Center
The jobs this data is most often used for.
endpoints
credits per call
Competitor ad monitoring: ads with a rival's advertiser_id or domain, newest first, and diff the creative_ids each day.
Creative research: every video or image ad a brand ran on YouTube or Search in a country, with the ad image and preview.
EU reach checks: ad gives impressions per EU country and platform and the audience selection behind an ad.
Election ad tracking: political_ads per country with spend and impressions; ad adds age, gender and location targeting.
What Google Ads Transparency Center data costs
The cheapest call here is 1 credit, so $15/mo (Pro) buys 10,000 of them — $1.50 per 1,000 credits. Credits roll over and never expire, and failed or blocked calls are not charged.
Full pricing →- 1,000 free credits on signup, no card
- One key, all 598 APIs, one credit pool
- Failed and blocked calls are never charged
- Credits roll over and never expire
Call it in two lines
Sign up, get 1,000 credits and one key that works on every engine. Then this is the whole protocol.
curl -X POST https://api.reefapi.com/google-ads-transparency/v1/ads \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"advertiser_id":"AR16735076323512287233","region":"US"}'import requests
r = requests.post(
"https://api.reefapi.com/google-ads-transparency/v1/ads",
headers={"x-api-key": REEF_KEY},
json={
"advertiser_id": "AR16735076323512287233",
"region": "US"
},
)
print(r.json()["data"])Have a question? We got answers.
The questions people actually ask before wiring up Google Ads Transparency Center.
Get a free key →Can I get every ad a competitor runs on Google?▾
Yes. Find the advertiser with search or advertisers, then call ads with its advertiser_id and page with page_token, up to 100 ads per page. Or call ads with domain=competitor.com to get every ad that points to that domain from any advertiser: nike.com returned 50,000 – 60,000 ads, more than Nike, Inc. alone (8,000 – 9,000).
Which filters are there?▾
Country (two-letter code, 244 countries and territories), format (text, image, video), platform (search, youtube, shopping, maps, play) and a date range. Each one changes the source's own count: Nike, Inc. goes from 8,000 – 9,000 ads to 90 in Germany, 100 – 200 videos, 13 on Google Play and 1,000 – 2,000 shown in October 2026.
Do I get the ad's text?▾
Text ads are published by Google as an image of the ad as it appeared on Search, so image_url is a picture of the headline, link and description. Image and video ads come with Google's preview link (preview_url) and, where Google provides one, an image. The text of image and video ads is not returned as separate fields.
How far back does it go?▾
As far as the Transparency Center lists ads: measured on 2026-11-03, a date window in December 2025 still returned 4,000 – 5,000 Nike ads, while January 2025 returned none for all three advertisers and domains tried.
What is in the EU data?▾
For ads shown in the European Union, ad returns per EU country the first and last shown date and the impressions range, split by platform, the EU total, and the audience selection: whether demographics, locations, contextual signals, topics of interest and customer lists were used to include or exclude people. Outside the EU the source publishes the last shown date per country.
Does it cover election ads?▾
Yes. political_ads takes a country (measured: United States 981,207 ads, India 75,285, United Kingdom 25,606, Brazil 18,270, Germany 16,451, France 16,243) and returns each ad with the advertiser, impressions range and spend range in the advertiser's currency. ad on an election ad adds first and last shown, days shown, the countries it ran in and age, gender and location targeting. advertiser on an election advertiser returns its number of election ads and its registration id.
What does verified mean?▾
Google's advertiser verification: verified is true when the Transparency Center shows the advertiser as verified. advertiser and advertisers also return the verified legal name and country.
How fast is it?▾
Measured on 80 calls on 2026-11-03: median 0.76 – 0.91 s per action; the slowest of 16 ad calls took 1.9 s.
What is the Google Ads Transparency Center API?▾
Google Ads Transparency Center API is a ReefAPI endpoint group for every advertiser on google and the ads they run: ads by advertiser or domain with format and first / last shown date, filtered by country, format, platform and date; one ad's countries, eu reach and audience selection; election ads with spend and targeting. It returns live JSON through POST requests under /google-ads-transparency/v1.
Is the Google Ads Transparency Center API free to try?▾
Yes. ReefAPI starts with 1,000 free credits, no card required. Google Ads Transparency Center calls use the same shared credit balance as every other ReefAPI engine.
Do I need a Google Ads Transparency Center login or account?▾
No login to Google Ads Transparency Center is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.
How fresh is the Google Ads Transparency Center data?▾
The page example is captured from a live search call, and production requests fetch live data through ReefAPI rather than a static sample.
How many credits does the Google Ads Transparency Center API use?▾
Google Ads Transparency Center actions currently cost 1-2 credits per successful call. Failed or blocked calls are free. All APIs draw from one credit pool.
Can I call Google Ads Transparency Center from an AI assistant or MCP client?▾
Yes. Connect ReefAPI once through MCP and your assistant can call google-ads-transparency actions with the same key, credit pool and JSON envelope used by normal REST requests.
3 Search & SEO APIs on the same key
One key, one credit pool, one response envelope. If you are pulling Google Ads Transparency Center, you are one call away from the rest of the category — no second contract, no second integration.
Need something this API does not do?
Name the endpoint, the field, or a source we do not carry yet. We ship new APIs every week and you would be first to get the key. Real people read every message and reply the same day.
Try it on your own data before you pay anything
The call above is the real endpoint, not a recording. A free key gives you 1,000 credits, the other 597 APIs, and the same envelope everywhere.
Endpoints, parameters and credit costs on this page are read from the live catalog and cannot drift from what the API accepts. Field notes were captured on 2026-11-03.