📱 Facebook Ads Scraper Pro - Ad Library Intelligence

Transform Facebook's Ad Library into actionable business intelligence with comprehensive ad data extraction, media downloads, and competitive analysis across all Meta platforms.

Perfect for digital marketers, competitive researchers, and agencies who need deep insights into advertising strategies without manual browsing complexity.

---

🚀 Key Benefits & Use Cases

🎯 For Digital Marketers

• Analyze competitor ad strategies with complete creative archives and targeting data
• Track campaign performance trends and identify winning ad formats
• Build comprehensive competitive intelligence databases with historical data

🏢 For Agencies & Consultants

• Generate client reports with competitor analysis and market insights
• Discover high-performing ad creatives for inspiration and benchmarking
• Monitor industry trends and advertising spend patterns across sectors

📊 For Market Researchers

• Study advertising trends across countries, languages, and demographics
• Analyze political and issue-based advertising patterns with compliance data
• Track brand messaging evolution and campaign lifecycle analysis

---

🔎 Complete Ad Intelligence Extraction

📹 Ad Creative Data

• Content: Title, body text, captions, descriptions, CTA buttons
• Media: High-quality images, videos (HD/SD), thumbnails with direct URLs
• Targeting: Countries, languages, platforms, audience demographics
• Performance: Spend ranges, impressions, engagement metrics

📱 Multi-Platform Coverage

• Facebook: Main feed ads, stories, marketplace listings
• Instagram: Feed posts, stories, reels, shopping ads
• Audience Network: Third-party app and website placements
• Messenger: Chat-based advertising and sponsored messages
• WhatsApp: Business messaging campaigns
• Threads: Social platform native advertising

📊 Advanced Filtering & Analytics

• Date Ranges: Historical data from 2018 onwards with custom periods
• Content Types: Video, image, carousel, collection formats
• Ad Categories: General, political, housing, employment, financial services
• Status Tracking: Active, inactive, or comprehensive ad lifecycle data

---

⚙️ Configuration Options

🔍 Search & Discovery

Target specific ads using multiple strategies:

{
  "searchQueries": [
    "digital marketing",
    "fitness app", 
    "cryptocurrency",
    "Black Friday deals"
  ],
  "maxResultsPerQuery": 100
}

🌍 Geographic & Language Targeting

🗺️ countries (String)

• Default: "ALL"
• Options: ISO 2-letter codes (US, CA, GB, AU, DE, FR, etc.)
• Use Case: Focus on specific markets or analyze regional advertising strategies

🗣️ contentLanguages (Array)

• Default: All languages
• Options: ISO 2-letter codes (en, es, fr, de, etc.)
• Use Case: Language-specific campaign analysis and localization research

🎯 Advanced Filtering Options

📱 publisherPlatforms (Array)

• Options:
  • FACEBOOK: Main Facebook feed advertising
  • INSTAGRAM: Instagram stories, feed, and shopping
  • AUDIENCE_NETWORK: Third-party app placements
  • MESSENGER: Facebook Messenger campaigns
  • WHATSAPP: WhatsApp Business advertising
  • THREADS: Threads platform native ads

🎨 mediaType (String)

• Default: "IMAGE"
• Options:
  • "ALL": Every ad format (recommended for comprehensive analysis)
  • "VIDEO": Video campaigns only
  • "IMAGE": Static image advertisements
  • "MEME": Text-heavy image content
  • "IMAGE_AND_MEME": Combined image formats
  • "NONE": Text-only campaigns

📊 activeStatus (String)

• Default: "ALL"
• Options:
  • "ALL": Both active and inactive campaigns (recommended)
  • "ACTIVE": Currently running advertisements
  • "INACTIVE": Ended or paused campaigns

📂 adType (String)

• Default: "ALL"
• Options:
  • "ALL": Standard commercial advertising
  • "POLITICAL_AND_ISSUE_ADS": Political and issue-based campaigns
  • "HOUSING_ADS": Real estate and housing advertisements
  • "EMPLOYMENT_ADS": Job and recruitment campaigns
  • "CREDIT_ADS": Financial services and credit offerings

