Facebook Ads Library Scraper

Last updated: January 18, 2026

🎯 Why use this scraper?

Extract all Facebook ads from any page in minutes with complete performance metrics, media assets, and audience insights. Perfect for competitive analysis, ad research, and market intelligence.

Perfect for marketers, agencies, and businesses who need comprehensive ad data to analyze competitor strategies, track advertising trends, or build ad intelligence databases.

✅ What you get

Complete ad data including:

• Performance Metrics: Impressions, spend, and detailed audience breakdowns (age, gender, country)
• Media Assets: All images and videos with full metadata (titles, descriptions, CTAs, URLs)
• Ad Details: Archive ID, active status, start/end dates, publisher platforms
• Page Information: Page ID, name, profile URI
• Content: CTA text, link URLs, ad copy

---

🚀 Key Features

📊 Complete Ad Data Extraction

Extract every detail from Facebook Ads Library:

• ✅ Performance metrics: Impressions, spend, and audience breakdowns
• ✅ Media assets: All images and videos with full URLs and metadata
• ✅ Ad metadata: Dates, platforms, status, and identifiers
• ✅ Content analysis: CTAs, links, titles, and descriptions

🔄 Automatic Page ID Extraction

No manual lookup needed:

• Automatically extracts page ID from Facebook page URLs
• Supports direct page ID input if you already have it
• Handles multiple pages in a single run

⚡ Fast GraphQL API Integration

Lightning-fast data extraction:

• Direct access to Facebook's Ads Library GraphQL API
• Automatic pagination with cursor-based navigation
• Rate limiting protection with intelligent delays
• ~10 ads per page request (configurable)

📄 Complete Media Extraction

Get all creative assets:

• Images with original and resized URLs
• Videos in HD and SD formats with preview images
• Full metadata: titles, descriptions, CTAs, and link URLs
• Ready for analysis or download

🔍 Advanced Filtering Options

Target specific ads with powerful filters:

• Status filters: Active ads only or all ads (including inactive)
• Geographic filters: Filter by country (FR, US, GB, etc.)
• Ad type filters: All ads or political/issue ads only
• Media filters: All formats, images only, or videos only
• Quantity control: Set maximum number of ads to collect

---

💼 Use Cases and Client Benefits

🏢 For Marketing Agencies and Consultants

The Problem: You need to analyze competitor ad strategies, but manually collecting ad data from Facebook Ads Library is time-consuming, incomplete, and doesn't provide performance metrics.

The Solution: Extract complete ad databases with performance metrics, media assets, and audience insights to deliver comprehensive competitive analysis reports.

Client Benefits:

• 📊 Complete ad databases: All ads with performance metrics and media assets
• 📈 Performance insights: Impressions, spend, and audience breakdowns
• 🎯 Competitive intelligence: Track competitor strategies and trends
• 💰 Time savings: Build comprehensive reports in minutes, not days
• 📱 Media library: Download all images and videos for analysis

ROI: Deliver premium competitive analysis reports faster. One successful client engagement can generate significant revenue.

---

📊 For Market Researchers and Analysts

The Problem: You need comprehensive ad data for market analysis, but manual collection is slow, expensive, and misses performance metrics.

The Solution: Extract structured ad data with performance metrics from multiple pages for comparative analysis and market mapping.

Client Benefits:

• 📊 Complete datasets: All ads with performance metrics and media
• 🔍 Market coverage: Analyze advertising trends across industries
• 📈 Performance analysis: Study impressions, spend, and audience targeting
• 💾 Structured data: Ready for analysis in CSV, JSON, or Excel
• 🎯 Trend identification: Track advertising patterns over time

ROI: Complete market research in hours instead of weeks. Deliver insights that command premium consulting fees.

---

🎯 For Ad Creatives and Content Teams

The Problem: You need inspiration and examples of successful ad formats, but finding and organizing ad creatives is time-consuming.

The Solution: Extract all ad creatives with full metadata to build inspiration libraries and analyze successful formats.

Client Benefits:

• 🖼️ Media library: All images and videos with full URLs
• 📝 Content analysis: Titles, descriptions, and CTAs for inspiration
• 🎨 Format analysis: Study successful ad formats and structures
• ⚡ Automated collection: Build inspiration libraries automatically
• 💰 Creative insights: Learn from high-performing ads

ROI: Build comprehensive creative libraries faster. More inspiration = better ads = higher performance.

---

🏠 For Compliance and Legal Teams

The Problem: You need to monitor political or issue ads for compliance, but manual review is slow and error-prone.

The Solution: Extract all political/issue ads with complete metadata for compliance monitoring and reporting.

