Google Ads Scraper

Google Ads Scraper

Google Ads Scraper is a production-ready Google Ads scraping tool that collects structured creative data from the Google Ads Transparency portal for PPC research and competitor analysis. It solves the challenge of turning opaque ad libraries into clean, analyzable records — ideal for marketers, developers, data analysts, and researchers who need a Google SERP ads scraper style dataset without manual effort. Use it as an AdWords scraper or Google Ads spy tool to scale paid search insights across advertisers, regions, and time ranges.

What data / output can you get?

This actor exports structured JSON for each ad creative, consolidated across regions and time windows. Below are the exact output fields you’ll receive, with examples.

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 Google advertiser identifier	AR04619580580634296321
advertiserName	Advertiser’s display name	Example Advertising Company
creativeId	Unique creative identifier	123456789
creativeRegions	Countries/territories where the ad was shown (sorted)	["Canada", "United Kingdom", "United States"]
firstShown	First display date (YYYY-MM-DD) aggregated across regions	2024-01-15
format	Creative format mapping (IMAGE, VIDEO, or UNKNOWN)	IMAGE
lastShown	Last display timestamp in ISO 8601 (UTC)	2024-11-20T10:30:45Z
previewUrl	Direct link to the creative asset or preview script (when available)	https://example.com/ad-image.jpg
regionStats	Array of region-level stats (one object per region)	[ … ]
regionStats[0].regionCode	ISO country/territory code	US
regionStats[0].regionName	Country/territory name	United States
regionStats[0].firstShown	Earliest date seen for this creative in the region	2024-01-15
regionStats[0].lastShown	Latest date seen for this creative in the region	2024-11-20
regionStats[0].impressions.lowerBound	Lower bound for impression range (placeholder)	0
regionStats[0].impressions.upperBound	Upper bound for impression range (placeholder)	1000

Notes:

• Bonus metadata includes region-level breakdown and temporal visibility (first/last shown). Format may return UNKNOWN when a type doesn’t map to IMAGE or VIDEO.
• Export your data from the Apify dataset to JSON or CSV for downstream analytics and BI workflows.

Key features

• ⚡ Automatic proxy fallback & resilience

  • Built-in blocking handling with seamless fallback from direct connection to Apify datacenter proxy and then residential proxy groups for higher success rates on Google endpoints.

• 📚 Structured creative consolidation

  • Combines creatives across regions into a single record with creativeRegions and regionStats, making it a practical Google Ads data extractor for analysis.

• 🔁 Pagination with deduplication

  • Iterates through pages using server-side tokens and de-duplicates by creativeId to deliver clean datasets at scale — a reliable PPC ad scraper for Google.

• 💾 Live dataset saving

  • Pushes each creative to the Apify dataset as soon as it’s parsed, safeguarding long-running runs and enabling incremental consumption.

• 🧪 Reliable field mapping

  • Extracts format (IMAGE/VIDEO/UNKNOWN), previewUrl (when available), region-level dates, and consolidated first/last shown timestamps for robust time-series analysis.

• 🧑‍💻 Developer-friendly

  • Works via Apify’s Dataset API for programmatic access, making it easy to plug into Python/Node scripts, pipelines, and dashboards as a Google paid search ads scraper.

• 🔒 No login required

  • Pulls public data from Google Ads Transparency — no cookies or Google account needed.

• 🛠️ Production-grade logging

  • Detailed progress logging, input validation, and dataset verification help teams monitor and trust large scraping jobs.

How to use Google Ads Scraper - step by step

1. Create or log in to your Apify account.
2. Open the Apify Console and find the actor named “google-ads-scraper” by the publisher “scrapebase”.
3. Add inputs in the “startUrls” field:
   • Supported: Full advertiser URLs like https://adstransparency.google.com/advertiser/AR04619580580634296321 or advertiser IDs like AR04619580580634296321.
   • Advanced: You can include query params in URLs (e.g., ?region=US or ?preset-date=Last+30+days) to influence region/date range selection.
   • Note: Plain keywords are currently skipped by the actor.
4. Set “maxItems” to control how many creatives to scrape per advertiser (1–1000; default 100).
5. (Optional) Configure “proxyConfiguration”. The scraper starts without a proxy and automatically falls back to Apify datacenter, then residential proxies if needed.
6. Run the actor and monitor logs. You’ll see pagination progress, totals per advertiser, and proxy status changes.
7. Access results in the run’s Dataset (OUTPUT tab). Export to JSON or CSV and integrate with your workflows.
8. Pro Tip: Include region and preset-date parameters directly in advertiser URLs to refine the scope, then fetch the dataset with the Apify API for automated PPC reporting.

Use cases

