Catalog / Search, maps & leads
SEARCH, MAPS & LEADS
Google Ads Transparency | Google Ads Library & Ad Spy
Scrape the Google Ads Transparency Center (Google Ads Library) by brand, domain or advertiser ID: every ad with format, dates, creatives, platforms and regions.
Input options
| Field | Type | Description | Default |
|---|---|---|---|
advertisers |
array | Advertiser names (Nike), domains (nike.com) or advertiser IDs (AR06641858037806006273). Links copied from the Google Ads Transparency Center also work: an advertiser page, an ad's page or a domain search. Each entry lists that advertiser's ads. | |
dateRange |
object | Optional: only ads served between these days. Leave a side empty for an open range. Dates are YYYY-MM-DD. | |
format |
string | Limit results to one ad format. | all |
includeDetails |
boolean | Fetch each ad's detail page for the countries it was shown in with their own dates, landing page and impressions. This costs one extra request per ad, so the run is slower. | false |
maxAdsPerAdvertiser |
integer | Stop each advertiser account after this many ads. A domain or name can match several accounts (nike.com matches five), and the limit applies to each one. | 50 |
maxAdvertisersPerName |
integer | How many matching advertiser accounts a name (Nike) lists: the exact match first, then the closest matches. Leave empty for the single best match. | |
monitorName |
string | Optional, with Only new ads: a name for this watch (for example competitors-us), so separate schedules keep separate histories. Leave empty to share one history per advertiser. | |
onlyNewSinceLastRun |
boolean | Return only ads this actor has not delivered before. Run the same input on a schedule and each run returns just the new ads, which makes the Actor an alert feed of new creatives. | false |
platforms |
array | Optional: only ads shown on these Google platforms. Leave empty for every platform. | |
region |
string | Only ads shown in this country, as a two-letter country code (US, GB, DE...), or all for every country. | all |
Output schema
| Field | Type | Description |
|---|---|---|
adId |
string | The creative ID of the ad. |
advertiserCountry |
string, null | The advertiser's country as the Transparency Center lists it (two-letter code). |
advertiserId |
string | The advertiser's transparency centre ID. |
advertiserLegalName |
string, null | The advertiser's verified legal name, when published. |
advertiserName |
string, null | The advertiser name as the transparency centre shows it. |
advertiserUnverified |
boolean, null | Whether the transparency centre marks the advertiser as unverified. |
advertiserVerified |
boolean, null | Whether the advertiser completed Google's advertiser verification. |
containsSyntheticMedia |
boolean, null | Whether the ad is flagged as containing synthetic media. Only with includeDetails. |
endPayerName |
string, null | Who paid for the ad, when the transparency centre publishes it. Only with includeDetails. |
firstShown |
string, null | First day the ad was shown, YYYY-MM-DD. |
format |
string, null | Ad format: text, image or video. |
imageUrls |
array | Image links in the ad's rendered creative. |
impressionsLowerBound |
integer, null | Lower bound of the published impression range. Only with includeDetails, and only for ads that publish it. |
impressionsUpperBound |
integer, null | Upper bound of the published impression range. Only with includeDetails. |
kind |
string | Every dataset row is one ad. Advertisers that failed or stopped early are listed in OUTPUT.advertiserErrors and are never dataset rows. |
landingUrl |
string, null | The ad's landing page when the transparency centre publishes it. Only with includeDetails. |
lastShown |
string, null | Last day the ad was shown, YYYY-MM-DD. |
matchedDomain |
string, null | The domain the ad matched, when the advertiser was found through a domain. |
platforms |
array, null | Google platforms the ad was shown on (search, youtube, shopping, maps, play), when the detail page publishes them. Only with includeDetails. |
previewHtml |
string, null | The small HTML snippet the transparency centre renders for this ad. |
previewUrl |
string, null | The ad's own preview/player URL, when it has one. |
regionShownDates |
array, null | Per country the ad was shown in: its own first and last day and impression range. Only with includeDetails. |
regions |
array, null | Countries the ad was shown in, as ISO 3166-1 alpha-2 codes. Empty unless includeDetails is on, because the ad list does not carry regions. |
scrapedAt |
string | Collection time (UTC). |
searchInput |
string | The advertisers entry this row came from. |
servedDays |
integer, null | How many days the transparency centre says the ad was served. |
targeting |
object, null | The targeting the detail page publishes: demographics, geography, contextual, topicsOfInterest and customerLists (included, excluded or null) plus included and excluded regions. Only with includeDetails, and only when the source publishes it. |
text |
string, null | Ad copy when the source publishes it as text. The transparency centre renders most ads as images, so this is usually null. |
transparencyUrl |
string | Link to the ad in the Google Ads Transparency Center. |
variantCount |
integer, null | How many rendering variants the detail answer carries. Only with includeDetails. |
videoUrls |
array | Direct video links. The transparency centre serves video ads as an HTML5 player, so this is empty and previewUrl holds the player. |
About this data
Scrape the Google Ads Transparency Center (Google Ads Library) by brand, domain or advertiser ID: every ad with format, dates, creatives, platforms and regions. Filter by country, date, format and YouTube/Search/Shopping. Only-new-ads mode for scheduled ad alerts.
Run it on Apify
This data source is a public actor on the Apify Store: Google Ads Transparency Scraper | Google Ads Library & Ad Spy. Run it with your Apify account and plan for larger, scheduled or exported runs.
Run command
# MCP prompt for Claude/Cursor/Muse
Use the Apify connector to run automatic/google-ads-transparency-scraper with the input schema defined on Apify.
# Apify CLI / curl
apify call automatic/google-ads-transparency-scraper -i '{"advertisers":{"description":"Advertiser names (Nike), domains (nike.com) or advertiser IDs (AR06641858037806006273). Links copied from the Google Ads Transparency Center also work: an advertiser page, an ad's page or a domain search. Each entry lists that advertiser's ads.","editor":"stringList","items":{"maxLength":200,"minLength":1,"type":"string"},"prefill":["nike.com"],"title":"Advertisers","type":"array"},"dateRange":{"additionalProperties":false,"description":"Optional: only ads served between these days. Leave a side empty for an open range. Dates are YYYY-MM-DD.","editor":"json","properties":{"from":{"description":"First day of the range, YYYY-MM-DD.","editor":"textfield","title":"From","type":"string"},"to":{"description":"Last day of the range, YYYY-MM-DD.","editor":"textfield","title":"To","type":"string"}},"title":"Date range","type":"object"},"format":{"default":"all","description":"Limit results to one ad format.","editor":"select","enum":["all","text","image","video"],"enumTitles":["All formats","Text","Image","Video"],"prefill":"all","title":"Ad format","type":"string"},"includeDetails":{"default":false,"description":"Fetch each ad's detail page for the countries it was shown in with their own dates, landing page and impressions. This costs one extra request per ad, so the run is slower.","prefill":false,"title":"Include ad details","type":"boolean"},"maxAdsPerAdvertiser":{"default":50,"description":"Stop each advertiser account after this many ads. A domain or name can match several accounts (nike.com matches five), and the limit applies to each one.","editor":"number","maximum":5000,"minimum":1,"prefill":50,"title":"Maximum ads per advertiser","type":"integer"},"maxAdvertisersPerName":{"description":"How many matching advertiser accounts a name (Nike) lists: the exact match first, then the closest matches. Leave empty for the single best match.","editor":"number","maximum":20,"minimum":1,"nullable":true,"title":"Advertisers per name","type":"integer"},"monitorName":{"description":"Optional, with Only new ads: a name for this watch (for example competitors-us), so separate schedules keep separate histories. Leave empty to share one history per advertiser.","editor":"textfield","title":"Watch name","type":"string"},"onlyNewSinceLastRun":{"default":false,"description":"Return only ads this actor has not delivered before. Run the same input on a schedule and each run returns just the new ads, which makes the Actor an alert feed of new creatives.","prefill":false,"title":"Only new ads since the last run","type":"boolean"},"platforms":{"description":"Optional: only ads shown on these Google platforms. Leave empty for every platform.","editor":"select","items":{"enum":["search","youtube","shopping","maps","play"],"enumTitles":["Google Search","YouTube","Google Shopping","Google Maps","Google Play"],"type":"string"},"title":"Google platforms","type":"array"},"region":{"default":"all","description":"Only ads shown in this country, as a two-letter country code (US, GB, DE...), or all for every country.","editor":"textfield","prefill":"all","title":"Region","type":"string"}}'
Machine-readable: openapi.json · llms.txt