Client Benefits:

• ✅ Compliance monitoring: Track political and issue ads automatically
• 📊 Complete records: All ad data with dates and metadata
• 🔍 Audit trails: Full extraction history for compliance
• ⚡ Automated reporting: Generate compliance reports automatically
• 💰 Risk mitigation: Identify compliance issues faster

ROI: Reduce compliance risk and save audit time. Avoid costly penalties with automated monitoring.

---

📈 Concrete Results: Before vs. After

Before (without the scraper)

• ⏱️ 2-3 hours to manually collect data from 50 ads
• 📝 Visit each ad page individually in Facebook Ads Library
• ❌ Risk of missing ads or information
• 🔄 Repetitive copy-paste work
• 💸 High opportunity cost (time you could spend on analysis)
• 😓 Stress from incomplete or unstructured data
• 📊 No easy way to analyze performance metrics
• 🖼️ Manual download of images and videos

After (with the scraper)

• ⚡ Less than 5 minutes to extract 50+ ads with complete structured data
• ✅ Complete ad data automatically extracted with performance metrics
• 📊 Ready export in JSON/CSV format - no formatting needed
• 🎯 Instant analysis of impressions, spend, and audience data
• 💰 Higher revenue: Deliver comprehensive reports faster
• 😊 Professional confidence: Deliver comprehensive, accurate databases
• 📈 Easy analysis: Filter and analyze ads instantly
• 🖼️ Media library: All images and videos with full URLs

Time saved: 95% reduction in data collection time
Speed: 50+ ads in under 5 minutes
Quality improvement: 100% data coverage vs. selective manual extraction
Analysis capability: Structured data with performance metrics ready for advanced analytics

---

💰 Costs and Optimization

💵 Actual Cost Breakdown (Based on Real Run - 50 ads)

Total cost: ~$0.15 for 50 ads (~$0.003 per ad)

Service	Usage	Cost
Actor compute units	0.05	$0.02
Dataset writes	50	$0.00025
Data transfer internal	0.01 GB	$0.0005
Data transfer external	0.005 GB	$0.00075
Total		~$0.15

Cost per ad: ~$0.003 (less than $0.01 per ad)

📊 Cost Scaling

Based on typical run data:

• 10 ads: ~$0.03
• 50 ads: ~$0.15
• 100 ads: ~$0.30
• 500 ads: ~$1.50

Note: Costs are primarily driven by compute time. The scraper is optimized for efficiency with intelligent rate limiting and session management.

💡 Cost Optimization Tips

1. Start small: Test with 10-20 ads to validate everything works (~$0.03)
2. Set maxAds: Limit the number of ads per page to control costs
3. Use filters: Filter by active status, country, or media type to reduce data volume
4. Batch processing: Process multiple pages in a single run to optimize compute time

Recommended Starting Configuration

For testing:

{
  "url": "https://www.facebook.com/airbnb/",
  "maxAds": 10,
  "activeStatus": "active",
  "country": "FR"
}

Cost: ~$0.03 to test with 10 ads

For production (50+ ads):

{
  "url": "https://www.facebook.com/airbnb/",
  "maxAds": 100,
  "activeStatus": "active",
  "country": "FR",
  "mediaType": "all"
}

Cost: ~$0.30 for 100 ads | Time: Less than 5 minutes

---

📋 Complete Data Fields Extracted

Complete ad data organized in the following categories:

Category	Field Name	Description	Example
Identification	adArchiveId	Unique ad archive ID	1540798570471880
	pageId	Facebook page ID	324826532457
	pageName	Page name	Airbnb
	pageProfileUri	Page profile URL	https://www.facebook.com/airbnb/
Ad Details	isActive	Active status	true
	startDate	Ad start date (ISO)	2026-01-12T08:00:00.000Z
	endDate	Ad end date (ISO)	2026-01-18T08:00:00.000Z
	publisherPlatform	Publishing platforms	["FACEBOOK", "INSTAGRAM"]
Content	linkUrl	Destination URL	https://www.airbnb.fr/experiences
	ctaText	Call-to-action text	En savoir plus
Performance	impressions	Total impressions/reach	15898
	spend	Total spend (currency)	429
	impressionsBreakdown	Audience breakdown	See structure below
Media	images	Image array with URLs and metadata	See structure below
	videos	Video array with URLs and metadata	See structure below

Impressions Breakdown Structure

{
  "targetsEu": true,
  "totalReach": 15898,
  "genderAudience": "Tous",
  "ageAudience": {"min": 18, "max": 59},
  "locations": [
    {"name": "France", "type": "countries", "excluded": false}
  ],
  "ageCountryGenderBreakdown": [
    {
      "country": "FR",
      "breakdowns": [
        {"ageRange": "25-34", "male": 4896, "female": 5940, "unknown": 69}
      ]
    }
  ]
}

