Facebook Ads Library Scraper Extract all ads from Facebook Ads Library for any page. Automatically extracts page ID from Facebook page URLs and retrieves essential ad details including images, videos, and metadata. ## What You Get Each ad entry includes essential data: - Page Information: Page ID, name, profile URI - Ad Details: Archive ID, active status, start/end dates, publisher platforms - Content: CTA text, link URL - Performance Metrics: Total impressions (reach), spend, and impression breakdowns (age/country/gender) when available - Media: Images and videos with full metadata (titles, descriptions, CTAs, URLs) ## Quick Start ### Input Enter one or multiple Facebook page URLs using the "Add" button in the Apify interface: Single Page: json { "urls": [ {"url": "https://www.facebook.com/shinetools/"} ] } Multiple Pages (Bulk Mode): json { "urls": [ {"url": "https://www.facebook.com/shinetools/"}, {"url": "https://www.facebook.com/getqonto/"}, {"url": "https://www.facebook.com/anotherpage/"} ] } The scraper will: 1. Automatically extract the page ID from each URL 2. Access Facebook's Ads Library for each page 3. Retrieve all available ads from all pages sequentially ### Optional Parameters json { "urls": [ {"url": "https://www.facebook.com/shinetools/"} ], "activeStatus": "active", "country": "FR", "adType": "ALL", "mediaType": "all", "maxAds": 50 } Parameters: - urls (required): Array of objects with url property containing Facebook page URLs - activeStatus (optional): "active" or "all" (default: "active") - country (optional): ISO country code like "FR", "US", "GB" (default: "FR") - adType (optional): "ALL" or "POLITICAL_AND_ISSUE_ADS" (default: "ALL") - mediaType (optional): "all", "image", or "video" (default: "all") - maxAds (optional): Maximum number of ads to collect per page (default: 100) ## Output Format Each ad in the dataset contains: json { "adArchiveId": "1168819121789187", "pageId": "1010888405712821", "pageName": "Shine", "pageProfileUri": "https://www.facebook.com/shinetools/", "isActive": true, "startDate": "2024-10-15T00:00:00.000Z", "endDate": "2025-01-15T00:00:00.000Z", "publisherPlatform": ["FACEBOOK", "INSTAGRAM", "MESSENGER", "THREADS"], "linkUrl": "https://www.shine.fr/...", "ctaText": "En savoir plus", "impressions": 30797, "spend": 7412, "impressionsBreakdown": { "genderAudience": "Tous", "ageAudience": {"min": 24, "max": 65}, "locations": [ {"name": "France", "type": "countries", "excluded": false, "obfuscatedCount": 0} ], "ageCountryGenderBreakdown": [ { "country": "FR", "breakdowns": [ {"ageRange": "25-34", "male": 6926, "female": 2688, "unknown": 109} // ... ] } ] }, "images": [ { "original": "https://...", "resized": "https://...", "title": "1 600 points de dépôt en France", "body": "Déposez vos espèces en toute simplicité...", "ctaText": "Learn More", "ctaType": "LEARN_MORE", "linkUrl": "https://www.shine.fr/..." } ], "videos": [] } New fields: - impressions: Total reach/impressions for the ad in the EU (if available) - spend: Lifetime spend for the ad in the selected currency (if available) - impressionsBreakdown: Structured breakdown of impressions by country, age, gender, and declared audience information (if provided by Facebook) ## Features - Automatic Page ID Extraction: No need to manually find page IDs - the scraper extracts them automatically from Facebook page URLs - Bulk Processing: Process multiple pages in a single run using the "Add" button - GraphQL API Integration: Direct access to Facebook's Ads Library API - Automatic Pagination: Handles cursor-based pagination automatically - Complete Ad Data: Extracts all available ad information - Media Extraction: Collects images and videos with full metadata - Flexible Filtering: Filter by status, country, ad type, and media type - Rate Limiting Protection: Built-in delays to avoid rate limits ## Performance - Fast extraction using Facebook GraphQL API - ~10 ads per page (configurable) - Automatic pagination with cursor-based navigation - Rate limiting protection with delays between requests - Sequential processing of multiple pages with 2-second delays ## Use Cases - Competitive Analysis: Monitor competitor ad campaigns across multiple pages - Ad Research: Study ad creatives and messaging strategies - Market Intelligence: Track advertising trends and patterns - Content Inspiration: Analyze successful ad formats - Compliance Monitoring: Review political or issue ads ## Configuration ### Recommended Settings - Memory: 1 GB - Timeout: 1800s (30 minutes) - Restart on error: ON ## Notes - Facebook may rate limit requests if too many are made too quickly - Some ads may have limited data depending on privacy settings - The LSD token is automatically extracted from the library page - Cookies and session management are handled automatically - Page IDs are automatically extracted from Facebook page URLs - no manual lookup required