🎯 Facebook Ads Library Scraper — Meta Ad Library Data, Reach, Demographics & Targeting

Scrape the Meta (Facebook) Ads Library without an API key. This Facebook Ads Library Scraper extracts competitor ads, creative assets, ad spend transparency, and detailed demographic reach into clean JSON, CSV, or Excel — ready for competitive intelligence, media planning, and creative research.

Whether you need competitor ad monitoring, audience targeting insights, EU reach & demographic breakdowns, or a creative swipe file, this tool collects and structures everything in one run: no scraping infrastructure, no proxies, no maintenance on your side.

🎯 What can you use the Facebook Ads Library Scraper for?

• 🔍 Competitor intelligence: monitor what ads competitors run right now, and how their creative strategy evolves
• 📊 Media buying & planning: analyze reach by age, gender, and country to benchmark or refine your own targeting
• 🎨 Creative research: build a swipe file of high-performing ad creatives across formats (image, video, carousel)
• 🏢 Brand safety & compliance: track who is running ads mentioning your brand, and audit payer/beneficiary transparency
• 📈 Market research: compare advertising strategies across countries and industries
• 🤖 AI agents & LLM workflows: feed structured ad data into your agents via MCP for automated competitive reporting

💎 Why choose this Facebook Ads Library Scraper?

• 🚀 Fast & reliable: advanced extraction engine built for consistent, high-quality results at scale
• 📊 Complete ad data: creative content, images, videos, CTAs, links, platforms, and publication dates in every run
• 🔬 Ad Details mode: unlock EU reach, demographics, age × gender breakdowns, and full targeting data on demand
• 📄 Auto-pagination: fetches every page of results automatically — no manual scrolling, no missed ads
• 🎯 Multi-URL support: scrape multiple pages, brands, or search queries in a single run
• 🖼️ Smart media extraction: images, video thumbnails, and HD/SD video URLs across all ad formats
• 🛡️ Anti-blocking built in: residential proxy support for reliable, uninterrupted access
• 🤖 MCP-ready: use it as a tool for Claude, ChatGPT, or any AI agent via the Apify MCP Server

🔮 How it works

1. 🔗 Provide Ad Library URLs

Paste one or more Facebook Ad Library URLs. You can scrape:

• A specific page's ads — via view_all_page_id
• Search results — via the q keyword parameter
• Filtered results — active/inactive, country, media type

2. 📦 Set your limits

Choose how many ads to scrape (default: 100, set 0 for unlimited).

3. 🔬 Enable Ad Details (optional)

Turn on fetchDetails to enrich each ad with:

• 📈 EU total reach
• 👥 Demographic breakdowns (age × gender × country)
• 🎯 Audience targeting (age range, gender, locations)
• 💼 Payer & beneficiary transparency data

4. ⚡ Run & export

Results are pushed incrementally — start using the data before the run finishes. Export to JSON, CSV, Excel, or pull it via the API.

📋 Quick start

1. Click Try for free / open the Actor in Apify Console.
2. Paste one or more Facebook Ad Library URLs (page or search).
3. Set maxAds, and enable fetchDetails if you need reach & demographics.
4. Click Start and download your data as JSON, CSV, or Excel.

Input parameters

Parameter	Type	Default	Description
urls	array	—	One or more Facebook Ad Library URLs to scrape
maxAds	number	100	Maximum ads to scrape (0 = unlimited)
fetchDetails	boolean	false	Fetch detailed reach, demographics & targeting per ad
proxyConfig	object	Residential	Proxy configuration (residential recommended)

Input example — scrape a page's ads

{
    "urls": [
        { "url": "https://www.facebook.com/ads/library/?active_status=active&ad_type=all&country=FR&view_all_page_id=434174436675167&media_type=all" }
    ],
    "maxAds": 100,
    "fetchDetails": false
}

Input example — search by keyword

{
    "urls": [
        { "url": "https://www.facebook.com/ads/library/?active_status=active&ad_type=all&country=US&q=running%20shoes&media_type=all" }
    ],
    "maxAds": 50,
    "fetchDetails": false
}

Input example — with reach & demographics

{
    "urls": [
        { "url": "https://www.facebook.com/ads/library/?active_status=active&ad_type=all&country=FR&view_all_page_id=434174436675167&media_type=all" }
    ],
    "maxAds": 30,
    "fetchDetails": true
}

Input example — multiple pages at once

