Facebook Ad Library Scraper: Meta Ad Library Ads
Pricing
from $0.40 / 1,000 results
Facebook Ad Library Scraper: Meta Ad Library Ads
Facebook Ad Library Scraper for the Meta Ad Library: extract ads by advertiser domain, keyword or Facebook Page ID. Ad copy, creative URLs, CTA, platforms, dates, active status and EU spend and impression ranges. No login or API key.
Pricing
from $0.40 / 1,000 results
Rating
0.0
(0)
Developer
Rastriq — Structured data from the world
Maintained by CommunityActor stats
0
Bookmarked
10
Total users
3
Monthly active users
7 hours ago
Last modified
Categories
Features
Share
Facebook Ad Library Scraper: Meta Ad Library Ads, No Login
Facebook Ad Library Scraper extracts ads from the public Meta Ad Library (Facebook, Instagram, Messenger and Audience Network ads) by advertiser domain, keyword or Facebook Page ID. You get ad copy, creative URLs, destination links, call-to-action, platforms, dates, active status and, for EU countries, spend and impression ranges. No Facebook login, no API key. Export as JSON, CSV or Excel.
HTTP-first, residential proxy. Ads are read directly from the Ad Library page and its internal pagination (no browser, ~0.5 MB of proxy traffic per 200 ads). If Facebook blocks that path, the Actor automatically falls back to a Playwright browser (slower, ~3 MB of proxy traffic per run). 2 GB memory is enough for both paths.
🚀 What is Facebook Ad Library Scraper?
Facebook Ad Library Scraper is a Meta Ad Library scraper for competitive intelligence, ad monitoring and creative research. It requests facebook.com/ads/library with your search (the first ~30 ads come embedded in the page), then pages through Meta's internal GraphQL endpoint (10 ads per page) until maxResults is reached or the Ad Library has no more ads. Only if that HTTP path fails does it load the page in a browser and scroll.
Use it to:
- 🕵️ Watch what competitors advertise in a given country
- 🎨 Collect ad creatives and call-to-action types for inspiration
- 📅 Track when ads started and stopped running
- 💶 Read spend and impression ranges where Meta discloses them (EU countries)
🔎 Three search modes
| Mode | Field | When to use |
|---|---|---|
| Page ID search | view_all_page_id | You know the Facebook Page ID. Returns ONLY ads from that page. Most precise. |
| Domain search | domain | You know the advertiser's website (e.g. toyota.cl). Exact-phrase match. |
| Keyword search | keyword | You only know the brand name. Broader results. |
If several fields are set, priority is: view_all_page_id > domain > keyword.
Finding a Page ID: open facebook.com/ads/library, search the brand, click an ad, then "See all ads from this advertiser". The URL contains view_all_page_id=XXXXXXXXXXXX.
📋 What data does Facebook Ad Library Scraper extract?
| Field | Description |
|---|---|
ad_archive_id, ad_url | Ad ID (dedup key) and direct link to the ad in the Ad Library |
page_id, page_name, page_url | Advertiser page |
status, is_active | active / inactive |
body | Ad text (first 600 characters) |
link_url, link_title, link_description | Destination URL and link card text |
creative_url | Image or video asset URL (when present in the ad) |
cta_type | Call to action, e.g. LEARN_MORE, SHOP_NOW (when present) |
start_date, end_date | First and last shown date (YYYY-MM-DD) |
platforms | Comma-separated platforms (FACEBOOK, INSTAGRAM, ...) |
media_type | text, image or video |
contains_digital_created_media | true when Meta flags the ad as containing digitally created or altered media (AI-generated or edited); null when Meta does not return the flag |
impressions_lower, impressions_upper | Impression range, only where Meta discloses it (EU countries) |
spend_lower, spend_upper, spend_currency | Spend range, same condition |
collation_id, keyword, country, scraped_at, source | Grouping ID, query used, country, UTC timestamp, source label |
Spend and impression fields are empty strings for countries where Meta does not disclose them (e.g. CL, MX, US).
The country field in each row echoes the country you searched (ALL when you searched all countries); it is not the ad's targeting.
Proxy country: by default the residential proxy exits from the searched country. With country: "ALL" it exits from any country. Set a proxy country in Proxy configuration to override.
▶️ How to use Facebook Ad Library Scraper
- Open the Actor in Apify Console.
- Enter a keyword, an advertiser domain or a Facebook Page ID (the form is prefilled with the keyword
Nike). - Pick a country and set Max ads (start with 10).
- Click Start. A 10-ad run finished in about 20 seconds in our tests.
- Download the dataset as JSON, CSV or Excel, or call it from the API.
⚙️ Input parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
domain | string | - | Advertiser domain, exact phrase match (e.g. toyota.cl). |
keyword | string | - | Keyword searched in ad text (e.g. Toyota Chile). |
view_all_page_id | string | - | Facebook Page ID; returns only ads from that page. |
country | string | ES | ISO code of the Ad Library country. Supported: all EU/EEA countries (AT, BE, BG, HR, CY, CZ, DK, EE, FI, FR, DE, GR, HU, IE, IT, LV, LT, LU, MT, NL, PL, PT, RO, SK, SI, ES, SE, IS, LI, NO), GB, CH, US, BR, MX, AR, CL, CO, PE, EC, or ALL for every country. |
maxResults | integer | 200 | Maximum ads to scrape (1-5000). |
headless | boolean | true | Headless mode for the fallback browser. |
proxyConfiguration | object | Apify Proxy, RESIDENTIAL | Proxy settings. Residential is required: Facebook blocks datacenter IPs. |
Example inputs:
{ "domain": "toyota.cl", "country": "CL", "maxResults": 100 }
{ "view_all_page_id": "303915015690", "country": "CL", "maxResults": 200 }
{ "view_all_page_id": "179309902160776", "country": "BE", "maxResults": 50 }
📦 Output example
A real record from the Actor's output:
{"ad_archive_id": "1780138433194637","ad_url": "https://www.facebook.com/ads/library/?id=1780138433194637","collation_id": "949012497834209","page_id": "177540868925607","page_name": "Volkswagen","page_url": "https://www.facebook.com/VolkswagenChileOficial/","status": "active","body": "Diseñado para el pulso de la ciudad. Volkswagen Tera combina una silueta moderna y ágil con la altura y robustez de un verdadero SUVW","link_url": "https://www.cotizadoronline.cl/volkswagen/?utm_source=meta&utm_medium=advantage&utm_content=516&utm_term=conversion&utm_campaign=vw_tera_202606","link_title": "Súbete a un SUVW\n","link_description": "Conectado, eficiente y con todo el estilo. Súbete a Volkswagen Tera, tu primer SUVW\n","creative_url": "https://scontent-scl3-1.xx.fbcdn.net/v/t39.35426-6/825286422_2336403780250888_4134902428541484290_n.jpg?...","cta_type": "GET_QUOTE","start_date": "2026-10-02","end_date": "2026-10-02","platforms": "FACEBOOK, INSTAGRAM, AUDIENCE_NETWORK, MESSENGER, THREADS","media_type": "text","is_active": true,"contains_digital_created_media": false,"impressions_lower": "","impressions_upper": "","spend_lower": "","spend_upper": "","spend_currency": "","keyword": "page:177540868925607","country": "CL","scraped_at": "2026-10-02 22:39:14","source": "facebook_ad_library"}
💰 How much does it cost to scrape the Facebook Ad Library?
Facebook Ad Library Scraper uses Pay-Per-Event pricing:
| Event | Price (USD) | When it is charged |
|---|---|---|
| Actor Start | $0.005 | Once per run, one event per GB of memory (minimum one) |
| result | $0.0004 | Each ad saved to the dataset |
With the default 2048 MB (2 start events = $0.010):
| Ads | Total |
|---|---|
| 10 | $0.014 |
| 200 | $0.09 |
5,000 (maxResults limit) | $2.01 |
Set maxResults or Apify's maximum-cost-per-run setting to cap spend.
🤖 Use with Claude/ChatGPT (MCP)
Call Facebook Ad Library Scraper from an AI assistant through the Apify MCP server.
- Hosted server (all tools):
https://mcp.apify.com - Only this Actor:
https://mcp.apify.com?tools=actors,rastriq/fb-adlibrary-scraper - Local client:
npx @apify/actors-mcp-server --tools rastriq/fb-adlibrary-scraperwith theAPIFY_TOKENenvironment variable set.
Example prompts:
- "Use the Facebook Ad Library Scraper to get 10 Nike ads running in Spain and summarize the call-to-action types."
- "Find ads from the domain leroymerlin.es in the Meta Ad Library and list which platforms they run on."
- "Get 20 ads for Facebook Page ID 100064506498498 in the US and tell me which are still active."
🔗 Related Rastriq ad-library Actors
Compare ads across platforms with Rastriq's other ad-library scrapers. Each has its own output fields, so map them before merging datasets.
| Actor | What it adds |
|---|---|
| Google Ads Transparency Scraper | Search, Display and YouTube ads from Google's Ads Transparency Center |
| TikTok Ad Library Scraper | Ads, targeting and audience data from TikTok's EU ad library |
| LinkedIn Ad Library Scraper | B2B ads from LinkedIn's Ad Library |
| TikTok Top Ads Scraper | Best-performing ads from TikTok Creative Center |
❓ FAQ
Is it legal to scrape the Meta Ad Library?
The Actor reads only publicly visible ad data, the same data shown at facebook.com/ads/library without login. No personal user data is collected. Check the Ad Library terms and your local regulations for your use case.
Which search mode should I use?
view_all_page_id when you know the Page ID, domain when you know the website, keyword when you only know the brand.
Why are impressions_* and spend_* empty?
Meta discloses them only for some countries (EU under the Digital Services Act). Elsewhere they are empty strings.
Why does a run return fewer ads than the Ad Library counter?
The counter (~N results) is approximate and usually 15-20% higher than the distinct ads paged, because grouped creatives are counted several times.
What do the run statuses mean?
Succeeded: at least one ad. PARTIAL (still succeeded): the run stopped early, e.g. after a block; the status message says why. Failed: 0 ads; the message tells whether the Ad Library reports 0 results, the input was empty, or the page was blocked.
Can I find ads made or edited with AI?
Yes, as far as Meta flags them. Every ad includes contains_digital_created_media, Meta's own flag for digitally created or altered media (AI-generated or edited), read straight from the Ad Library. Filter by true to keep flagged ads. The flag comes from advertiser disclosure and Meta's labeling, so an AI-made ad without the flag is possible. null means Meta did not return the flag for that ad.
Do I need a Facebook account or API key?
No. The Actor uses residential proxies by default.
Where do I report a problem?
Open an issue in the Issues tab with your input and run ID.