📅 Date Range Filtering

📅 startDate (String)

• Default: "2018-07-27"
• Format: "YYYY-MM-DD"
• Purpose: Earliest ad publication date to include in results
• Use Case: Historical trend analysis and campaign lifecycle tracking

📅 endDate (String)

• Default: "2025-07-27"
• Format: "YYYY-MM-DD"
• Purpose: Latest ad publication date to include in results
• Use Case: Recent campaign focus and time-bound analysis

---

📊 Rich Data Output Structure

📹 Ad Overview Data

{
  "ad_archive_id": "753751407248388",
  "page_name": "STEP GUARD Floors & Walls",
  "title": "Import Needed; MOQ 1 container",
  "body_text": "B2B Distributors Only for SPC Wall Panels...",
  "display_format": "VIDEO",
  "has_video": true,
  "has_images": false,
  "is_active": true,
  "page_like_count": 1102,
  "publisher_platform": ["FACEBOOK", "INSTAGRAM"],
  "start_date": "2025-07-20T10:00:00.000Z",
  "end_date": "2025-07-21T10:00:00.000Z"
}

🎨 Media & Creative Assets

{
  "images": [
    {
      "original_image_url": "https://scontent.ftlm1-2.fna.fbcdn.net/...",
      "resized_image_url": "https://scontent.ftlm1-2.fna.fbcdn.net/...",
      "watermarked_resized_image_url": null
    }
  ],
  "videos": [
    {
      "video_hd_url": "https://video.ftlm1-1.fna.fbcdn.net/...",
      "video_sd_url": "https://video.ftlm1-1.fna.fbcdn.net/...",
      "video_preview_image_url": "https://scontent.ftlm1-2.fna.fbcdn.net/..."
    }
  ]
}

📊 Performance & Targeting

{
  "spend": "€100 - €499",
  "impressions": "1,000 - 5,000",
  "targeted_countries": ["US", "CA", "GB"],
  "page_categories": ["Business Service"],
  "cta_text": "Get offer",
  "cta_type": "GET_OFFER",
  "link_url": "https://example.com/landing-page"
}

---

📈 Multiple Data Views & Export Options

The scraper provides 5 specialized data views optimized for different analysis needs:

📊 1. Overview - Quick Campaign Summary

Perfect for dashboard creation and high-level analysis

• Key metrics, status, dates, basic targeting
• Ideal for: Executive reports, trend analysis

🔍 2. Detailed - Complete Ad Intelligence

Comprehensive data for deep competitive analysis

• Full creative content, targeting, performance data
• Ideal for: Competitive research, strategy planning

🎨 3. Media - Creative Asset Focus

Specialized for creative team analysis and inspiration

• High-quality media URLs, format analysis, visual trends
• Ideal for: Creative research, asset archiving

📈 4. Performance - Metrics & ROI Analysis

Optimized for performance marketers and analysts

• Spend data, impressions, targeting effectiveness
• Ideal for: Budget planning, performance benchmarking

📊 5. Analytics - Research & Insights

Structured for data analysis and pattern recognition

• Search queries, indexes, metadata for analysis
• Ideal for: Market research, academic studies

---

🎯 Configuration Examples

Basic Competitor Analysis

{
  "searchQueries": ["Nike", "Adidas", "fitness wear"],
  "maxResultsPerQuery": 50,
  "countries": "US",
  "contentLanguages": ["en"],
  "activeStatus": "ACTIVE",
  "startDate": "2024-01-01",
  "endDate": "2024-12-31"
}

Video Campaign Research

{
  "searchQueries": ["online course", "education platform"],
  "maxResultsPerQuery": 100,
  "mediaType": "VIDEO",
  "publisherPlatforms": ["FACEBOOK", "INSTAGRAM"],
  "countries": "ALL",
  "activeStatus": "ALL"
}

Political Advertising Analysis

