Google Ads Scraper

Google Ads Scraper

Google Ads Scraper is a purpose-built Google Ads scraping tool that collects structured ad creative data from the public Google Ads Transparency portal. It helps you analyze PPC activity without manual copy-paste by extracting creatives, dates, and regional coverage at scale — ideal for marketers, developers, data analysts, and researchers running competitive benchmarking and market intelligence. As a streamlined Google Ads data extractor and PPC ad scraper tool, it enables automated, repeatable insight-gathering for ongoing monitoring and reporting.

What data / output can you get?

Below are the exact fields this AdWords scraper tool returns to the Apify dataset for each ad creative. You can export results to JSON or CSV directly from Apify.

Data type	Description	Example value
adLibraryUrl	Direct link to the creative in Google Ads Transparency	https://adstransparency.google.com/advertiser/AR04619580580634296321/creative/123456789
advertiserId	Unique advertiser identifier (AR…)	AR04619580580634296321
advertiserName	Display name of the advertiser	Example Advertising Company
creativeId	Unique ad creative identifier	123456789
creativeRegions	Countries/territories where the creative ran	["Canada","United Kingdom","United States"]
firstShown	First day the creative was seen (YYYY-MM-DD)	2024-01-15
format	Creative format derived from source data	IMAGE
lastShown	Last seen timestamp in ISO 8601 (UTC)	2024-11-20T10:30:45Z
previewUrl	Direct link to preview the creative asset (when available)	https://example.com/ad-image.jpg
regionStats[].regionCode	ISO 3166-1 alpha-2 code for region	US
regionStats[].regionName	Human-readable region/country name	United States
regionStats[].firstShown	Earliest date seen in that region	2024-01-15
regionStats[].lastShown	Latest date seen in that region	2024-11-20
regionStats[].impressions.lowerBound	Lower bound on impression range (static placeholder)	0
regionStats[].impressions.upperBound	Upper bound on impression range (static placeholder)	1000

Note: The actor outputs nested regionStats for per-country ranges and dates, along with a top-level list of creativeRegions. Export your dataset to JSON or CSV for analysis, dashboards, or pipelines.

Key features

• 🧠 Intelligent proxy fallback Uses direct connection first, then automatically switches to Apify datacenter proxy (GOOGLESERP group) and finally residential proxies to mitigate blocking and improve stability for this Google Ads scraping software.

• 📄 Structured creatives, dates, and regions Clean, predictable schema for adLibraryUrl, advertiser identifiers, format, first/last shown dates, preview URLs, and per-region stats — ready for analysis with your Google Ads competitor research tool workflows.

• 🔁 Pagination with token handling Built-in support for the Transparency portal’s paginated SearchCreatives endpoint to collect more items per advertiser efficiently.

• 💾 Live dataset saving Each creative is pushed to the Apify dataset as it’s processed to prevent data loss in long runs and support near-real-time consumption by your pipelines.

• 📈 Batch processing Feed multiple advertiser URLs or AR IDs to handle larger portfolios and ongoing Google Ads monitoring software use cases.

• 🌍 Region and date presets via URL Control scope by adding region (e.g., region=US or region=anywhere) and preset-date (e.g., Last+30+days, Last+90+days) query parameters to advertiser URLs.

• 👩‍💻 Developer-friendly Built on the Apify SDK (Python, aiohttp). Trigger via Apify, access datasets programmatically, and integrate with your existing automation as a lightweight Google Ads spy tool component.

• 🛡️ Production-ready resilience Detailed logging, input validation, and graceful error handling for dependable runs — a robust SERP ads scraper alternative for transparency data collection.

How to use Google Ads Scraper - step by step

1. Create or log in to your Apify account.
2. Open the Google Ads Scraper actor in the Apify Console.
3. In the Input tab, add one or more items to startUrls:
   • Advertiser URL: https://adstransparency.google.com/advertiser/AR04619580580634296321?region=anywhere
   • Advertiser ID: AR04619580580634296321
   • Optional in URL: add region (e.g., US) and preset-date (e.g., Last+30+days) as query parameters.
   • Note: Plain keyword inputs are currently skipped by the implementation.
4. Set maxItems to control how many creatives to collect per advertiser (1–1000; default 100).
5. Configure proxyConfiguration if needed. The actor will auto-fallback from direct to datacenter and residential proxies when blocking is detected.
6. Click Start to run. Monitor progress in real-time logs; items are saved to the dataset as they’re processed.
7. When complete, open the Dataset tab to preview results and export to JSON or CSV.

Pro Tip: Add preset-date (e.g., ?preset-date=Last+90+days) and region filters (e.g., ?region=US) to your advertiser URLs for targeted time frames and locales in your PPC ad scraper tool workflow.

Use cases

Use case name	Description
SEM competitor benchmarking	Track creatives per advertiser over time to benchmark messaging, formats, and regional activity for strategic planning.
Market intelligence by region	Measure geographic coverage and rollout timing to quantify expansion patterns and campaign emphasis.
Creative performance timelines	Analyze first/last seen windows to infer campaign durations and flighting across markets.
Compliance and transparency oversight	Monitor public transparency data to support governance and audit workflows with consistent, structured records.
Academic and policy research	Collect longitudinal transparency data for studies on advertising reach, formats, and regional distribution.
ETL into analytics pipelines	Feed exported JSON/CSV into BI tools or data lakes to power dashboards, alerts, and reporting.

Why choose Google Ads Scraper?

Google Ads Scraper emphasizes precision, automation, and reliability for extracting transparency-backed ad creatives at scale.

