🔍 Google Ads Intelligence Scraper Uncover competitor advertising strategies, analyze ad creatives, and monitor campaigns across all Google platforms with comprehensive data from Google's official Ads Transparency Center. Extract complete ad data including creative previews, impression statistics, regional targeting, platform distribution, and advertiser information - all in structured, analysis-ready format. --- ## 🎯 What You Can Extract ### Complete Ad Intelligence - Ad Creatives - Preview URLs for all ad formats (video, image, text) - Advertiser Information - IDs, transparency URLs, and verification data - Performance Metrics - Impression ranges across regions and platforms - Targeting Data - Geographic regions where ads were shown - Platform Distribution - Performance breakdown across YouTube, Search, Shopping, Maps, and Play - Time Analytics - First and last shown dates for each creative ### Structured Output Data Every ad returns a complete JSON object with: - Advertiser ID and Creative ID - Direct links to Google Ads Transparency pages - Preview URLs for immediate creative viewing - Regional statistics with impression counts - Platform-specific performance data - Format type (VIDEO, IMAGE, TEXT) --- ## Why Choose This Scraper? ### Built for Performance - Lightning Fast - Optimized parallel processing for multiple searches - Smart Filtering - Precise control over platforms, formats, regions, and dates - Batch Processing - Handle unlimited search targets in one run - Auto-Retry Logic - Reliable extraction even with temporary API issues ### Flexible Search Options - Keywords - "nike shoes", "saas software", "fitness app" - Advertiser IDs - Direct extraction with AR123... format - Domains - Find all ads from "shopify.com" or "apple.com" - Google Ads URLs - Paste full transparency URLs with embedded filters ### Global Coverage - 200+ Regions Supported - From United States to Tuvalu - Multi-Platform - YouTube, Search, Shopping, Maps, Google Play - All Ad Formats - Video, image, and text creatives - Historical Data - Access ads from any time period --- ## 📥 Input Configuration ### Quick Start Example json { "searchTargets": [ "fitness apps", "AR04619580580634296321", "https://adstransparency.google.com/advertiser/AR12345?region=US&platform=YOUTUBE" ], "resultsPerQuery": 20, "targetPlatform": "YOUTUBE", "adFormatType": "VIDEO", "timeRangePreset": "LAST_30_DAYS" } ### Input Parameters | Parameter | Type | Description | |-----------|------|-------------| | 🎯 searchTargets | array | Required. Keywords, advertiser IDs (AR...), domains, or full Google Ads Transparency URLs | | 📊 resultsPerQuery | integer | Max ads per search target (0 = unlimited) Default: 10 | | 📱 targetPlatform | string | Filter by platform: ALL, YOUTUBE, SEARCH, SHOPPING, MAPS, PLAY | | 🎬 adFormatType | string | Filter by format: ALL, VIDEO, IMAGE, TEXT | | 🌍 geoTargetRegion | string | Filter by country/region where ads appeared | | 📅 timeRangePreset | string | Quick date selection: ALL_TIME, LAST_30_DAYS, LAST_7_DAYS, YESTERDAY, TODAY | | 📅 customStartDate | string | Custom start date (YYYY-MM-DD) - overrides preset | | 📅 customEndDate | string | Custom end date (YYYY-MM-DD) - overrides preset | | 👥 maxAdvertiserAccounts | integer | Max advertisers per keyword search. Default: 3 | | 🌐 maxDomainMatches | integer | Max domains when multiple match (0 = unlimited). Default: 1 | | 🔗 enableUrlFiltering | boolean | Extract filters from Google Ads URLs. Default: true | | 🔒 proxyConfig | object | Proxy configuration (Apify Proxy recommended) | --- ## 📤 Output Structure ### Example Output (Single Ad) json { "advertiserId": "AR04619580580634296321", "creativeId": "CR14567271621866815489", "format": "VIDEO", "creativeRegions": ["United States", "Canada", "United Kingdom"], "adTransparencyUrl": "https://adstransparency.google.com/advertiser/AR04619580580634296321/creative/CR14567271621866815489?region=anywhere", "previewUrls": [ "https://displayads-formats.googleusercontent.com/ads/preview/content.js?client=ads-integrity..." ], "regionStats": [ { "regionNumber": 2840, "regionCode": "US", "regionName": "United States", "firstShown": 20240115, "lastShown": 20241022, "impressions": { "lowerBound": 10000, "upperBound": 50000 }, "platformStats": [ { "surfaceName": "YouTube", "impressions": { "lowerBound": 8000, "upperBound": 40000 } }, { "surfaceName": "Google Search", "impressions": { "lowerBound": 2000, "upperBound": 10000 } } ] } ] } ### Output Fields Explained #### Core Ad Data - advertiserId - Unique advertiser identifier (AR...) - creativeId - Unique creative/ad identifier (CR...) - format - Ad type: VIDEO, IMAGE, or TEXT - adTransparencyUrl - Direct link to Google's transparency page - previewUrls - Array of URLs to preview the actual ad creative #### Geographic & Targeting Data - creativeRegions - List of all regions where ad appeared - regionStats - Detailed breakdown per region including: - Region name and code (US, GB, etc.) - First and last shown dates (YYYYMMDD format) - Total impression ranges (lower/upper bounds) - Platform-specific performance data #### Platform Performance - platformStats - For each region, shows distribution across: - YouTube - Google Search - Google Shopping - Google Maps - Google Play --- ## Professional Use Cases ### Competitive Intelligence - Monitor Competitors - Track advertising strategies of direct competitors - Ad Creative Analysis - Study successful ad formats and messaging - Budget Estimation - Gauge competitor spend based on impression data - Market Positioning - Understand how competitors target different regions ### Market Research - Industry Trends - Analyze advertising patterns in your niche - Seasonal Campaigns - Track when competitors increase ad spend - Regional Strategies - Discover which markets competitors prioritize - Platform Preferences - See which Google platforms work best in your industry ### Media Planning - Campaign Planning - Learn from successful campaigns in your space - Platform Selection - Data-driven decisions on YouTube vs Search vs Shopping - Geographic Targeting - Identify high-potential regions based on competitor activity - Creative Inspiration - Access preview URLs for creative reference ### Business Intelligence - Brand Monitoring - Track mentions and ads from specific domains - Partnership Discovery - Find companies advertising complementary products - Merger & Acquisition Research - Monitor advertising activity of target companies - Market Entry Analysis - Understand advertising landscape before entering new markets ### Data & Automation - API Integration - Feed data into business intelligence dashboards - Automated Monitoring - Schedule regular scans of competitor activity - Alert Systems - Trigger notifications when competitors launch new campaigns - Data Warehousing - Build comprehensive advertising databases --- ## 🎯 Advanced Search Techniques ### 1. Keyword-Based Discovery Perfect for finding advertisers in your industry: json { "searchTargets": ["saas software", "project management tool"], "maxAdvertiserAccounts": 10 } ### 2. Direct Advertiser Tracking Monitor specific competitors: json { "searchTargets": [ "AR04619580580634296321", "AR12345678901234567890" ], "resultsPerQuery": 0 } ### 3. Domain-Based Analysis All ads from a specific website: json { "searchTargets": ["shopify.com", "wix.com"], "maxDomainMatches": 0 } ### 4. URL Filter Extraction Preserve filters from Google Ads Transparency URLs: json { "searchTargets": [ "https://adstransparency.google.com/advertiser/AR123?region=US&platform=YOUTUBE&format=VIDEO" ], "enableUrlFiltering": true } ### 5. Multi-Platform Comparison Compare performance across platforms: json { "searchTargets": ["nike"], "targetPlatform": "ALL", "maxAdvertiserAccounts": 5, "resultsPerQuery": 50 } --- ## Technical Details ### Performance Metrics - Speed: 2-5 seconds per advertiser - Throughput: Process 100+ search targets in under 10 minutes - Accuracy: Direct data from Google's official API - Reliability: Built-in retry logic with exponential backoff ### Infrastructure - Proxy Support - Automatic rotation with Apify Proxy integration - Error Handling - Graceful degradation on temporary failures - Rate Limiting - Smart request throttling to avoid blocks - Parallel Processing - Concurrent execution for maximum speed ### Data Quality - Official Source - All data from Google Ads Transparency Center - No Estimates - Real impression ranges, not extrapolated data - Up-to-Date - Access to the latest advertising activity - Comprehensive - All ad formats, platforms, and regions --- ## Typical Use Patterns ### Small Business Owner json { "searchTargets": ["local coffee shop", "neighborhood cafe"], "geoTargetRegion": "United States", "timeRangePreset": "LAST_30_DAYS", "resultsPerQuery": 10 } ### Marketing Agency json { "searchTargets": [ "AR123...", "AR456...", "AR789..." ], "resultsPerQuery": 100, "targetPlatform": "ALL" } ### Enterprise Research Team json { "searchTargets": [ "software", "technology", "cloud computing", "artificial intelligence", "machine learning" ], "maxAdvertiserAccounts": 20, "resultsPerQuery": 0, "timeRangePreset": "ALL_TIME" } --- ## 🛡️ Legal & Compliance This actor extracts publicly available advertising data from Google's official Ads Transparency Center. All data is information that Google makes accessible to promote advertising transparency. Important Considerations: - ✅ Data is publicly accessible to all users - ✅ No authentication or private data accessed - ✅ Complies with Google's transparency initiatives - ⚠️ Respect rate limits and use proxies responsibly - ⚠️ Review Google's Terms of Service for your use case - ⚠️ Ensure compliance with data protection laws (GDPR, CCPA, etc.) Recommended Use: - ✅ Competitive analysis and market research - ✅ Academic research on advertising trends - ✅ Transparency and accountability journalism - ✅ Business intelligence and strategic planning --- ## 🚀 Getting Started ### 1. Configure Your Search Add keywords, advertiser IDs, domains, or full Google Ads URLs ### 2. Apply Filters (Optional) Narrow results by platform, format, region, or date range ### 3. Set Limits Define how many ads per target and max advertisers per keyword ### 4. Enable Proxy (Recommended) Use Apify Proxy for reliable, unblocked access ### 5. Run & Export Execute the actor and download results in JSON, CSV, or Excel --- ### Optimization Tips - Use resultsPerQuery limits to control costs - Set maxAdvertiserAccounts based on needs - Enable enableUrlFiltering for faster URL-based searches - Use proxies only when necessary (reduces costs) --- ## 📊 Export & Integration ### Export Formats - JSON - Full structured data with all nested objects - CSV - Flattened view for Excel and spreadsheet tools - Excel - Formatted tables with multiple sheets - API - Direct programmatic access via Apify API ### Integration Examples #### Python python from apify_client import ApifyClient client = ApifyClient("YOUR_API_TOKEN") run = client.actor("dz_omar/google-ads-scraper").call( run_input={ "searchTargets": ["nike"], "resultsPerQuery": 50 } ) # Fetch results for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) #### JavaScript javascript import { ApifyClient } from 'apify-client'; const client = new ApifyClient({ token: 'YOUR_API_TOKEN' }); const run = await client.actor("dz_omar/google-ads-scraper").call({ searchTargets: ["nike"], resultsPerQuery: 50 }); const { items } = await client.dataset(run.defaultDatasetId).listItems(); console.log(items); --- ## 🔧 Troubleshooting ### No Results Returned Possible Causes: - Advertiser ID doesn't exist or has no public ads - Region filter too restrictive - Date range excludes all ad activity - Domain has no verified Google Ads presence Solutions: - Verify advertiser ID format (AR followed by 20 digits) - Try removing region/date filters first - Search by keyword instead of domain - Check Google Ads Transparency manually first ### Slow Performance Possible Causes: - Many search targets with unlimited results - No rate limiting enabled - Network latency without proxy Solutions: - Set reasonable resultsPerQuery limits - Enable Apify Proxy for faster processing - Reduce maxAdvertiserAccounts per keyword - Split large jobs into smaller batches ### Proxy Errors Possible Causes: - Insufficient proxy credits - Wrong proxy group selected - Proxy blocked by Google Solutions: - Verify Apify account has proxy credits - Use RESIDENTIAL proxy group for best results - Try without proxy for small tests - Contact Apify support for persistent issues --- ## 🌟 Related Actors by DZ_OMAR ### 📱 Social Media Intelligence Facebook Ads Scraper Pro Extract Facebook advertising data for comprehensive cross-platform competitor analysis. ### 🎬 Video & Content Tools YouTube Transcript & Metadata Extractor Extract video transcripts, metadata, and analytics from YouTube content. YouTube Full Channel Scraper Complete channel, playlist, shorts, and live stream data extraction. Zoom Scraper | Video & Transcript Download Zoom recordings and extract meeting transcripts. Loom Scraper | Video & Transcript Extract Loom videos and transcripts for content analysis. ### 🏠 Real Estate Data Idealista Scraper API Advanced Spanish property data extraction with API access. ### 🛠️ Developer Tools Ultimate Screenshot Professional webpage screenshots with full customization. Network Security Scanner Comprehensive website security vulnerability scanning. --- ## 💬 Support & Feedback ### Need Help? - 📧 Email: fridaytechnolog@gmail.com - 🐦 Twitter: @DZ_45Omar - 👨‍💻 GitHub: DZ-ABDLHAKIM - 🔧 Apify Profile: dz_omar ### Found a Bug or Have a Feature Request? Open an issue or contact us directly. We're committed to continuous improvement and responsive support. ### Rate This Actor If you find this actor valuable, please leave a review! Your feedback helps us improve and helps others discover quality tools. --- Built with ❤️ by DZ_OMAR | Powered by Apify Platform ---