{
  "searchQueries": ["election 2024", "voting rights"],
  "maxResultsPerQuery": 200,
  "adType": "POLITICAL_AND_ISSUE_ADS",
  "countries": "US",
  "contentLanguages": ["en"],
  "startDate": "2024-01-01",
  "endDate": "2024-11-30"
}

Multi-Platform E-commerce Study

{
  "searchQueries": ["Black Friday", "Cyber Monday", "holiday sale"],
  "maxResultsPerQuery": 150,
  "publisherPlatforms": ["FACEBOOK", "INSTAGRAM", "AUDIENCE_NETWORK"],
  "mediaType": "ALL",
  "countries": "US",
  "startDate": "2024-11-01",
  "endDate": "2024-12-01"
}

International Brand Analysis

{
  "searchQueries": ["McDonald's", "Coca-Cola", "Samsung"],
  "maxResultsPerQuery": 75,
  "countries": "ALL",
  "contentLanguages": ["en", "es", "fr", "de", "pt"],
  "activeStatus": "ALL",
  "mediaType": "ALL"
}

---

🔄 Advanced Features

🚀 Performance & Reliability

• Smart Rate Limiting: Automatic throttling to respect Facebook's API limits
• Error Recovery: Robust retry mechanisms for network interruptions
• Progress Tracking: Real-time monitoring of scraping progress
• Data Validation: Automatic quality checks and duplicate prevention

📊 Data Processing & Export

• Multiple Formats: JSON, CSV, Excel-compatible exports
• Rich Metadata: Complete ad lifecycle and targeting information
• Media Preservation: Direct access URLs for all creative assets
• Historical Tracking: Time-series data for trend analysis

🛡️ Compliance & Ethics

• Public Data Only: Accesses Facebook's public Ad Library exclusively
• Rate Limit Respect: Built-in delays to prevent service disruption
• Terms Compliance: Follows Facebook's terms of service and API guidelines
• Privacy Protection: No personal data collection or unauthorized access

---

🛠️ Troubleshooting

Search Issues

• No results: Try broader keywords or check spelling
• Limited data: Increase maxResultsPerQuery or expand date ranges
• Missing recent ads: Facebook may have indexing delays

Geographic Filtering

• Wrong country codes: Use ISO 2-letter codes (US, not USA)
• Missing regional ads: Some ads may not be available in all regions
• Language mismatches: Verify content language settings

Performance Optimization

• Large datasets: Use date ranges to limit scope
• Memory issues: Reduce maxResultsPerQuery for bulk operations
• Timeout errors: Facebook may be experiencing high traffic

Data Quality

• Missing media: Some ads may have expired or restricted media
• Incomplete metrics: Performance data availability varies by ad type
• Inconsistent targeting: Targeting data may be limited for some campaigns

---

📈 Business Intelligence Applications

🎯 Competitive Intelligence

• Ad Strategy Analysis: Track competitor creative strategies and messaging evolution
• Budget Intelligence: Monitor competitor spending patterns and campaign investments
• Market Share Insights: Analyze advertising presence across different segments

🚀 Campaign Optimization

• Creative Inspiration: Discover high-performing ad formats and messaging strategies
• Targeting Insights: Understand effective audience targeting approaches
• Performance Benchmarking: Compare your campaigns against industry standards

📊 Market Research

• Industry Trends: Track advertising trends across sectors and time periods
• Consumer Behavior: Analyze how brands adapt messaging to different audiences
• Regulatory Compliance: Monitor political and regulated advertising patterns

---

🤝 Support & Resources

Getting Help

• 📧 Email: fridaytechnolog@gmail.com
• 🐙 GitHub: DZ-ABDLHAKIM
• 🐦 Twitter: @DZ_45Omar
• 🔧 Apify: dz_omar

⚖️ Legal & Compliance

• Public Data Access: Only processes publicly available Facebook Ad Library data
• Rate Limiting: Respects Facebook's service limits and terms of use
• Data Protection: No storage of personal information or unauthorized data collection
• Commercial Use: Suitable for business intelligence and research applications

---