ssh.autos

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.

PER CALL · X402 / MPP Not yet Not available per call yet. Use the Apify actor meanwhile. Ask for it per call
APIFY STORE Public actor From $0.0015 per item. Open on Apify

Input options

FieldTypeDescriptionDefault
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

FieldTypeDescription
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"}}'

Open on Apify

Machine-readable: openapi.json · llms.txt

Some links to Apify are affiliate links. We may earn a commission if you sign up and become a paying customer.