Media Structure

Images:

{
  "original": "https://...",
  "resized": "https://...",
  "title": "Ad title",
  "body": "Ad description",
  "ctaText": "Learn More",
  "ctaType": "LEARN_MORE",
  "linkUrl": "https://..."
}

Videos:

{
  "hd": "https://...",
  "sd": "https://...",
  "preview": "https://...",
  "title": "Video title",
  "body": "Video description",
  "ctaText": "Learn More",
  "ctaType": "LEARN_MORE",
  "linkUrl": "https://..."
}

---

💡 How to Use the Data

Competitive Analysis

Use impressions, spend, and audience data to analyze competitor ad strategies and identify successful campaigns.

Creative Inspiration

Download images and videos to build inspiration libraries and study successful ad formats.

Market Research

Filter and analyze ads by country, date, or media type to track advertising trends and patterns.

Performance Benchmarking

Compare impressions and spend across competitors to benchmark your own ad performance.

CRM Integration

Import CSV data directly into CRM systems (Salesforce, HubSpot, etc.) for lead tracking and analysis.

Export to Analytics Tools

Import CSV data into Excel, Google Sheets, or business intelligence tools for advanced analysis and reporting.

Create Reports

Generate professional reports for stakeholders with key metrics and insights from ad data.

---

🎁 What You Receive

• ✅ Complete ad database with all ads from specified pages
• ✅ Extracted in minutes - lightning-fast performance
• ✅ Performance metrics - impressions, spend, and audience breakdowns
• ✅ Media assets - all images and videos with full URLs
• ✅ Export in JSON/CSV format - ready for analysis
• ✅ Up-to-date data extracted directly from Facebook Ads Library
• ✅ Ready to use - no additional processing needed
• ✅ Structured and clean - perfect for analysis or import

---

📖 Input Configuration

Basic Configuration

{
  "url": "https://www.facebook.com/airbnb/",
  "activeStatus": "active",
  "country": "FR",
  "maxAds": 50
}

Advanced Configuration with Filters

{
  "url": "https://www.facebook.com/airbnb/",
  "pageId": "324826532457",
  "activeStatus": "active",
  "country": "FR",
  "adType": "ALL",
  "mediaType": "all",
  "maxAds": 100
}

Parameter Reference

📄 Page Input

Parameter	Type	Default	Description
url	string	""	Facebook page URL (e.g., https://www.facebook.com/airbnb/) or page ID
pageId	string	""	Direct page ID if you already know it (optional, takes priority over URL)

🔍 Filter Options

Parameter	Type	Default	Description
activeStatus	string	"active"	Filter by ad status: "active" for currently running ads, "all" for all ads
country	string	"FR"	ISO country code (e.g., FR, US, GB, DE). Ads filtered to show only those targeting this country
adType	string	"ALL"	Filter by ad type: "ALL" for all ads, "POLITICAL_AND_ISSUE_ADS" for political/issue ads only
mediaType	string	"all"	Filter by media format: "all" for all formats, "image" for images only, "video" for videos only
maxAds	integer	100	Maximum number of ads to collect per page (0 for unlimited)

Filter Examples

Extract active ads from France only:

{
  "url": "https://www.facebook.com/airbnb/",
  "activeStatus": "active",
  "country": "FR"
}

Extract all video ads from US:

{
  "url": "https://www.facebook.com/airbnb/",
  "activeStatus": "all",
  "country": "US",
  "mediaType": "video"
}

Extract political/issue ads only:

{
  "url": "https://www.facebook.com/airbnb/",
  "adType": "POLITICAL_AND_ISSUE_ADS",
  "country": "FR"
}

---

🚀 Installation and Usage

Local Installation

cd scrapers/facebook-ads-library-scraper
npm install

Local Execution

$npm start

The scraper will use the input.json file for configuration.

Apify Platform

1. Push the Actor to Apify: apify push
2. Configure input in the Apify web interface
3. Run the Actor
4. Download results from the Dataset

---

⚙️ 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
• Performance metrics (impressions, spend) are only available for ads targeting EU countries

---

📞 Support

Need help using the scraper or customizing the extraction? Contact me:

• Email: corentin@outreacher.fr
• LinkedIn: https://www.linkedin.com/in/robertcorentin/

---

Extract all Facebook ads with performance metrics in minutes. Transform hours of manual data collection into instant structured, actionable data. Build comprehensive ad databases and make data-driven decisions that grow your business.