📱 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

---

💎 Pricing Tiers - Choose Your Plan

FREE TIER ✅

Get started with no upfront cost

Included:

• ✅ Full access to Facebook Ad Library data
• ✅ Multi-language & multi-country filtering
• ✅ Real-time batch pushing (results appear as they're collected)
• ✅ Complete media asset extraction (images & videos)
• ✅ All filtering options (date ranges, platforms, categories)

Trade-offs:

• ⚠️ Shared proxy infrastructure
• ⚠️ Occasional connection interruptions
• ⚠️ Best for small to medium projects (< 500 ads)

---

PAID TIER ⭐ RECOMMENDED FOR PRODUCTION

Upgrade for enterprise-grade reliability

All Free Tier features PLUS:

• 🚀 Dedicated premium proxy - Your own reliable connection
• 🚀 No rate limiting - Unlimited continuous scraping
• 🚀 90% success rate - Stable, uninterrupted operations
• 🚀 Extract 1000+ ads per query - No slowdowns or blocks
• 🚀 Perfect for production use - Enterprise-ready infrastructure
• 🚀 Consistent performance - No random connection errors

Why upgrade?

• Avoid interruptions: Your dedicated proxy won't hit Facebook's rate limits
• Reliability: No HTTP errors or temporary blocks
• Scale effortlessly: Handle large datasets with perfect stability
• Best for agencies: Reliable results for client reports and production systems
• Zero downtime: 24/7 stable scraping without worries

---

📊 Feature Comparison

Feature	FREE	PAID ⭐
Ads per query	Up to 100	1000+
Success rate	~85%	99.9%
Rate limiting	Yes	No
Connection stability	Occasional issues	Always stable
Best for	Testing & small projects	Agencies & production
Support	Standard	Priority

---

⚙️ Configuration Options

🔍 Search & Discovery

Target specific ads using multiple strategies:

{
  "searchQueries": [
    "digital marketing",
    "fitness app", 
    "cryptocurrency",
    "Black Friday deals"
  ],
  "maxResultsPerQuery": 100,
  "countries": "US",
  "contentLanguages": ["en", "es"]
}

🌍 Geographic & Language Targeting

🗺️ countries (String)

• Default: "ALL" (All countries)
• Options: Single ISO 2-letter code (e.g., "US", "CA", "FR") or "ALL"
• Use Case: Focus on a single market or run globally

🗣️ contentLanguages (Array)

• Options: ISO 2-letter language codes (e.g., ["en", "es", "fr"])
• Default: All languages
• Use Case: Filter ads by language of content

🎯 Advanced Filtering Options

📱 publisherPlatforms (Array)

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

📂 adType (String)

• Options:
  • "ALL": All ad types (default)
  • "POLITICAL_AND_ISSUE_ADS": Political and issue-based campaigns
  • "HOUSING_ADS": Real estate advertisements
  • "EMPLOYMENT_ADS": Job and recruitment campaigns
  • "CREDIT_ADS": Financial services offerings

🎨 mediaType (String)

• Options:
  • "ALL": All media types (default)
  • "VIDEO": Video campaigns only
  • "IMAGE": Static image advertisements
  • "MEME": Images with text

📊 activeStatus (String)

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

📅 Date Range Filtering

📆 startDate (String)

• Format: "YYYY-MM-DD"
• Purpose: Campaign start date
• Use Case: Historical trend analysis and campaign lifecycle tracking

📆 endDate (String)

• Format: "YYYY-MM-DD"
• Purpose: Campaign end date
• Use Case: Recent campaign focus and time-bound analysis

---

📡 Complete Ad Intelligence Extraction

📹 Ad Creative Data

• Content: Ad text, title, caption, CTA buttons with direct links
• Media: High-quality images, videos (HD/SD), thumbnails with direct URLs
• Targeting: Countries, platforms, audience demographics
• Performance: Page engagement metrics, campaign duration

📱 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
• Threads: Threads social platform ads
• WhatsApp: WhatsApp Business ads

📊 Advanced Filtering & Analytics

• Date Ranges: Historical data 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

---

📊 Rich Data Output Structure

📹 Complete Ad Data Structure

{
  "id": "625695519983453",
  "page_id": "283160151552048",
  "ad_url": "https://www.facebook.com/ads/library/?id=625695519983453",
  "text": "Commentez ou envoyez les lettres \"LS\" en message privé pour en savoir plus",
  "title": "",
  "caption": "www.instagram.com",
  "link_url": "https://www.instagram.com/",
  "cta_text": "Send message",
  "media": {
    "type": "video",
    "primary_thumbnail": "https://scontent.ftlm1-2.fna.fbcdn.net/v/t39.35426-6/...",
    "images": [],
    "videos": [
      {
        "video_hd_url": "https://video.ftlm1-2.fna.fbcdn.net/v/t42.1790-2/...",
        "video_preview_image_url": "https://scontent.ftlm1-2.fna.fbcdn.net/...",
        "video_sd_url": "https://video.ftlm1-2.fna.fbcdn.net/v/t42.1790-2/...",
        "watermarked_video_hd_url": "",
        "watermarked_video_sd_url": ""
      }
    ]
  },
  "additional_assets": {
    "images": [],
    "links": [],
    "texts": [],
    "videos": []
  },
  "page_name": "Institut Libre Serein",
  "page_url": "https://facebook.com/61558937875201",
  "page_profile_picture_url": "https://scontent.ftlm1-2.fna.fbcdn.net/...",
  "page_likes": 337,
  "start_date": "2025-01-09",
  "end_date": "2025-01-13",
  "is_active": false,
  "platforms": ["INSTAGRAM"],
  "countries": [],
  "ad_category": "UNKNOWN",
  "page_category": "School",
  "scraped_at": "2025-08-18T14:01:46.335Z",
  "contains_sensitive_content": false,
  "result_index": 1,
  "search_query": "digital marketing"
}

🎨 Media Assets Structure

Video Media

{
  "media": {
    "type": "video",
    "primary_thumbnail": "https://scontent.ftlm1-2.fna.fbcdn.net/...",
    "videos": [
      {
        "video_hd_url": "https://video.ftlm1-2.fna.fbcdn.net/...",
        "video_sd_url": "https://video.ftlm1-2.fna.fbcdn.net/...",
        "video_preview_image_url": "https://scontent.ftlm1-2.fna.fbcdn.net/...",
        "watermarked_video_hd_url": "",
        "watermarked_video_sd_url": ""
      }
    ]
  }
}

Image Media

{
  "media": {
    "type": "image",
    "primary_thumbnail": "https://scontent.ftlm1-1.fna.fbcdn.net/...",
    "images": [
      {
        "original_image_url": "https://scontent.ftlm1-1.fna.fbcdn.net/...",
        "resized_image_url": "https://scontent.ftlm1-1.fna.fbcdn.net/...",
        "watermarked_resized_image_url": "",
        "image_crops": []
      }
    ]
  }
}

---

🎯 Configuration Examples

Basic Competitor Analysis

{
  "searchQueries": ["Nike", "Adidas", "fitness wear"],
  "maxResultsPerQuery": 50,
  "countries": "US",
  "publisherPlatforms": ["FACEBOOK", "INSTAGRAM"],
  "activeStatus": "ACTIVE"
}

Video Campaign Research

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

Political & Issue Advertising Analysis

{
  "searchQueries": ["election 2025", "voting rights"],
  "maxResultsPerQuery": 200,
  "adType": "POLITICAL_AND_ISSUE_ADS",
  "contentLanguages": ["en", "es", "fr"],
  "countries": "US",
  "publisherPlatforms": ["FACEBOOK", "INSTAGRAM"],
  "startDate": "2025-01-01",
  "endDate": "2025-12-31"
}

---

📄 Advanced Features

🚀 Performance & Reliability

• Real-time Results: See data as it's collected with batch pushing
• Smart Retry Logic: Automatic recovery from temporary network issues
• Progress Tracking: Monitor scraping progress in real-time
• Data Validation: Quality checks to ensure data accuracy
• 🛡️ Proxy Intelligence: Automatic proxy selection (Free or Premium)

📊 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 with precise scraping timestamps

🎨 Creative Asset Management

• Multi-Format Support: Both video and image campaigns
• Quality Options: HD and SD video URLs, original and resized images
• Complete Coverage: All images, videos, and text elements included
• Direct Links: Clickable URLs for immediate asset access

🛡️ 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
• Privacy Protection: No personal data collection

---

🛠️ Data Field Reference

Core Ad Fields

• id: Unique Facebook ad identifier
• page_id: Facebook page identifier for the advertiser
• ad_url: Direct link to the ad in Facebook's Ad Library
• text: Main ad copy/body text
• title: Ad headline
• caption: Additional caption text
• link_url: Destination URL when users click the ad
• cta_text: Call-to-action button text

Media & Assets

• media.type: "video" or "image"
• media.primary_thumbnail: Main preview image URL
• media.videos[].video_hd_url: High-definition video URL
• media.videos[].video_sd_url: Standard-definition video URL
• media.images[].original_image_url: Full-resolution image URL
• media.images[].resized_image_url: Optimized image URL

Page Information

• page_name: Advertiser's page name
• page_url: Facebook page URL
• page_profile_picture_url: Page profile image
• page_likes: Number of page likes/followers
• page_category: Business category

Campaign Data

• start_date: Campaign start date (YYYY-MM-DD)
• end_date: Campaign end date (YYYY-MM-DD)
• is_active: Current campaign status
• platforms: Array of platforms where ad runs
• countries: Array of targeted countries
• ad_category: Ad category classification

Metadata

• scraped_at: Timestamp when data was collected
• result_index: Position in search results
• search_query: Original search term used
• contains_sensitive_content: Sensitivity flag

---

🛠️ 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

Connection Issues (Free Tier)

• Intermittent failures: Consider upgrading to Paid tier for stability
• Slow performance: Reduce batch size or split into multiple smaller runs
• Rate limiting errors: Wait a few minutes before retrying, or upgrade to Paid

Geographic Filtering

• Empty countries String: Use "ALL" for global targeting
• Wrong country codes: Use ISO 2-letter codes (US, not USA)
• Missing regional ads: Some ads may not be available in all regions

Media Access

• Missing media URLs: Some ads may have expired media
• Broken links: Media URLs may expire after extended periods
• Empty arrays: Check if media type matches your filter

Performance Optimization

• Large datasets: Use date ranges to limit scope
• Free tier limits: Consider Paid tier for 1000+ ads per query
• Better results: Upgrade to Paid tier for enterprise-grade stability

---

📈 Business Intelligence Applications

🎯 Competitive Intelligence

• Ad Strategy Analysis: Track competitor creative strategies
• Platform Presence: Monitor competitor activity across platforms
• Campaign Duration: Analyze campaign lengths and timing

🚀 Campaign Optimization

• Creative Inspiration: Download high-quality assets
• CTA Analysis: Study effective call-to-action strategies
• Performance Benchmarking: Compare page engagement metrics

📊 Market Research

• Industry Trends: Filter by category for sector analysis
• Geographic Patterns: Analyze regional strategies
• Content Evolution: Track messaging changes over time

---

🤝 Support & Resources

📞 Support

Get Help

• 🌐 Website: flowextractapi.com
• 📧 Email: flowextractapi@outlook.com
• 🙋 Apify Profile: dz_omar
• 💬 GitHub Issues: FlowExtractAPI

Social Media

• 💼 LinkedIn: flowextract-api
• 🐦 Twitter: @FlowExtractAPI
• 📱 Facebook: flowextractapi

🌟 Related Actors by FlowExtract API

🎬 Video & Media

• YouTube Transcript Extractor - Extract transcripts with timestamps
• YouTube Scraper Pro - Complete channel and playlist extraction
• Zoom Scraper - Download recordings and transcripts
• Loom Scraper - Loom video and transcript extraction

🏠 Real Estate

• Idealista Scraper API - Spanish property data with API
• Idealista Scraper - Real estate listings extractor

🛠️ Developer Tools

• Screenshot - Fast webpage screenshots
• Ultimate Screenshot - Advanced screenshot tool
• Network Security Scanner - Security vulnerability scanner

📱 Social Media

• Facebook Ads Scraper Pro - Extract Facebook ads data

---

⚖️ 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

---