Google Ads Transparency Scraper API — Competitor Ads, $0.50/1K avatar

Google Ads Transparency Scraper API — Competitor Ads, $0.50/1K

Pricing

from $0.50 / 1,000 ad scrapeds

Go to Apify Store
Google Ads Transparency Scraper API — Competitor Ads, $0.50/1K

Google Ads Transparency Scraper API — Competitor Ads, $0.50/1K

Scrape every ad a company runs on Google (Search, YouTube, Shopping, Maps, Play) from the Ads Transparency Center, by domain, brand or advertiser ID: format, first/last shown, days active, previews; optional countries, impressions, variations and ad text. $0.50 per 1,000 ads, no login.

Pricing

from $0.50 / 1,000 ad scrapeds

Rating

0.0

(0)

Developer

Sherwood

Sherwood

Maintained by Community

Actor stats

0

Bookmarked

2

Total users

1

Monthly active users

13 days ago

Last modified

Features

Limited permissions

Share

Returns every ad a company runs on Google (Search, YouTube, Shopping, Maps, Play) from the Google Ads Transparency Center, as one dataset item per ad creative, for $0.50 per 1,000 ads. Look up a website (nike.com), a brand name (Nike), an advertiser ID (AR…) or a Transparency Center URL. No login, no API key, no browser.

Built for AI agents and workflows (MCP clients, n8n, Make, Python): the default input runs alone in a few seconds, nothing is required, every list also accepts a plain string, and failures are never charged.

What you get

One item per ad creative (a real run on decathlon.fr, region FR, with includeDetails):

{
"creativeId": "CR03939502093047431169",
"advertiserId": "AR15666691663760195585",
"advertiserName": "Decathlon France SASU",
"domain": "decathlon.fr",
"format": "IMAGE",
"firstShown": "2026-01-21T15:02:11Z",
"lastShown": "2026-11-08T09:17:03Z",
"shownForDays": 283,
"region": "FR",
"adUrl": "https://adstransparency.google.com/advertiser/AR15666691663760195585/creative/CR03939502093047431169?region=FR",
"previewType": "rendered",
"imageUrl": null,
"previewUrl": "https://displayads-formats.googleusercontent.com/ads/preview/content.js?client=ads-integrity-transparency&…",
"width": null,
"height": null,
"query": "decathlon.fr",
"queryAdsMin": 20000,
"queryAdsMax": 30000,
"status": "ok",
"error": null,
"advertiserLegalName": "Decathlon France SASU",
"variationCount": 3,
"variations": [{"previewType": "rendered", "previewUrl": "https://…content.js?…", "imageUrl": null, "width": null, "height": null}],
"regionsShown": [
{"region": "FR", "firstShownDate": "2026-01-21", "lastShownDate": "2026-11-08", "firstShownOnOrBefore": "2026-01-21",
"impressionsMin": 2250000, "impressionsMax": 2500000,
"platformImpressions": [{"platformCode": 3, "platform": "SEARCH", "impressionsMin": 2250000, "impressionsMax": 2500000},
{"platformCode": 4, "platform": "SHOPPING", "impressionsMin": 2000, "impressionsMax": 3000}]}
],
"impressionsMin": 2250000,
"impressionsMax": 2500000,
"platformCodes": [3, 4, 5],
"platforms": ["SEARCH", "SHOPPING", "YOUTUBE"],
"audienceSelection": {"demographicInfo": null, "geographicLocations": "included and excluded", "contextualSignals": "included and excluded", "topicsOfInterest": null, "customerLists": null},
"adText": "GARMIN - Compteur vélo gps Garmin Edge Explore 2 - compteur gps vélo - velo tout chemin randonnee - Decathlon",
"adHeadline": "GARMIN - Compteur vélo gps Garmin Edge Explore 2 - compteur gps vélo - velo tout chemin randonnee - Decathlon",
"adDescription": null,
"headlines": ["GARMIN - Compteur vélo gps Garmin Edge Explore 2 - compteur gps vélo - velo tout chemin randonnee - Decathlon"],
"displayUrl": "Decathlon.fr",
"landingPage": null,
"videoId": null,
"detailError": null
}
FieldAlwaysMeaning
creativeId, advertiserIdyesGoogle's stable ids (CR…, AR…). Items are de-duplicated by creativeId across queries.
advertiserName, domainyesAdvertiser account name; destination domain (known for domain searches, null when you search by advertiser ID or brand).
formatyesTEXT, IMAGE or VIDEO, as Google classifies the creative.
firstShown, lastShown, shownForDaysyesISO 8601 UTC; shownForDays is Google's count of days the ad was shown (longevity signal).
region, adUrlyesThe region you asked for; the public ad page.
previewType, imageUrl, width, height, previewUrlyesimage: a direct CDN image. rendered: Google's preview bundle (text, video and rich ads).
queryAdsMin, queryAdsMaxyesGoogle's estimate of how many ads the query has in total, e.g. 20,000 to 30,000 for decathlon.fr.
status, erroryesok; skipped with a message when a query has no ad; error when Google refused or the input was wrong.
advertiserLegalName, variationCount, variationsdetailsLegal name of the paying advertiser; every A/B variation with its preview.
regionsShown, impressionsMin, impressionsMax, platformCodes, platforms, audienceSelectiondetailsEvery country the ad ran in, with first and last dates, Google's "times shown" range and its split by platform; totals are the sums over countries. Google publishes impressions, platforms and audience criteria only for ads shown in the EU (Digital Services Act); elsewhere these fields are null.
adText, adHeadline, adDescription, headlines, displayUrl, landingPage, videoIddetailsRead from the preview bundle without a browser: the visible text lines, the display URL, the landing page when the bundle carries it, the YouTube video id of video ads. Plain image ads have no text.