• ✅ Accuracy-first output: Structured fields for creatives, dates, and regions — consistent schema for downstream analysis.
• 🌍 Regional and time controls: Drive scope via URL query parameters like region and preset-date for focused datasets.
• 📦 Scale-ready batching: Process multiple advertiser IDs/URLs in one run for ongoing monitoring initiatives.
• 👩‍💻 Developer access: Built on the Apify SDK, making it easy to automate and consume datasets in your stack.
• 🔒 No login flow: Works against public Google Ads Transparency endpoints — no cookies or account requirements.
• 🧰 Robust proxy strategy: Automatic fallback from direct to datacenter, then residential proxies to reduce blocking.
• 💰 Stable alternative to extensions: Avoid brittle browser add-ons with a server-side Google Ads scraping tool that’s production-ready.

Bottom line: If you need a dependable Google Ads scraping software component for structured creatives and regional insights, this actor delivers a clean, automation-friendly dataset.

Is it legal / ethical to use Google Ads Scraper?

Yes — when done responsibly. This actor collects data from the public Google Ads Transparency portal and does not access authenticated or private information.

Guidelines for responsible use:

• Only use publicly available transparency data.
• Comply with relevant regulations (e.g., GDPR, CCPA) and organizational policies.
• Review and respect applicable terms of service.
• Do not use scraped data for spam or abusive practices.
• Consult your legal team for edge cases or jurisdiction-specific requirements.

Input parameters & output format

Example JSON input

{
  "startUrls": [
    "https://adstransparency.google.com/advertiser/AR04619580580634296321?region=US&preset-date=Last+90+days",
    "AR04619580580634296321",
    "https://adstransparency.google.com/advertiser/AR12345678901234567890?region=anywhere"
  ],
  "maxItems": 150,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}

Parameters

• startUrls (array, required): List one or more Google Ads Transparency advertiser URLs (e.g., https://adstransparency.google.com/advertiser/AR04619580580634296321) or advertiser IDs (e.g., AR04619580580634296321). Note: While the schema mentions keywords, the current implementation logs “Keywords not supported yet. Skipping” and ignores them. Default: none.
• maxItems (integer, optional): Maximum number of ad creatives to scrape per advertiser (1–1000). Default: 100.
• proxyConfiguration (object, optional): Configure proxy settings for reliable scraping. If blocking occurs, the actor will automatically fall back to datacenter and then residential proxies. Default prefill: {"useApifyProxy": false}.

Example JSON output

{
  "adLibraryUrl": "https://adstransparency.google.com/advertiser/AR04619580580634296321/creative/123456789",
  "advertiserId": "AR04619580580634296321",
  "advertiserName": "Example Advertising Company",
  "creativeId": "123456789",
  "creativeRegions": ["Canada", "United Kingdom", "United States"],
  "firstShown": "2024-01-15",
  "format": "IMAGE",
  "lastShown": "2024-11-20T10:30:45Z",
  "previewUrl": "https://example.com/ad-image.jpg",
  "regionStats": [
    {
      "regionCode": "US",
      "regionName": "United States",
      "firstShown": "2024-01-15",
      "lastShown": "2024-11-20",
      "impressions": {
        "lowerBound": 0,
        "upperBound": 1000
      }
    },
    {
      "regionCode": "CA",
      "regionName": "Canada",
      "firstShown": "2024-02-01",
      "lastShown": "2024-11-18",
      "impressions": {
        "lowerBound": 0,
        "upperBound": 1000
      }
    }
  ]
}

Notes

• Required vs optional: startUrls is required; maxItems and proxyConfiguration are optional.
• Field variations: format is mapped when available (2 → IMAGE, 3 → VIDEO). If a format code is not recognized, the value may be "UNKNOWN".
• previewUrl availability: Not all creatives include a preview URL; the field may be null/omitted depending on source data.
• Dates: If timestamps are missing or malformed, fallback defaults may be used by the processor.

FAQ

Does this scrape Google SERP ads or Shopping ads directly?

No. This actor targets the Google Ads Transparency portal’s SearchCreatives endpoint and outputs transparency-backed creatives and metadata. If you need a Google search ads scraper or Google Shopping ads scraper that captures live SERP placements, consider a different, specialized solution.

Can I input keywords to find advertisers?

Not currently. While the input schema mentions keywords, the implementation skips plain keywords and logs a warning. Use advertiser URLs or AR IDs instead.

How many advertisers can I process in one run?

You can include multiple advertiser URLs/IDs in startUrls. The actor processes them sequentially with pagination and pushes results to the dataset as it goes.

How do I limit or expand the time range?

Append a preset-date query parameter to the advertiser URL, such as preset-date=Last+30+days, Last+90+days, Last+365+days. If no preset is provided, the actor defaults to the last 365 days.

Can I filter by region or collect “anywhere” results?

Yes. Add region=US (or another country code) to scope results, or set region=anywhere for broader coverage. These are URL query parameters on the advertiser page.

Do I need to log in or provide cookies?

No. The actor uses public endpoints on the Google Ads Transparency portal and does not require authentication.

What happens if I get blocked?

The actor starts with a direct connection and automatically falls back to Apify datacenter proxies (GOOGLESERP group), then residential proxies if needed. You can also configure proxyConfiguration upfront.

In what formats can I export the data?

Results are stored in an Apify dataset. From the Apify Console, you can export to JSON or CSV and integrate the dataset into your workflows or pipelines.

Closing CTA / Final thoughts

Google Ads Scraper is built to extract structured, transparency-backed Google Ads creative data reliably and at scale. With clean fields for creatives, regions, and timelines — plus automatic proxy fallback and live dataset saving — it’s a dependable foundation for competitor research, market intelligence, and ongoing monitoring. Marketers, analysts, and developers can quickly feed JSON/CSV into dashboards or automation, and programmatically consume datasets via the Apify platform. Start extracting smarter insights from the Google Ads Transparency portal and power your PPC analytics with a stable, automation-ready workflow.