{
    "urls": [
        { "url": "https://www.facebook.com/ads/library/?active_status=active&ad_type=all&country=FR&view_all_page_id=434174436675167&media_type=all" },
        { "url": "https://www.facebook.com/ads/library/?active_status=active&ad_type=all&country=US&view_all_page_id=139594698297&media_type=all" }
    ],
    "maxAds": 200,
    "fetchDetails": false
}

✨ What you'll get

📋 Standard fields (always included)

Field	Description
adArchiveId	Unique Facebook Ad Library ID
collationId	Groups ad variations together
pageName	Advertiser page name
image	Preview image URL (or video thumbnail)
bodyText	Ad copy / body text
title	Ad title
publicationDate	Start & end dates with timestamps
adVariations	Number of creative variations
ctaText	Call-to-action button text (Learn More, Shop Now, etc.)
linkUrl	Destination URL
isActive	Whether the ad is currently running
hasVideo	Whether the ad contains video
platforms	Distribution platforms (Facebook, Instagram, Messenger, Audience Network)
mediaType	IMAGE, VIDEO, or TEXT
all_images	All image URLs found in the ad
all_videos	All video URLs (HD/SD)

🔬 Detail fields (when fetchDetails is enabled)

Field	Description
audience	Targeting info: gender, age range (min/max), locations
reach	Total EU reach + breakdown by country, age range, and gender
payer	Entity paying for the ad
beneficiary	Entity benefiting from the ad

Output example — standard

{
    "adArchiveId": "1472608967817658",
    "collationId": "8293741056382",
    "pageName": "Apple",
    "image": "https://scontent.xx.fbcdn.net/v/t45.1600-4/...",
    "bodyText": "iPhone 16 Pro. The thinnest borders ever on iPhone.",
    "title": "iPhone 16 Pro",
    "publicationDate": {
        "startDate": "2026-04-15T00:00:00.000Z",
        "endDate": "N/A",
        "startDate_timestamp": 1776384000,
        "endDate_timestamp": 0
    },
    "adVariations": 3,
    "ctaText": "Learn More",
    "linkUrl": "https://www.apple.com/iphone-16-pro/",
    "isActive": true,
    "hasVideo": true,
    "platforms": ["Facebook", "Instagram"],
    "mediaType": "VIDEO",
    "all_images": [],
    "all_videos": ["https://video.xx.fbcdn.net/v/..."]
}

Output example — with Ad Details

{
    "adArchiveId": "1472608967817658",
    "pageName": "Apple",
    "title": "iPhone 16 Pro",
    "isActive": true,
    "audience": {
        "gender": "All",
        "age": { "min": 18, "max": 65 },
        "locations": [
            { "name": "France", "type": "countries", "excluded": false }
        ]
    },
    "reach": {
        "total": 1665288,
        "breakdown": [
            { "country": "FR", "age_range": "18-24", "male": 96974, "female": 170035, "unknown": 21102 },
            { "country": "FR", "age_range": "25-34", "male": 252206, "female": 367860, "unknown": 30821 }
        ]
    },
    "payer": "APPLE INC.",
    "beneficiary": "APPLE INC."
}

🎯 Use cases

📱 Competitor intelligence

• Monitor what ads your competitors are running right now
• Track their creative strategy over time
• Compare platforms (Facebook vs. Instagram) and ad formats
• Compare ad copy, CTAs, and landing pages

📊 Media buying & planning

• Discover which demographics competitors are targeting
• Analyze reach distribution across age groups and genders
• Identify underserved audience segments
• Benchmark your reach against competitors

🎨 Creative strategy

• Build a swipe file of competitor ad creatives
• Analyze which formats perform best (image vs. video)
• Track seasonal creative trends
• Study CTA and messaging patterns

🏢 Brand safety & compliance

• Monitor who is running ads mentioning your brand
• Track payer/beneficiary transparency data
• Audit ad compliance across markets
• Detect unauthorized use of brand assets

🤖 AI-powered workflows

• Feed ad data into LLMs for creative analysis
• Automate weekly competitor ad reports
• Build real-time monitoring dashboards
• Use the MCP integration for conversational ad intelligence

🔒 Reliability & performance

• Incremental result delivery — start using data before the run finishes
• Residential proxy rotation and anti-detection built in
• Smart pagination and retry handling
• Consistent output schema across single and multi-URL runs

💡 Pro tips

