Google Ads Transparency Scraper

Extract comprehensive advertising data from Google Ads Transparency portal. Scrape ad creatives, advertiser information, targeting regions, and campaign performance data.

Why Choose Our Google Ads Scraper?

• Complete Transparency Data: Extract all available ad creatives, regions, and performance metrics
• Bulk Processing: Handle multiple advertisers simultaneously with efficient pagination
• Smart Proxy Management: Automatic fallback from direct connection to residential proxies
• Live Data Saving: Real-time data persistence prevents loss during long-running scrapes
• Enterprise-Ready: Production-grade error handling and comprehensive logging

Key Features

• ✅ Multi-Input Support: URLs, advertiser IDs, and bulk processing
• ✅ Global Coverage: Support for all regions and languages
• ✅ Ad Creative Analysis: Extract images, videos, text, and metadata
• ✅ Performance Metrics: Impressions, dates, and regional targeting data
• ✅ Proxy Intelligence: Automatic blocking detection and proxy rotation
• ✅ Real-Time Monitoring: Detailed logging and progress tracking
• ✅ Data Validation: Built-in quality checks and error handling

Input

The actor accepts various input formats for maximum flexibility:

JSON Example

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

Input Fields

Field	Type	Required	Description
startUrls	Array	Yes	List of Google Ads transparency URLs, advertiser IDs (AR...), or keywords
maxItems	Integer	No	Maximum ad creatives to scrape per advertiser (1-1000, default: 100)
sortOrder	String	No	Sort order: "newest", "oldest", or "most_recent" (default: "newest")
proxyConfiguration	Object	No	Proxy settings for blocking avoidance

Supported Input Formats

• Full URLs: https://adstransparency.google.com/advertiser/AR04619580580634296321
• Advertiser IDs: AR04619580580634296321
• Bulk Lists: Multiple inputs processed sequentially

Output

Structured JSON data for each ad creative with complete metadata.

JSON Example

{
  "adLibraryUrl": "https://adstransparency.google.com/advertiser/AR04619580580634296321/creative/123456789",
  "advertiserId": "AR04619580580634296321",
  "advertiserName": "Example Advertising Company",
  "creativeId": "123456789",
  "creativeRegions": ["United States", "Canada", "United Kingdom"],
  "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": 1000,
        "upperBound": 10000
      }
    }
  ]
}

Output Fields

Field	Type	Description
adLibraryUrl	String	Direct link to the ad in Google Ads Transparency
advertiserId	String	Unique Google advertiser identifier
advertiserName	String	Name of the advertising company
creativeId	String	Unique ad creative identifier
creativeRegions	Array	List of countries where ad was shown
firstShown	String	Date when ad was first displayed (YYYY-MM-DD)
format	String	Ad format: IMAGE, VIDEO, or HTML
lastShown	String	Date and time when ad was last displayed (ISO 8601)
previewUrl	String	Direct link to ad creative content
regionStats	Array	Detailed regional performance data

🚀 How to Use the Actor (via Apify Console)

1. Log in at https://console.apify.com and go to Actors
2. Find the actor (search for "google-ads-scraper") and click it
3. Configure inputs:
   • Add Google Ads URLs or advertiser IDs in the "startUrls" field
   • Set maximum items per advertiser (default: 100)
   • Configure proxy settings if needed
4. Run the actor and monitor progress in real-time logs
5. Access results in the OUTPUT tab once complete
6. Export data to JSON, CSV, or integrate with your workflow

Best Use Cases

Advertising Research

• Competitor Analysis: Monitor competitors' ad strategies and creative approaches
• Market Intelligence: Track industry trends and advertising spend patterns
• Creative Inspiration: Study successful ad formats and messaging

Compliance & Transparency

• Regulatory Monitoring: Ensure advertising compliance across regions
• Brand Protection: Monitor unauthorized use of brand assets in ads
• Consumer Protection: Track potentially misleading advertising

Business Intelligence

• Campaign Analysis: Analyze ad performance and targeting strategies
• Market Sizing: Understand advertising volume in specific sectors
• Trend Analysis: Track emerging advertising themes and topics

Frequently Asked Questions

What data can I extract?

You can extract complete ad creative information including images, videos, text content, targeting regions, display dates, and performance metrics.

How many advertisers can I scrape at once?

The actor supports unlimited advertisers in a single run. Each advertiser is processed sequentially with progress tracking.

What proxy options are available?

The actor starts with direct connections and automatically falls back to datacenter proxies, then residential proxies if blocking occurs.

Can I scrape historical ads?

Yes, the actor can access ads from different date ranges using URL parameters or by specifying date presets.

Is the data real-time?

The actor accesses Google's official Ads Transparency portal, providing the most current available data.

What regions are supported?

All global regions supported by Google Ads Transparency, including custom region filtering.

Can I filter by ad format?

The actor extracts all ad formats (images, videos, HTML) and includes format information in the output.

Support and Feedback

Need Help?

• 📧 Email: dev.scraperengine@gmail.com
• 📖 Documentation: Check this README for detailed usage instructions
• 🐛 Bug Reports: Include actor run logs and input configuration

Custom Solutions

• Enterprise Integration: API connections and custom workflows
• Enhanced Filtering: Custom region or date filtering
• Bulk Processing: High-volume scraping solutions
• Data Enrichment: Additional analysis and insights

Feature Requests

We welcome feedback on new features and improvements. Contact us with your specific requirements for advertising data extraction.

---

Data is collected from publicly available Google Ads Transparency sources. Ensure compliance with applicable laws and regulations when using extracted data.