Google Ads Scraper

Google Ads Scraper

Google Ads Scraper is a production-ready Apify actor that extracts ad creatives and advertiser metadata from the Google Ads Transparency portal. It solves the challenge of programmatically collecting structured transparency records (creatives, regions, and dates) for PPC analysis and compliance. As a Google Ads scraping tool and Google Ads competitor analysis tool, it’s ideal for marketers, developers, data analysts, and researchers who need verified transparency data at scale.

What data / output can you get?

Data type	Description	Example value
adLibraryUrl	Direct link to the ad creative in Google Ads Transparency	https://adstransparency.google.com/advertiser/AR04619580580634296321/creative/123456789
advertiserId	Unique Google advertiser identifier (AR…)	AR04619580580634296321
advertiserName	Name of the advertising company	Example Advertising Company
creativeId	Unique ad creative identifier	123456789
creativeRegions	Sorted list of countries/territories where the ad was shown (names)	["Canada", "United Kingdom", "United States of America"]
firstShown	Earliest known date the creative appeared (YYYY-MM-DD)	2024-01-15
format	Creative format (IMAGE, VIDEO, or UNKNOWN)	IMAGE
lastShown	Most recent datetime the creative appeared (ISO 8601, UTC)	2024-11-20T10:30:45Z
previewUrl	Media preview URL for the creative (image/video/script when available)	https://example.com/ad-image.jpg
regionStats	Array of per-region stats with codes, names, dates, and impression bounds	[{"regionCode":"US","regionName":"United States of America","firstShown":"2024-01-15","lastShown":"2024-11-20","impressions":{"lowerBound":0,"upperBound":1000}}]

Notes:

• regionStats items include regionCode (ISO-like), regionName, firstShown, lastShown, and impressions.lowerBound/upperBound.
• Data exports are available from the Apify dataset in JSON, CSV, or Excel.

Key features

• 🔁 Robust proxy fallback Automatically escalates from direct connection to Apify datacenter proxies (GOOGLESERP group) and then residential proxies if blocking is detected — ensuring high success for this Google Ads scraper API workflow.

• 📥 URL & ID input (no-login) Accepts Google Ads Transparency advertiser page URLs and AR advertiser IDs without authentication or cookies. No browser extension required — a lightweight alternative to a Google Ads scraper Chrome extension.

• 📑 Pagination with live saving Handles multi-page responses using pagination tokens and pushes each creative to the dataset as it’s processed to prevent data loss during long runs.

• 🌍 Region & date awareness Respects region parameters (e.g., region=US or region=anywhere) and supports date presets via URL (e.g., preset-date=Last+30+days), making it a reliable SERP ads extractor alternative for transparency datasets.

• ⚙️ Developer friendly Built on Apify’s Python SDK (aiohttp for async), easy to automate and integrate into pipelines — great for teams seeking a Google Ads scraper Python integration.

• 📈 Scales with your workflow Process multiple advertiser inputs in one run with rate limiting and structured outputs suitable for BI dashboards, PPC competitor ad scraper projects, and audits.

• 🧱 Production-grade reliability Detailed logging, retry logic, graceful error handling, and dataset verification at the end of the run.

Important:

• Keywords in startUrls are currently not supported by runtime logic and will be skipped (only advertiser URLs or AR IDs are processed).

How to use Google Ads Scraper - step by step

1. Create or log in to your Apify account at https://console.apify.com.
2. Open the Google Ads Scraper actor (search for “google-ads-scraper”) in the Apify Store.
3. Prepare your inputs:
   • Use full advertiser page URLs like: https://adstransparency.google.com/advertiser/AR04619580580634296321?region=anywhere
   • Or provide advertiser IDs like: AR04619580580634296321
   • Note: Keywords will be skipped by the current implementation.
4. Configure limits and proxies:
   • Set maxItems (per advertiser) to control volume.
   • Leave proxyConfiguration as-is or enable Apify Proxy; the actor auto-falls back to datacenter then residential proxies if needed.
5. (Optional) Add query parameters to the advertiser URL:
   • region=US to scope by country, or region=anywhere for global coverage.
   • preset-date=Last+30+days (also supports Last+7+days, Last+90+days, Last+365+days). If omitted, it defaults to the last 365 days.
6. Run the actor and watch logs for progress (you’ll see pagination, proxy changes, and item counts).
7. Access results in the Run’s Dataset (OUTPUT) and export as JSON, CSV, or Excel.
8. Pro Tip: Orchestrate via the Apify API and your favorite automation (Python scripts, webhooks, data pipelines) to operationalize a Google Ads competitor analysis tool at scale.

Use cases