Advertiser mode (resultType: advertisers) returns one item per advertiser account instead: advertiserName, advertiserId, advertiserCountry, adsMin, adsMax, advertiserVerified, domain, runsGoogleAds.

Input

FieldTypeDefaultNotes
queriesarray of strings["nike.com"]Websites, brand names, advertiser IDs (AR + 20 digits) or adstransparency.google.com URLs (advertiser or creative page). Aliases: query (string, comma or newline separated), domains, advertiserIds, startUrls. Everything is merged. A brand name is resolved to its largest advertiser accounts (5 at most).
regionstringANYWHERETwo-letter country code (US, FR), English country name, or ANYWHERE.
adFormatALL / TEXT / IMAGE / VIDEOALL
platformsarray of SEARCH, YOUTUBE, MAPS, PLAY, SHOPPINGallGoogle's own platform filter, sent to Google (not applied after the fact).
startDate, endDateYYYY-MM-DDnoneAds whose shown period overlaps the window. Google keeps the last 12 months of dates. One bound alone is completed (today / 12 months before).
maxAdsPerQueryinteger10040 ads per page. Big advertisers have tens of thousands (we read 4,800 Nike ads in one go while measuring).
maxAdsinteger1000Cap for the whole run.
includeDetailsbooleanfalseOne extra request per ad (see the table above).
resultTypeads / advertisersadsadvertisers: does this company run Google Ads? One cheap request per query.
proxyConfigurationobjectApify datacenter proxiesSessions are rotated and paced; a residential IP is tried once when Google refuses.

Minimal calls:

{"queries": ["nike.com", "adidas.com"], "region": "US", "maxAdsPerQuery": 200}
{"query": "Decathlon", "region": "FR", "platforms": ["YOUTUBE"], "startDate": "2026-10-01"}
{"queries": ["https://adstransparency.google.com/advertiser/AR18378488041124659201/creative/CR01855627099679752193?region=FR"], "includeDetails": true}
{"queries": ["qonto.com", "Allianz", "my-prospect.com"], "resultType": "advertisers"}

Pricing

Pay per event, nothing up front:

EventPriceWhen
Ad scraped (result)$0.0005 ($0.50 per 1,000)One ad creative delivered, or one advertiser row in advertiser mode.
Ad detail (ad-detail)$0.0005 ($0.50 per 1,000)One ad enriched with includeDetails, only when Google answered.
Actor start$0.00005Per run.

