Google Ads Scraper [PPR]

Google Ads Transparency Scraper

Extracts ad creatives, advertiser profiles, targeting parameters, and regional impression data from Google Ads Transparency Center. Accepts keywords, domains, advertiser IDs, and full Transparency Center URLs as input. Returns structured JSON with text, image, and video ads across YouTube, Google Search, Google Shopping, Google Maps, and Google Play.

What data can you extract?

Field	Description	Availability
adCreativeId	Unique ad creative identifier (CR-prefixed)	Always
advertiserId	Advertiser account ID (AR-prefixed)	Always
advertiserName	Advertiser display name	Always
targetDomain	Advertiser's website domain	Domain searches
format	Ad type: TEXT, IMAGE, or VIDEO	Always
headline	Ad headline text	When present
description	Ad body copy	When present
imageUrl	URL to ad image asset	IMAGE ads
videoUrl	URL to ad video asset	VIDEO ads
previewUrl	Google-hosted ad preview URL	When available
firstShown	Earliest display date (YYYY-MM-DD)	Always
lastShown	Most recent display date (YYYY-MM-DD)	Always
totalDaysShown	Total days the ad ran	Always
region	Country filter applied (alpha-2 or WORLDWIDE)	Always
transparencyUrl	Direct link to ad on Transparency Center	Always
scrapedAt	Extraction timestamp (ISO 8601)	Always
regionBreakdown	Per-country impression ranges	With enrichment
variationCount	Number of creative variations	With enrichment

How to scrape Google Ads Transparency

1. Set Search Targets — Enter one or more keywords, domains (e.g. shopify.com), advertiser IDs (AR...), or full Transparency Center URLs. Mix types in the same run.
2. Apply filters — Select a Google platform (YouTube, Search, Shopping, Maps, Play), ad format (text, image, video), geographic region, and date range.
3. Set limits — Configure how many ads to collect per advertiser (Max Ads Per Target) and how many advertisers to process per keyword (Max Advertisers Per Keyword).
4. Enable enrichment (optional) — Toggle Scrape Ad Details to fetch regional impression breakdowns and variation counts. Slower but richer.
5. Start the run — Results appear in the dataset as the actor processes each target.
6. Export — Download as JSON, CSV, or JSONL from the dataset tab.

How much does it cost?

This actor uses pay-per-result pricing at $2.50 per 1,000 ads extracted.

Input mode	Typical platform cost per 1K	Notes
Direct advertiser ID	~$0.11	Fastest — skips search step
Domain search	~$0.11–$0.30	Fast, precise
Keyword search	~$0.30–$1.00	Multi-step: find advertisers, then ads

Examples:

• Scraping 1,000 ads from nike.com costs approximately $2.50
• Fetching 100 ads from a direct advertiser ID costs approximately $0.25
• A keyword search returning 200 ads across 3 advertisers costs approximately $0.50

Use cases

• Monitor competitor ad activity and creative history across Google platforms
• Track how long competitors run specific campaigns
• Identify which ad formats and platforms competitors invest in by region
• Research advertiser spend patterns using date range filters
• Build ad creative reference libraries for design teams
• Verify advertiser identity via public Transparency Center records
• Audit political and issue-based advertising in specific countries
• Feed ad intelligence into competitive analysis workflows

Input

Field	Type	Default	Description
searchTargets	string[]	—	Keywords, domains, advertiser IDs, or URLs (required)
maxAdsPerTarget	integer	100	Max ads per advertiser (0 = unlimited)
maxAdvertisersPerKeyword	integer	3	Max advertisers to process per keyword
platform	select	ALL	Filter by Google platform
adFormat	select	ALL	Filter by creative type
region	select	WORLDWIDE	Filter by country (48 countries)
dateRange	select	ALL_TIME	Filter by display period
scrapeDetails	boolean	false	Fetch enriched per-ad data

See the Input tab for all configuration options.

Output example

[
  {
    "adCreativeId": "CR12345678901234567890",
    "advertiserId": "AR04619580580634296321",
    "advertiserName": "Nike Retail BV",
    "targetDomain": "nike.com",
    "format": "IMAGE",
    "headline": "Just Do It",
    "description": "Shop the latest Nike collection.",
    "imageUrl": "https://tpc.googlesyndication.com/simgad/...",
    "previewUrl": "https://adstransparency.google.com/creativepreview/...",
    "firstShown": "2024-11-01",
    "lastShown": "2025-02-15",
    "totalDaysShown": 107,
    "region": "WORLDWIDE",
    "transparencyUrl": "https://adstransparency.google.com/advertiser/AR04619580580634296321/creative/CR12345678901234567890",
    "scrapedAt": "2026-02-22T14:30:00.000Z"
  }
]

Tips

• Fastest mode: Use advertiser IDs directly (AR...). Find them by running a domain search first, then reuse the advertiserId field from output.
• Keyword vs domain: Domain searches are faster and more precise. Keyword searches surface multiple advertisers and can return 3–5× more total ads.
• Enrichment trade-off: Scrape Ad Details adds regional impression data but roughly doubles run time. Enable it when you need regionBreakdown data.
• Date filters: Filters are sent to the Google API. Due to Google's data retention behavior, a small number of older ads may still appear — filter by firstShown/lastShown in post-processing for exact date control.
• Large runs: Set maxAdsPerTarget to 0 for unlimited extraction per advertiser. Combine with maxAdvertisersPerKeyword: 1 for depth over breadth.

FAQ

Can I filter ads by country? Yes — the Region filter supports 48 countries. Results include a region field with the applied filter. For impression data by country, enable Scrape Ad Details to get regionBreakdown.

What's the difference between keyword and domain search? Domain searches (nike.com) return ads from advertisers who registered that domain. Keyword searches find multiple advertisers and process each one. Domain is faster and more targeted; keyword is broader.

Does this return video ad content? Yes — VIDEO format ads include a videoUrl field. Enable Scrape Ad Details for additional metadata including variation counts and regional impression ranges.

What does adCreativeId look like? Each ad has a Google-assigned ID starting with CR (e.g., CR12345678901234567890). Use it with the transparencyUrl to reference the same ad across runs.

How far back does the data go? Google Ads Transparency Center covers ads from approximately March 2023 onward. Availability depends on the advertiser's activity history.