📢 Facebook Ads Library Scraper

🚀 Collect competitor ad intelligence from Meta's Ads Library. Search by keyword, advertiser page, or URL. Get creative text, spend ranges, impressions, demographics, and delivery regions for up to 1M ads per run.

🕒 Last updated: 2026-04-21

Facebook Ads Library Scraper connects to Meta's public Ads Library through your free access token and returns structured ad data. Each record includes the creative text, snapshot URL, landing page, spend range, impression range, demographic breakdown, regional delivery data, publisher platforms, and delivery dates. You can search by keyword, specific advertiser page ID, or paste Ads Library URLs directly. Filter by country, active/inactive status, ad type, platform, and date range.

Marketing teams use this to monitor competitor campaigns and benchmark creative strategies. Media buyers track spend patterns across markets. Political researchers audit election ad activity. Agencies pull bulk data for client reports. If you need structured access to Meta's transparency data without hours of manual browsing and copy-pasting, this actor automates the entire workflow.

Target	Meta Ads Library (Facebook, Instagram, Messenger, Audience Network)
Use Cases	Competitor ad monitoring, creative benchmarking, spend tracking, political ad auditing

---

📋 What it does

• 🔍 Multi-mode search. Search by keyword, advertiser page ID, or paste Ads Library URLs directly.
• 🌍 Country and platform filters. Scope results to specific markets and channels.
• 📅 Date range filtering. Track campaigns by delivery period with presets or custom dates.
• 💰 Spend and impression data. Estimated budget and reach ranges per ad.
• 👥 Demographic breakdowns. Age, gender, and geographic delivery distribution per ad.

Each ad record gives you 20+ fields covering what the ad says, where it runs, how much it costs, who sees it, and when it was active.

💡 Why it matters: Tracking competitor ad strategy manually means searching one advertiser at a time, scrolling through results, and pasting data into spreadsheets. This actor exports the entire dataset in bulk, filtered and structured, ready for your dashboard.

---

🎬 Full Demo

🚧 Coming soon: a 3-minute walkthrough showing how to go from sign-up to a downloaded dataset.

---

⚙️ Input

Input	Type	Default	Behavior
urls	array	[]	Ads Library search URLs or Page URLs. Parameters extracted automatically.
searchQuery	string	"coca cola"	Keyword or phrase to search in ad content. Use this or advertiserPageId, not both.
advertiserPageId	string	-	Facebook Page ID of a specific advertiser (e.g. "14226545351" for Red Bull).
adReachedCountries	array	["US"]	2-letter ISO country codes. Use "ALL" for all countries.
adActiveStatus	string	"active"	Filter: active, inactive, or all.
adType	string	"ALL"	Category: all, political/issue, housing, employment, or credit.
period	string	All time	Preset date range: last 24h, 7d, 14d, 30d, or 90d.
startDate	string	-	Custom start date (YYYY-MM-DD). Overrides period.
endDate	string	-	Custom end date (YYYY-MM-DD). Defaults to today.
sortBy	string	"impressions_desc"	Sort by most impressions or most recent.
maxItems	integer	5	Max ads to collect. Free: up to 100. Paid: up to 1,000,000.
runTag	string	-	Custom tag added to every output row for batch identification.
requestDelayMs	integer	500	Delay between pagination requests in milliseconds.

Example: active Nike ads in the US sorted by impressions.

{
  "searchQuery": "nike shoes",
  "maxItems": 50,
  "adReachedCountries": ["US"],
  "adActiveStatus": "active",
  "sortBy": "impressions_desc"
}

Example: all ads from a specific advertiser across US and UK.

{
  "advertiserPageId": "14226545351",
  "maxItems": 200,
  "adReachedCountries": ["US", "GB"],
  "adActiveStatus": "all"
}

⚠️ Good to Know: You need a free Meta access token from developers.facebook.com to use this actor. No paid Meta plan is required. The token grants access to Meta's public transparency data.

---

📊 Output

Each record contains 20+ fields. Download as CSV, Excel, JSON, or XML.

🧾 Schema

Field	Type	Example
🆔 adArchiveId	string	"987654321"
📝 adCreativeBody	string	"Summer sale: 50% off all shoes..."
🖼️ adSnapshotUrl	string	"https://www.facebook.com/ads/archive/..."
🔗 linkUrl	string	"https://www.nike.com/sale"
👤 pageName	string	"Nike"
📅 adDeliveryStartTime	string	"2026-03-15"
✅ adActiveStatus	string	"ACTIVE"
🎯 publisherPlatforms	array	["facebook", "instagram"]
💰 spendLower	number	500
💰 spendUpper	number	999
📊 impressionsLower	number	10000
📊 impressionsUpper	number	50000
📍 deliveryByRegion	array	[{"region": "California", "percentage": 0.18}]
👥 demographicDistribution	array	[{"age": "25-34", "gender": "female", "percentage": 0.32}]

📦 Sample records

---

✨ Why choose this Actor

	Capability
