Scrape Google Ads Transparency Center data: text, image, and video ads with clean headlines, body copy, CTAs, and business details. Get political ad spend and impression ranges most scrapers miss, plus advertiser verification info.
Added assetProxyConfiguration — an optional separate proxy for preview, image, and video downloads. These CDN endpoints account for roughly 90% of a run's traffic, so routing them to cheap flat-rate bandwidth cuts metered proxy usage by ~90%. Can also be set once for every run via the ASSET_PROXY_URL environment variable. Downloads automatically retry through the main proxy if this one fails, so results are never affected. Leave unset to keep the previous behaviour.
Reduced wasted bandwidth when resultsLimit is set: ad listings are now requested in pages sized to what is still needed, instead of always fetching 100 at a time.
1.0.0
Initial release.
Scrape text, image, and video ads from any advertiser on the Google Ads Transparency Center
Find advertisers by Transparency Center link, website domain, or plain name
Clean, structured ad copy — headline, body, call-to-action, business details — for the large majority of ads, including image-based product ads
Political ad spend and impression ranges, plus targeted regions
Optional text recovery for image-only ads that don't otherwise expose readable copy
Video ads resolved to a downloadable video file
Advertiser legal name, home country, and verification status included automatically
Duplicate ad variations filtered out
Fast listing-only mode for large-scale or frequent monitoring runs
Optional permanent storage of videos and ad previews
