Facebook Ads Library Scraper for Marketers

Not affiliated with, endorsed by or sponsored by Meta Platforms, Inc. Facebook and Instagram are trademarks of Meta.

What does Facebook Ads Library Scraper for Marketers do?

Facebook Ads Library Scraper for Marketers collects the ads that brands run on Facebook, Instagram, Messenger, Threads and Audience Network from the public Meta Ad Library (facebook.com/ads/library). Type a keyword ("running shoes"), an advertiser Page ID or paste an Ad Library search link, pick a country, and you get one clean row per ad with the fields a marketer looks at first: advertiser, ad copy, headline, call to action, landing page URL, start date, days running, platforms and number of ad variations.

It also writes an ads-per-advertiser summary for every search: who is advertising on your keyword, how many ads each brand runs, how many variations they test and their longest-running ad. Use it as a Facebook Ads Library API: call it from the Apify API, a schedule, Make, Zapier or an AI agent. No Facebook account, login or cookies are needed.

Why use it?

• Competitor ad research: see every ad a competitor runs right now, with the copy, offer and landing page.
• Find winning ads: ads that have run for many days, or that the advertiser tests in many variations, usually perform. Sort by daysRunning or collationCount.
• Market mapping: search a niche keyword and read the summary to see which brands spend on Meta ads in it.
• Creative swipe files: collect image and video URLs, headlines and CTAs for inspiration.
• Political and issue ads: spend ranges, impressions, currency and who paid for the ad.
• Monitoring: schedule it weekly on your competitors' Page IDs and compare adArchiveId values between runs.

Dynamic creative and catalog ads often show {{product.name}} placeholders in the Ad Library data. This Actor fills bodyText, title, linkUrl and ctaText from the ad's first real card instead, so the copy you get is the copy people saw.

What data can it extract?

Field	Description
pageName, pageId, pageProfileUrl, pageLikeCount	The advertiser
bodyText, title, linkDescription	Ad copy, headline and link description
ctaText, ctaType	Call to action ("Shop now", SHOP_NOW)
linkUrl, displayUrl	Landing page URL and the domain shown on the ad
startDate, endDate, daysRunning, isActive	When the ad started, stopped and how many days it has run
platforms	facebook, instagram, messenger, threads, audience_network, whatsapp
collationCount	How many variations of this ad the advertiser runs
displayFormat	IMAGE, VIDEO, CAROUSEL, DCO (dynamic creative) or DPA (catalog)
imageUrls, videoUrls, videoPreviewImageUrls, cards	Creative media and carousel cards
spend, spendMin, spendMax, impressions, impressionsMin, impressionsMax, currency, paidForBy	Shown for political and issue ads
adArchiveId, adLibraryUrl	Ad ID and a direct link to the ad in the Ad Library
query, queryType, country	Which search found the ad

How to scrape the Facebook Ads Library

1. Add one or more search terms, advertiser Page IDs or Ad Library URLs.
2. Choose a country (US by default, or ALL), active status, ad category and media type. Optionally set a date range.
3. Set Max ads per query (default 100, up to 5,000).
4. Click Start. Download the ads as JSON, CSV or Excel, or read them through the API. The ads-per-advertiser summary is in the run's key-value store under SUMMARY.

How much does it cost?

Pay per result: $6 per 1,000 ads ($0.006 per ad), plus a tiny $0.00005 start fee per run. Proxy and compute costs are included. Searches that find no ads, invalid input and failed searches return a free row and cost nothing. Set a maximum cost per run in Apify and the Actor stops cleanly when it is reached. On the Apify Free plan, the $5 monthly credit covers about 800 ads.

Input

{
    "searchTerms": ["running shoes"],
    "pageIds": ["15087023444"],
    "country": "US",
    "activeStatus": "active",
    "adType": "all",
    "mediaType": "all",
    "maxAdsPerQuery": 100
}

Output

{
    "pageName": "Example Running Co",
    "bodyText": "Our lightest trainer yet. Free returns for 60 days.",
    "title": "Meet the Cloud Runner 2",
    "ctaText": "Shop now",
    "linkUrl": "https://example.com/cloud-runner-2",
    "startDate": "2026-08-17",
    "daysRunning": 68,
    "isActive": true,
    "platforms": ["facebook", "instagram"],
    "collationCount": 3,
    "displayFormat": "VIDEO",
    "adArchiveId": "1234567890123456",
    "adLibraryUrl": "https://www.facebook.com/ads/library/?id=1234567890123456",
    "pageId": "100000000000000",
    "imageUrls": [],
    "videoUrls": ["https://video.xx.fbcdn.net/..."],
    "query": "running shoes",
    "country": "US"
}