🔍	Three input modes. Search by keyword, advertiser page ID, or paste Ads Library URLs.
🌍	All countries. Filter ads by any combination of country codes or use ALL for global.
💰	Spend and impressions. Estimated budget and reach ranges for competitive benchmarking.
👥	Demographics. Age, gender, and regional delivery breakdowns per ad.
📅	Date filtering. Custom date ranges and presets for campaign-level analysis.
📊	Scale to 1M ads. From quick spot-checks to full advertiser audits.
🔌	Official Meta API. Uses your free access token against Meta's transparency endpoint.

Meta's Ads Library is the largest public database of digital advertising, covering Facebook, Instagram, Messenger, and Audience Network.

---

📈 How it compares to alternatives

Approach	Cost	Coverage	Refresh	Setup
⭐ Facebook Ads Library Scraper (this Actor)	$5 free credit, then pay-per-use	Up to 1M ads, 20+ fields	Live per run	⚡ 5 min
Manual Ads Library browsing	Free (your time)	One page at a time	Manual	Hours per batch
Paid competitive intelligence platforms	$99-999/month	Multi-channel	Daily/weekly	Hours of onboarding
Custom Meta API integration	Engineering time	Same data	As coded	Days to weeks

Pick this actor when you need bulk access to Meta's ad transparency data without building a custom API integration.

---

🚀 How to use

1. 📝 Sign up. Create a free account with $5 credit (takes 2 minutes).
2. 🌐 Open the Actor. Go to the Facebook Ads Library Scraper page on the Apify Store.
3. 🎯 Set input. Enter a search query or advertiser page ID. Set country, date range, and filters.
4. 🚀 Run it. Click Start and let the Actor collect your data.
5. 📥 Download. Grab your results in the Dataset tab as CSV, Excel, JSON, or XML.

⏱️ Total time from signup to downloaded dataset: 3-5 minutes. No coding required.

---

💼 Business use cases

📊 Competitive Intelligence Monitor competitor ad creative and messaging Track spend patterns across markets and seasons Identify new product launches through ad activity Benchmark your creative against industry leaders	🎯 Media Buying Analyze competitor targeting by demographics and regions Identify which platforms competitors prioritize Track ad lifespans to estimate campaign budgets Study what creative styles get the most impressions
🏛️ Political and Compliance Research Audit political ad activity by region and spend Monitor housing, employment, and credit ad compliance Track issue-based advertising across election cycles Build transparency reports for public accountability	📈 Agency Reporting Pull bulk ad data for client competitive reports Tag runs by client or campaign for organized analysis Compare ad performance across multiple markets Generate weekly or monthly ad landscape summaries

---

---

🌟 Beyond business use cases

Data like this powers more than commercial workflows. The same structured records support research, education, civic projects, and personal initiatives.

🎓 Research and academia Empirical datasets for papers, thesis work, and coursework Longitudinal studies tracking changes across snapshots Reproducible research with cited, versioned data pulls Classroom exercises on data analysis and ethical scraping	🎨 Personal and creative Side projects, portfolio demos, and indie app launches Data visualizations, dashboards, and infographics Content research for bloggers, YouTubers, and podcasters Hobbyist collections and personal trackers
🤝 Non-profit and civic Transparency reporting and accountability projects Advocacy campaigns backed by public-interest data Community-run databases for local issues Investigative journalism on public records	🧪 Experimentation Prototype AI and machine-learning pipelines with real data Validate product-market hypotheses before engineering spend Train small domain-specific models on niche corpora Test dashboard concepts with live input

🤖 Ask an AI assistant about this scraper

Open a ready-to-send prompt about this ParseForge actor in the AI of your choice:

• 💬 ChatGPT
• 🧠 Claude
• 🔍 Perplexity
• 🅒 Copilot

❓ Frequently Asked Questions

---

🔌 Automating Facebook Ads Library Scraper

Control the scraper programmatically for scheduled runs and pipeline integrations:

• 🟢 Node.js. Install the apify-client NPM package.
• 🐍 Python. Use the apify-client PyPI package.
• 📚 See the Apify API documentation for full details.

The Apify Schedules feature lets you trigger this Actor on any cron interval. Schedule weekly runs to track competitor ad changes over time.

🔌 Integrate with any app

Facebook Ads Library Scraper connects to any cloud service via Apify integrations:

• Make - Automate multi-step workflows
• Zapier - Connect with 5,000+ apps
• Slack - Get run notifications
• Airbyte - Pipe data into your warehouse
• GitHub - Trigger runs from commits
• Google Drive - Export datasets straight to Sheets

You can also use webhooks to trigger downstream actions when a run finishes.

---

🔗 Recommended Actors

• 🛍️ Shopify Products Scraper - Collect product catalogs from Shopify stores
• 📊 Smart Apify Actor Scraper - Scrape actor metadata and quality metrics
• 📰 PR Newswire Scraper - Extract press releases and news
• 🏢 Hubspot Marketplace Scraper - Collect app marketplace data
• 💼 Craigslist Scraper - Classified listings from Craigslist

💡 Pro Tip: browse the complete ParseForge collection for more data scrapers and tools.

---

🆘 Need Help? Open our contact form to request a new scraper, propose a custom data project, or report an issue.

---

⚠️ Disclaimer: this Actor is an independent tool and is not affiliated with, endorsed by, or sponsored by Meta Platforms, Inc. All trademarks mentioned are the property of their respective owners. Only publicly available data is collected through Meta's official transparency API.