Use case name	Description
PPC competitor analysis (marketing)	Track competitor creatives, formats, and regional presence to inform bidding and messaging strategy using a Google Ads competitor analysis scraper.
Market intelligence (analysts)	Quantify ad volume by region and time to map market activity across verticals with a Google Ads scraping tool.
Regulatory & brand compliance	Monitor ad visibility windows and regional targeting for compliance reviews across jurisdictions.
Creative lifecycle tracking	Measure first/last shown dates to observe campaign cadence and fatigue over time.
BI & data engineering pipelines	Pipe JSON/CSV output to a warehouse for dashboards and reporting via the Apify Dataset API.
Academic & policy research	Study public advertising patterns and regional distribution using a transparent Google Search ads scraper workflow.

Why choose Google Ads Scraper?

Built for precision, automation, and reliability, this PPC ad scraper for Google turns the Transparency portal into queryable, structured data.

• ✅ Accurate, structured output: Clean JSON with consolidated regionStats and dates.
• 🌍 Regional granularity: Country-level breakdowns for targeted analysis.
• 📈 Scales with your list: Supports multiple advertisers and paginated results per profile.
• 🧰 Developer access: Fetch datasets via API for Python/Node workflows; easy to integrate.
• 🛡️ Safe & ethical: Uses publicly available Transparency data; no login required.
• 💸 Cost-effective: Predictable outputs in JSON/CSV without maintaining browsers.
• 🔗 Better than extensions: Server-side reliability and proxy intelligence outperform brittle browser add-ons.

In short, it’s a robust Google Ads competitor ad scraper that emphasizes consistency, field-level clarity, and end-to-end scalability.

Is it legal / ethical to use Google Ads Scraper?

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

Guidelines for responsible use:

• Only use data for compliant, lawful purposes (e.g., research, market intelligence, brand safety).
• Respect applicable regulations such as GDPR/CCPA and Google’s terms.
• Avoid scraping personal or sensitive information.
• 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=anywhere",
    "AR04619580580634296321",
    "https://adstransparency.google.com/advertiser/AR04619580580634296321?preset-date=Last+30+days&region=US"
  ],
  "maxItems": 100,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}

Input fields

• 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: Plain keywords are currently skipped by the actor.
  • Default: none (required)
• 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 fallback to datacenter then residential proxies.
  • Default: { "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
        }
      }
    ]
  }
]

Notes on fields:

• format may be "UNKNOWN" when an unmapped creative type is encountered.
• previewUrl might be null if the creative’s preview link isn’t available in the response.
• firstShown/lastShown can be null when timestamps are missing.
• regionStats.impressions are included as a placeholder range (lowerBound/upperBound) based on current extraction logic.

FAQ

Does this scrape live Google SERP ads?

Yes, indirectly via the Google Ads Transparency portal. The actor functions like a Google SERP ads scraper for research by extracting creatives and visibility windows from the public ad library, not from live SERP pages.

Can it extract ad headlines and descriptions?

No. The current output focuses on creative metadata: format, previewUrl (when available), regions, and first/last shown dates. It does not extract headline/description text, so it is not a Google ad headline scraper or full ad copy extractor.

Does it support keywords in startUrls?

No. While the input field description includes keywords, the current implementation skips plain keywords. Please provide advertiser URLs or AR IDs. You can, however, pass URL parameters like region=US or preset-date=Last+30+days in the advertiser URL.

How many advertisers can I process in one run?

There’s no hard-coded limit. Provide as many advertiser URLs/IDs as you need — the actor processes them sequentially with pagination and de-duplication.

What proxy options are available?

The run starts with a direct connection. If blocking is detected, it automatically falls back to Apify datacenter proxies and then residential proxies. You can also configure proxyConfiguration in input.

Do I need a Google login or cookies?

No. This Google Ads spy tool works with public Transparency data and does not require login or cookies. You only need an Apify account to run the actor and access results.

What export formats are supported?

You can export results from the Apify dataset in JSON or CSV. This makes it easy to plug into BI tools, spreadsheets, or code-based pipelines.

Is it legal to scrape this data?

Yes, when used responsibly. The actor collects publicly available data from the Google Ads Transparency portal. Users are responsible for compliance with applicable laws and Google’s terms.

Final thoughts

Google Ads Scraper is built for structured, scalable analysis of creatives from the Google Ads Transparency portal. It delivers consolidated regional stats, formats, preview links, and time ranges with robust proxy handling and live saves. Marketers, analysts, researchers, and developers can export JSON/CSV, automate via the Apify Dataset API, and integrate into PPC analytics pipelines. Start extracting smarter competitive and market insights from Google’s public ad library — reliably and at scale.