Use case name	Description
PPC competitor analysis	Track creatives, formats, and activity timelines to benchmark strategies using a structured Google Ads data extractor.
Compliance & transparency audits	Document regional exposure and display dates for regulatory reporting and brand governance.
Market & trend research	Analyze campaign volume and format mix across countries to identify trends in your category.
Creative cataloging	Build a repository of IMAGE/VIDEO creatives per advertiser with links suitable for review workflows.
Academic/NGO research	Study transparency records across geographies and time windows for policy or media research.
API-driven pipelines	Feed structured transparency outputs into BI tools and enrichment flows using the Google Ads scraper API.

Why choose Google Ads Scraper?

This actor is built for precision, automation, and reliable transparency data extraction — a stable alternative to brittle browser extensions and manual scraping.

• ✅ Accurate, structured outputs aligned to the Google Ads Transparency portal
• 🌐 Region-aware requests and date presets for focused analyses
• 📦 Batch-friendly input handling across multiple advertiser URLs/IDs
• 💻 Developer-first: Python-based, async, and easy to integrate via Apify’s API
• 🔒 No login required; processes publicly available transparency endpoints
• 🧰 Resilient operations with proxy fallback and live dataset saving
• 🔗 Export-ready for analytics stacks and workflow tools

In short, it’s a best-in-class Google Ads SERP scraper alternative when you need official transparency records — reliable, scalable, and integration-ready.

Is it legal / ethical to use Google Ads Scraper?

Yes — when used responsibly. This actor accesses publicly available data from Google’s Ads Transparency portal and does not require login or access private areas.

Guidelines:

• Only use public data from official transparency endpoints.
• Comply with applicable regulations (e.g., GDPR, CCPA) and Google’s terms.
• Avoid republishing sensitive content and respect regional compliance norms.
• Consult your legal team for edge cases specific to your jurisdiction or use.

Input parameters & output format

Example JSON input

{
  "startUrls": [
    "https://adstransparency.google.com/advertiser/AR04619580580634296321?region=anywhere",
    "AR04619580580634296321"
  ],
  "maxItems": 100,
  "proxyConfiguration": {
    "useApifyProxy": false
    }
}

Parameters

• startUrls (array, required): List one or more Google Ads Transparency advertiser URLs or AR advertiser IDs. Keywords are accepted by the schema but are currently skipped by the runtime logic.
  • Default: none (prefill example available in the UI)
• 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 blocked, the actor will automatically fall back to datacenter 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 of America"
  ],
  "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 of America",
      "firstShown": "2024-01-15",
      "lastShown": "2024-11-20",
      "impressions": {
        "lowerBound": 0,
        "upperBound": 1000
      }
    }
  ]
}

Notes:

• format may be "UNKNOWN" if a creative type isn’t mapped.
• previewUrl is extracted when available and may be null for some creatives.
• lastShown is returned in UTC ISO 8601; per-region lastShown is a date (YYYY-MM-DD).

FAQ

What data does this Google Ads Scraper collect?

It returns structured transparency records per creative, including advertiserId, advertiserName, creativeId, adLibraryUrl, creativeRegions, firstShown, lastShown, format, previewUrl (when available), and regionStats with impression bounds.

Do I need to log in or provide cookies?

No. The actor works without login and accesses publicly available Google Ads Transparency endpoints.

Can I target specific countries or global coverage?

Yes. Include region=US (or any supported country code) in the advertiser URL to focus on a country. Use region=anywhere for global coverage.

How do I control the date range or get historical ads?

Add preset-date to the advertiser URL, e.g., preset-date=Last+30+days. Supported values include Last+7+days, Last+30+days, Last+90+days, and Last+365+days. If omitted, it defaults to the last 365 days.

How many advertisers can I process in one run?

You can supply multiple advertiser URLs/IDs in startUrls. Each advertiser is processed sequentially with pagination and live saving to the dataset.

What proxy options are available?

The actor starts without a proxy and automatically falls back to Apify datacenter proxies (GOOGLESERP group) and then residential proxies if necessary to mitigate blocking.

Are keywords supported as input?

Keywords are accepted by the input schema, but the current runtime logic skips them. Provide advertiser page URLs or AR advertiser IDs for successful runs.

Can I integrate this with Python or an API?

Yes. You can run the actor via the Apify API and integrate results into pipelines. The codebase uses Python (aiohttp, Apify SDK), making it suitable for Google Ads scraper Python workflows.

Closing CTA / Final thoughts

Google Ads Scraper is built to reliably extract structured transparency data from Google’s Ads Transparency portal. With proxy fallback, pagination, and live dataset saving, it serves marketers, developers, analysts, and researchers who need a dependable Google Ads data extractor for competitor analysis and oversight.

Start by passing advertiser URLs or AR IDs, set maxItems, and export clean JSON/CSV for your analytics stack. Developers can automate end-to-end using the Apify API and Python. For custom solutions or feature requests, contact dev.scraperengine@gmail.com — start extracting smarter Google Ads transparency insights today.