Meta Ads Scraper A powerful Apify actor that scrapes Meta/Facebook ads from the ad library, extracting detailed information including images, videos, and metadata. ## Features - Comprehensive Ad Data: Extracts brand, body text, CTA, links, images, videos, and metadata - Multiple Platform Support: Tracks ads across different platforms - Robust Scraping: Handles dynamic content loading and multiple selectors - Error Handling: Gracefully handles failures and logs detailed information - Scalable: Configurable concurrency and timeout settings ## Input Parameters ### Required - targetUrl (string): Meta ad library URL to scrape ### Optional - maxConcurrency (integer): Maximum number of concurrent requests (default: 1, max: 10) - requestHandlerTimeoutSecs (integer): Timeout for each request in seconds (default: 300, max: 600) ## Output Format The actor outputs structured data for each scraped ad: json { [ { "libraryID": "12345678900", "brand": "Example Brand", "industry": "Technology", "active": true, "platforms": ["Facebook", "Instagram"], "totalPlatforms": 2, "similarAdCount": 3, "multipleVersions": true, "body": "Check out our amazing new product!", "linkTitle": "Amazing Product", "linkUrl": "https://example.com/product", "linkDescription": "The best product you'll ever use", "ctaText": "Shop Now", "ctaUrl": "https://example.com/shop", "images": [ { "url": "https://example.com/image1.jpg" } ], "videos": [ { "url": "https://example.com/video1.mp4", "duration": 30 } ], "scrapeDate": "2024-01-01T12:00:00.000Z", "startDate": "2024-01-01T00:00:00.000Z", "endDate": "2024-01-31T23:59:59.000Z", "runningTAT": 30, "format": "video" } ] } ## Usage Examples ### Basic Usage json { "targetUrl": "https://www.facebook.com/ads/library/?active_status=all&ad_type=all&country=US&media_type=all" } ### Advanced Usage json { "targetUrls": "https://www.facebook.com/ads/library/?active_status=all&ad_type=all&country=US&media_type=all" , "maxConcurrency": 2, "requestHandlerTimeoutSecs": 300 } ## Error Handling The actor includes comprehensive error handling: - Failed URLs are logged and saved to key-value store - Individual ad parsing errors don't stop the entire process - Detailed console logging for debugging - Graceful handling of page loading issues ## Performance Considerations - Concurrency: Start with maxConcurrency: 1 and increase based on your needs - Timeout: Adjust requestHandlerTimeoutSecs based on page complexity - Rate Limiting: The actor respects website rate limits and includes delays ## Common Issues 1. No ads found: Check if the URL is accessible and contains ads 2. Timeout errors: Increase requestHandlerTimeoutSecs for slow-loading pages 3. Selector changes: Facebook may update their CSS selectors; the actor uses multiple fallback selectors ## Technical Details - Built with Apify SDK and Crawlee - Uses Puppeteer for browser automation - Handles dynamic content loading with scroll-based pagination - Implements duplicate detection to avoid scraping the same ad multiple times ## Support For issues or questions, please check the Apify Console logs for detailed error information. Contact - anas5678go@gmail.com for enterprise support