If you need to pull Facebook Ad Library data at scale and there's no clean official API, this guide shows how to export it to JSON, CSV or Excel in a couple of minutes — with no scraping code to maintain.
We'll use the Facebook Ad Library Scraper - Meta Ads Spy Tool, a hosted scraper on the Apify platform. You only need a free Apify token — no Facebook Ad Library login, no proxies, no reverse-engineering.
What data you get
Each run returns structured records with fields like:
pageNamebodyTextpublisherPlatformstatusstartDatespendLowerBoundadLibraryUrladArchiveIdpageIdpageUrlpageProfilePicturepageCategoriespageLikeCountisActive
Results are paginated automatically — you can pull thousands of rows per run and export them as JSON, CSV, Excel, JSONL or XML.
Option 1 — No code (Apify Console)
- Open the actor: https://apify.com/logiover/meta-ad-library-scraper
- Click Try for free.
- Leave the input empty for a broad sample, or set the fields below.
- Run it, then Export the dataset as CSV/JSON/Excel.
Option 2 — Node.js
npm install meta-ad-library-scraper
const scrape = require("meta-ad-library-scraper");
(async () => {
const items = await scrape({}, { token: process.env.APIFY_TOKEN });
console.log(items.length, "results");
console.log(items[0]);
})();
Option 3 — Python
pip install meta-ad-library-scraper
from meta_ad_library_scraper import scrape
items = scrape({}, token="YOUR_APIFY_TOKEN")
print(len(items), "results")
print(items[0])
Grab a free token at https://console.apify.com/account/integrations.
Input options
| Field | Type | What it does |
|---|---|---|
searchTerms |
array | Search terms (keywords / advertiser names) |
pageIds |
array | Advertiser Page IDs |
country |
string | Country |
adType |
string | Ad type |
activeStatus |
string | Active status |
mediaType |
string | Media type |
maxResults |
integer | Max results |
proxyConfiguration |
object | Proxy |
Common use cases
- Build a fresh Facebook Ad Library dataset for analysis or dashboards
- Feed Facebook Ad Library records into your own app, CRM or spreadsheet
- Monitor changes on a schedule and get alerts via webhooks
- Enrich leads or research with up-to-date Facebook Ad Library data
Automation & export
Because it runs on Apify, you can schedule it, trigger it via webhook, and pipe results into Google Sheets, S3, Zapier, Make or n8n. Every run's dataset is downloadable as CSV, JSON, JSONL, Excel or XML.
FAQ
Do I need an API key? Only a free Apify token. No Facebook Ad Library account needed.
How many results can I get? Thousands per run; raise the limit to pull more.
Is it an official Facebook Ad Library API? No — it's an unofficial, maintained alternative when there's no official or affordable API.
Can I export to CSV/Excel? Yes — JSON, CSV, JSONL, Excel and XML.
▶️ Run the Facebook Ad Library Scraper - Meta Ads Spy Tool on Apify: https://apify.com/logiover/meta-ad-library-scraper
📚 Docs & code examples: https://github.com/logiover/meta-ad-library-scraper
🧰 More scrapers: https://apify.com/logiover
Top comments (0)