Duplicates, errors and queries with no ad are never charged. 1,000 fully detailed ads cost $1; the same data costs $2 to $7 per 1,000 on the most used alternatives. The run uses 256 MB of memory, so platform usage is a few cents per 10,000 ads.

Accuracy, measured

  • 16-case panel (12 sectors, 9 countries, 3 languages; domains, brands, advertiser IDs, creative URLs, format and date filters, advertiser mode), every run green, 521 ads, every field at 100 % coverage except what depends on the ad (imageUrl for image ads, text for rendered ads, impressions for EU ads).
  • Same inputs as the most used alternative (scrapesage/google-ads-transparency-scraper, 3 searches × 40 ads): 100 % agreement on advertiser name, format, first and last shown dates, days shown and image URL on every common ad (91 of 91).
  • Dates and ids come straight from Google's own data; format, shownForDays and the impressions ranges are Google's values, not estimates.

How to run it

API

curl -X POST "https://api.apify.com/v2/acts/sherwood~google-ads-transparency-scraper/run-sync-get-dataset-items?token=$APIFY_TOKEN" \
-H "Content-Type: application/json" \
-d '{"queries": ["nike.com"], "region": "US", "maxAdsPerQuery": 100}'

Python

from apify_client import ApifyClient
client = ApifyClient("APIFY_TOKEN")
run = client.actor("sherwood/google-ads-transparency-scraper").call(run_input={"queries": ["decathlon.fr"], "region": "FR", "includeDetails": True})
for ad in client.dataset(run["defaultDatasetId"]).iterate_items():
print(ad["format"], ad["shownForDays"], ad.get("adHeadline"), ad["adUrl"])

n8n / Make: the official Apify node, Actor sherwood/google-ads-transparency-scraper, input as above. MCP: any client connected to the Apify MCP server can call it by name; the input schema tells the agent what to pass.

Schedules: pair it with Apify Schedules and startDate to watch a competitor's new ads every week.

Use it from an AI coding agent

Install the task skill for Claude Code, Codex, Cursor, Gemini CLI or any agent that reads the Agent Skills format:

$npx skills add maxouf/sherwood-skills --skill google-ads-transparency-scraper

The skill compares this Actor with the other tools for the task, estimates the cost before running, caps the spend and hands back the result as a file. The pipeline skill apify-competitor-watch chains it with the other Actors of the use case. Source: github.com/maxouf/sherwood-skills.

Limits, honestly

  • Source: the Transparency Center's own interface data, read by HTTP. Google can change it; the Actor is tested every day on its default input.
  • Platforms: the five surfaces are Google Search, YouTube, Google Maps, Google Play and Google Shopping; the Display Network is not part of the Transparency Center. Platform data exists for ads shown on or after 2023-09-04.
  • Impressions, platform split and audience criteria exist only for ads shown in the EU. Outside the EU you get them on ads that also ran in an EU country (common for global brands).
  • Dates: Google keeps 12 months of shown dates. A window that ends earlier returns nothing.
  • Ad text: plain image ads carry no text. Shopping ads are assembled by feed vendors, whose host can appear before the advertiser's link; landingPage prefers a host matching the ad's domain.
  • Speed: Google slows down an IP after a burst, so each proxy session is paced at one request every two seconds and the Actor runs several in parallel. 100 ads take a few seconds; 400 ads with details, a few minutes.
  • Advertiser name vs domain: searching by advertiser ID or brand gives no domain (Google does not return it on those searches).

FAQ

Is there an official Google Ads Transparency API? No. The Center is a public website; this Actor reads the same data its pages load, with no login.

Can I get all ads of a big brand? Yes: raise maxAdsPerQuery and maxAds. Pagination has no fixed cap (4,800 Nike ads were read in one measurement).

Does it work for political ads? It returns them like any other ad; the political-ads surface with spend ranges is not covered yet.

Which countries have impressions? EU member states, under the Digital Services Act. Use an EU region to get them on nearly every ad.