A search with no ads returns {"query": "...", "adsFound": 0} and is not charged.

Tips

• Page ID: open the advertiser in the Ad Library; the number after view_all_page_id= in the address bar is the Page ID. You can paste that whole link into Advertiser Page IDs.
• Exact phrase matches the whole phrase; without it, an ad that contains any of the words can match.
• Keyword results come in the order the Ad Library itself shows them, so the first ads you get are the ones a visitor sees first.
• Media URLs from Meta expire after a few days. Download the creatives you want to keep soon after the run.
• The proxy setting defaults to residential, which is included in the price. Datacenter proxies only get the first 30 ads of a search.
• Parallel queries opens one browser session per parallel query, and only when there are at least 3 queries for each session.
• Need what is said in the video ads? Facebook Ads Transcript runs the same searches and returns each video ad's transcript, spoken hook (first 5 seconds), spoken CTA, offer and angle.

Use it with AI agents (MCP)

Give Claude, ChatGPT, Cursor or any MCP client this Actor as a tool through Apify's MCP server: add https://mcp.apify.com?tools=tenfoldfleet/facebook-ads-library-scraper as a remote MCP server and sign in with your Apify account. The agent fills in the input, runs the Actor and reads the ads itself; you pay the same per-ad price as a normal run.

FAQ

Do I need a Facebook account?

No. The Meta Ad Library is public, and the Actor reads it the way a logged-out visitor does. It never logs in and uses no account cookies.

Can I get every ad of one brand?

Yes. Put the brand's Page ID in Advertiser Page IDs, set Active status to "Active and inactive ads" and Country to ALL.

Why do spend and impressions appear only on some ads?

Meta publishes spend, impressions and the payer only for ads about social issues, elections or politics. Set Ad category to "Issues, elections or politics" to search those ads.

How many ads can I get per search?

Up to 5,000 per query. Popular keywords have tens of thousands of ads; the summary shows the total that Meta reports. After the first 30 or so, Meta sends ads 10 at a time, so one query collects roughly 100 to 150 ads a minute. For several thousand ads per query, raise the run timeout or split the work over a few runs.

Disclaimer

This Actor is not affiliated with or endorsed by Meta. It collects only publicly available advertising data from the Meta Ad Library and does not log in. Make sure your use of the data complies with Meta's terms and the laws that apply to you.

More tools from Tenfold Fleet

