Google Ads Transparency Scraper & Ad Library API
Pricing
from $1.19 / 1,000 ads
Get every ad a competitor runs from the Google Ads Transparency Center: pass one or a list of domains, advertiser IDs or brand names and get format, first and last shown, days live, countries, platforms and EU impressions. Monitor new creatives since the last run. $1.49 per 1,000 ads.
All notable changes to Google Ads Transparency are recorded here. The newest release is first.
All additions are optional. Existing inputs return the same rows as before, and the price is unchanged.
domains (website domains) and advertiserIds (bare AR... ids) as JSON arrays. They are read exactly like startUrls; when one is set, the example domains in startUrls are ignored.maxAdsPerAdvertiser, a cap per advertiser, domain or keyword match, so one large advertiser cannot use up maxItems in a batch run. An ad dropped by the region check gives its slot back.All additions are optional. Existing inputs return the same columns as before, and the price is unchanged.
searchQueries, a search by brand or advertiser name (for example HubSpot). Each name is matched through the Transparency Center's own search suggestions to the brand's verified website and advertiser accounts. Advertiser accounts are picked only when their name carries a legal form or is a website name, so a person's name as keyword never selects that person's account. maxAdvertisersPerQuery sets how many matches each name may take. Rows get searchType and searchQuery.platform filter (Search, YouTube, Google Play, Maps, Shopping) and a date filter (dateFrom / dateTo, absolute or relative such as 30 days). Google applies both.includeDetails (default on). With it on, rows also get platforms, impressionsMin / impressionsMax, impressionsByRegion and targeting wherever Google publishes them (EU/EEA disclosure). Turning it off skips the per-ad lookup and runs about twice as fast.onlyNewAds monitor mode. A scheduled run returns only ads that no earlier monitor run returned. Already-seen ads are never charged. The list of seen ads is kept in a named key-value store (monitorStoreName) on the user's account.startUrls; a keyword match or the advertiser's own domain never keeps a name) are now removed from every row, together with the advertiser id. The ad itself is still returned, url then points to the search page, and the new field advertiserNameRedacted is true. Business advertisers are unchanged.region is now also sent to Google as a search filter, so fewer ads are dropped and replaced. The check of each ad's confirmed country list stays as it was.region input now actually filters results. Verified against the live endpoint that Google's own region parameter has no effect on either SearchCreatives or GetCreativeById (the same advertiser/ad comes back identically for region=anywhere and for any specific country) — so setting region to e.g. US previously returned ads that never ran in the US. The Actor now checks each ad's real, confirmed regions list and drops (never charges for) any ad not confirmed for the requested region, automatically pulling in a replacement page when one is available. region: anywhere (the default) is unaffected.not_found row) instead of being marked failed; a run still fails when the source could not be read.Listing and settings update. The price list is unchanged.
First public release.
status, so a missing record (not_found) and a failure (error) are told apart from real data. Only ok rows are charged.