Google Ads Transparency Scraper

Scrape Google Ads Transparency Center for competitor ad research. See ad copy, creatives, targeting, and spend estimates for any advertiser.

Features

• Ad copy extraction - Headlines, descriptions, and call-to-actions
• Creative assets - Images and videos from display/YouTube ads
• Targeting insights - Regions, platforms, and date ranges
• Advertiser research - Search by company name or direct URL
• Historical data - Access ads from the past 7 days to all-time
• Multi-format support - Text, image, video, and responsive ads

Quick Start

{
  "input": "your input here"
}

Demo Mode

Set demoMode: true to test with sample data (no charges). When you're ready for real results, set demoMode: false or omit it.

{
  "demoMode": true,
  ...
}

Input Parameters

{
  "advertiserName": "Nike",
  "region": "US",
  "platform": "ALL",
  "dateRange": "30_DAYS",
  "maxAds": 50,
  "includeCreatives": true
}

Input Parameters

Parameter	Type	Default	Description
advertiserName	string	-	Company/advertiser name to search
advertiserUrl	string	-	Direct URL to advertiser's page
searchQuery	string	-	Search ads by keyword
region	string	"US"	Filter by country (US, GB, CA, AU, DE, FR, etc.)
adFormat	string	"ALL"	Filter by format (TEXT, IMAGE, VIDEO, ALL)
platform	string	"ALL"	Filter by platform (SEARCH, YOUTUBE, DISPLAY, SHOPPING)
dateRange	string	"30_DAYS"	Time range (7_DAYS, 30_DAYS, 90_DAYS, 1_YEAR, ALL_TIME)
maxAds	number	50	Maximum ads to scrape
includeCreatives	boolean	true	Download ad images/videos
demoMode	boolean	true	Run with sample data

Output Format

{
  "advertiserName": "Nike",
  "advertiserUrl": "https://adstransparency.google.com/advertiser/Nike",
  "adId": "AD-1704412800000-0",
  "adFormat": "IMAGE",
  "adContent": "Official Site - Free Shipping - Shop the latest collection...",
  "headline": "Official Site - Free Shipping",
  "description": "Shop the latest collection. Free returns on all orders.",
  "displayUrl": "www.nike.com",
  "callToAction": "Shop Now",
  "imageUrl": "https://example.com/ad-creative-0.jpg",
  "lastShown": "2026-01-03",
  "firstShown": "2025-11-15",
  "region": ["US"],
  "platform": ["DISPLAY"],
  "estimatedImpressions": "100K-1M",
  "verified": true,
  "scrapedAt": "2026-01-05T00:00:00.000Z"
}

Pricing

This actor uses pay-per-event billing: This actor uses pay-per-event pricing:

Event	Description	Price
ad_scraped	Per ad scraped	$0.01

Example costs:

• Scrape 50 ads: 50 × $0.01 = $0.50
• Scrape 200 ads: 200 × $0.01 = $2.00

Use Cases

• Competitive analysis - See what ads your competitors are running
• Ad copy inspiration - Find proven messaging in your industry
• Market research - Understand advertising trends by sector
• Client pitches - Show prospects what competitors are doing
• Brand monitoring - Track when companies run ads about you

---

Common Problems & Solutions

"Invalid API key" error

Cause: Your API key is wrong, expired, or doesn't have the right permissions. Fix: Double-check your API key. Make sure you copied it exactly without extra spaces.

"Rate limit exceeded" error

Cause: You've hit the API's rate limits. Fix: Wait a few minutes, then try again. Consider reducing the number of concurrent requests.

Empty or incomplete results

Cause: The target may have anti-scraping protection or the data doesn't exist. Fix:

• Check if the URL/search query is correct
• Try with different parameters
• Some sites may block automated access

Demo data showing instead of real results

Cause: demoMode is still set to true. Fix: Set demoMode: false and provide your API key(s).

---

Built by John Rippy | Actor Arsenal