Actor	Output
ALDI Australia Scraper - AU Products, Unit Prices & Catalogue	product
Alibaba Image Search - Reverse Lookup of Suppliers by Photo	matched product
Wholesale Suppliers - MOQ & Price Breaks (Alibaba Alternative)	product
AliExpress Reviews Scraper: Product Feedback & Photos Monitor	review
AliExpress Keyword Scraper - Exact Sold Counts by Search Term	product
Amazon Bestsellers Tracker: New Releases & Rank Changes	ranked product
Amazon Product Scraper - Details, Prices & Search by ASIN	product
Applicant Tracking Jobs Scraper - Greenhouse, Lever & 6 More	job posting
Audio Transcription: MP3 & Video Files to Text, SRT, VTT	audio minute transcribed
Backlinks Checker - Referring Domains, Anchors & Domain Rank	backlink
BBB Scraper: Business Leads, Ratings & New Reviews	business
Bilibili Scraper - Videos, Comments, Danmaku & Search	video or comment
Businesses Without Websites - Local Leads with Phone & Rating	lead
Coles Product Scraper - Australian Supermarket Prices & Deals	product
Company Contact Lookup - One Lead Record per Website	website with contacts
Contact Form Finder: Form Fields, Embed Type & Captcha Flag	website with contact page or form
CutShort Jobs Scraper - Startup Roles with INR Salary Ranges	job listing
Facebook Ads Transcript - Spoken Hook, CTA, Offer & Angle	video ad transcript
Facebook Page Contact Finder - Business Leads from Page Links	page with contact details
Facebook Reels Scraper: Views & Captions Monitor for Any Page	reel
Facebook Reels Transcript - Facebook Video to Text, No Login	reel transcript
Foundit Jobs Monitor: India, Singapore & Malaysia Jobs Scraper	job listing
Funding Rounds Scraper - Recently Funded Companies & Investors	funding round
Google Ads Transparency Center Scraper - Competitor Ads by Site	ad
Google AI Overviews Checker - Citations & Domain Tracker	keyword checked
Flights API - Route & Date Fares (Google Flights Alternative)	route search
Google Hotels Scraper - Nightly Prices, Stars & Booking Sites	hotel
Google for Jobs Scraper - Openings by City, Pay & Job Board	job listing
Google Keyword Planner Alternative - Ideas, Bids & Volume	keyword idea
Google Maps Extractor - Business Leads, Phones & Websites	place
Google News Scraper - Articles, Real URLs & Full Text	article
Google Travel Hotel Rate Tracker - OTA Prices for Every Night	offer
Search Trends by Region & Time - Google Trends Data Scraper	keyword
Hirist Jobs Scraper: India Tech Jobs with New-Job Monitor	job listing
IIMJobs Jobs Scraper: Search & Monitor Management Roles	job listing
India Jobs Feed: Hirist, IIMJobs, Foundit, Instahyre & Cutshort	job listing
Instagram Reels Analytics - Profile Reel Plays, Likes, Comments	reel
Instagram Reels Search - Keyword to Top Reels, Plays & Creators	reel
Instagram Reels Transcript - Speech to Text for Public Reels	reel transcript
Instahyre Jobs Monitor: New Tech Jobs in India by Skill	job listing
Keyword Ideas & Related Keywords - Difficulty, Volume & CPC	keyword idea
Keyword Search Volume, CPC & Difficulty Checker (Bulk)	keyword with data
Likee Scraper - Creators by Country, Video Views & Likes	video
LinkedIn Ads Library Scraper - Competitor Ad Copy & Targeting	ad
LinkedIn Company Posts Monitor: New Posts, No Login	post
LinkedIn Company Scraper: Firmographics & Recent Posts	company
Naver Shopping Scraper - Keyword Rank, Prices, Ads & Malls	product
Pinterest Search Scraper: Pins, Promoted Ads & Shop Trends	pin
Podcast Transcription: Episodes to Text, SRT & Monitor	audio minute transcribed
Reddit Brand Monitoring - Keyword Alerts for Posts & Comments	mention
Reddit Post Comments Export: Threads to JSON & CSV	comment
Remote Job Board Scraper - Remote Jobs Aggregator, 7 Sites	unique remote job
Reverse Image Search - Find Every Site Using a Photo	image searched
SEEK Jobs Scraper - Salaries & Hiring Across 8 APAC Job Boards	job listing
Semrush API Domain Traffic: Visits, Authority Score, AI Traffic	domain
SEO Agent - AI Keyword Research & Competitor Reports	research report
SEO Crawler - Technical SEO Audit Tool & On-Page Checker	page audit
SEO Competitor Keywords - Domain Ranked Keywords & Keyword Gap	keyword
Shopify Inventory Scraper - SKUs, Variants & In-Stock Status	product
Shopify App & Theme Detector - Store Analyzer & Contacts	shopify store
Sitemap URL Extractor - All URLs from sitemap.xml & robots.txt	url
Stock Photos & Videos Scraper for Pexels	media item
Website Built With Checker - Find Any Site's CMS & Tech Stack	website
Telegram Keyword Search Monitor - New Mentions in Channels	matching message
Threads Search - Keyword & Profile Posts Scraper (No Login)	post
TikTok Ads Library Scraper: Competitor Ads in Europe	ad
TikTok Transcripts - Captions or Speech to Text for Any Video	video transcript
Twitter Video Transcript - X Video to Text & SRT	video transcript
HTML to Text & URL to Markdown - LLM Ready Web Content	page
Video Transcriber - Any Link to Text, SRT & VTT (7 Platforms)	video transcribed
Website Traffic Checker - Bulk Domain Traffic Estimate	domain with traffic data
WeChat Official Account Articles - Keyword Search to Markdown	article found
Weibo Scraper - Comment Threads, Hot Search Ranks & User Stats	comment
Woolworths Product Scraper - AU Shelf Prices, Specials & GTINs	product
Workday Jobs Scraper - myworkdayjobs.com API with Salary	job posting
Yahoo Finance Scraper - Quotes, History, Fundamentals & News	ticker row
YouTube Channel Email Scraper - Creator Contact Extractor	channel with email
YouTube Livestream & Channel Scraper - Videos, Likes & Stats	video
YouTube Comments Scraper - Replies, Likes & Sort by Newest	comment
YouTube Search Scraper: Keyword Video & Shorts Monitor	search result
YouTube Shorts Analytics Scraper - Views, Likes & Hashtags	short
YouTube Captions Downloader - Transcript & Subtitles Scraper	transcript
YouTube Video Details Lookup: Views, Likes & Tags by URL	video details