• 🔥 For competitive analysis: use view_all_page_id to scrape every ad from a specific competitor page. Find the page ID by searching the brand on Facebook Ad Library and checking the URL.
• 📈 For demographic insights: enable fetchDetails: true for the full breakdown — invaluable for media planning.
• 🌍 For multi-market analysis: run the same page ID across different country parameters to compare how a brand advertises across markets.
• ⚡ For maximum speed: keep fetchDetails: false for fast bulk scraping; enable it only when you need reach and demographic data.
• 💰 For cost control: start with a small maxAds to validate your query, then scale up.
• 🔄 For ongoing monitoring: schedule this Actor daily or weekly via Apify Schedules, and combine with webhooks to get notified when new ads appear.

🔗 Integrations

Connect this scraper to your favorite tools and automate your ad intelligence workflows:

• 🔄 N8N: Apify + N8N Integration Guide
• ⚡ Make (Integromat): Apify + Make Integration Guide
• 🐍 Python & JavaScript clients: Apify API clients
• 🤖 MCP (AI Agents): Apify MCP Server
• 📊 Google Sheets: Apify + Google Sheets
• 🗄️ Webhooks & Zapier: trigger downstream actions when a run finishes

🤖 MCP server for AI agents

Use this scraper as a tool for Claude, ChatGPT, or any AI agent via the Apify MCP Server. Your AI assistant can monitor competitor ad strategies, analyze creative trends, generate reports, and track new ads from specific brands automatically.

🧩 Related Actors

Need more data sources for your projects? Check out our other fast, reliable scrapers:

• 📢 TikTok Ads Scraper: extract TikTok Ads Library and Creative Center data — the LinkedIn Ads equivalent for TikTok, with per-country reach and engagement metrics.
• 💼 LinkedIn Ad Library Scraper: track B2B ad campaigns, targeting, and creatives from LinkedIn's Ad Library.
• 📈 Google Trends Scraper: pair ad monitoring with search interest data to see whether a brand's ad push is moving demand.
• 📰 Google News Scraper: track press coverage alongside ad activity for a full picture of a brand's market presence.

❓ Frequently asked questions (FAQ)

Does Meta offer an official API for the Ad Library?

Meta's Ad Library API exists but requires approval, has rate limits, and returns limited fields. This Actor gives you the same public data — creatives, targeting, reach, payer/beneficiary — in clean JSON, CSV, or Excel, without an approval process or quota management.

How do I scrape all ads from a specific competitor?

Search for the brand on the Facebook Ad Library website, copy the URL (it includes view_all_page_id), and paste it into the urls input. The Actor auto-paginates through every ad the page is running.

Can I get reach and demographic data, not just creatives?

Yes. Enable fetchDetails: true. Each ad is enriched with EU total reach and a full breakdown by country, age range, and gender, plus targeting (age, gender, locations) and payer/beneficiary transparency data.

Does this only cover the EU, or global ads too?

Ad creatives (copy, images, videos, CTAs) are available globally. Reach and demographic breakdowns are provided for ads shown in the EU, in line with what Meta's Ad Library transparency requirements expose.

Can I search by keyword instead of a specific page?

Yes. Use a Facebook Ad Library search URL with the q parameter (e.g. q=running shoes) instead of view_all_page_id, and the Actor will scrape the matching search results.

Can I monitor a competitor automatically and get alerted on new ads?

Yes. Use the Apify Scheduler to run the Actor daily or weekly, and connect it to Make, n8n, or a webhook to detect and alert on new ads as soon as they appear.

Is it legal to scrape the Facebook Ad Library?

The Ad Library is a public transparency tool that Meta itself makes available for anyone to browse. This Actor only collects publicly visible data with no login required. That said, you are responsible for complying with Meta's terms and applicable data protection laws for how you use the results.

What are the best alternatives for cross-platform ad intelligence?

Combine this Actor with our TikTok Ads Scraper and LinkedIn Ad Library Scraper to get a full picture of a brand's paid strategy across Meta, TikTok, and LinkedIn in one pipeline. See the Related Actors section above.

🤝 Support & resources

Need help or have a feature request? Open an issue on the Actor's Issues tab — we actively maintain this scraper.

❤️ Love this Facebook Ads Library Scraper? Please leave a review here. It really helps other users discover a reliable tool, and it's the single biggest lever for this Actor's visibility right now.

---

Built with ❤️ for marketers, media buyers, and competitive intelligence professionals