Facebook Ads Library Scraper API - Ad Copy, CTA, Impressions
Pricing
from $6.88 / 1,000 ads
Facebook Ads Library Scraper API - Ad Copy, CTA, Impressions
Facebook Ads Library scraper API: scrape any advertiser's Facebook and Instagram ads from Meta's Ad Library: ad text, headline, call to action, landing page, format, platforms, impressions band, page likes and dates. Search by page name. No login. $12.50 per 1,000 ads.
Pricing
from $6.88 / 1,000 ads
Rating
0.0
(0)
Developer
Khandji Omar
Maintained by CommunityActor stats
0
Bookmarked
2
Total users
2
Monthly active users
9 hours ago
Last modified
Categories
Features
Share
Facebook Ads Library Scraper API — Ad Copy, CTA, Impressions
Scrape any advertiser's Facebook and Instagram ads from Meta's Ad Library: ad text, headline, call to action, landing page, format, platforms, impressions band, page likes and dates. Search by page name. Export to JSON, CSV or Excel, or use the API. No login.
Price: $12.50 per 1,000 ads ($0.0125 per ad). The first 10 results of every run are free.
In short: what you give, what you get, what it costs
| You give | Facebook page names |
| We do | Read the advertiser's ads in Meta's public Ad Library |
| You get | One row per ad: text, headline, call to action, landing page, format, platforms (Facebook, Instagram...), impressions band, page likes and dates, plus every field the supplier returns (source_data) |
| It costs | $12.50 per 1,000 ads, no start fee. From 16 November 2026: +$0.001 per run. Optional scheduled monitoring: +$0.45 per check (one-off runs never pay it). Apify also bills the supplier Actor jmlp/meta-ad-library-scraper that this robot runs for you, at its own price (about $0.15 per 1,000 results). The first 10 results of every run are free of this robot's fee. |
| It does not | Sign in to Facebook |
A real result row is shown further down this page.
Free tier — 10 results free on every run
The free results waive this Actor's own fee; the source Actor (jmlp/meta-ad-library-scraper) still bills its own price for every row it returns.
The first 10 results of every run are free, on every run you ever make — not a one-off trial. Run it on your own subjects and see the real output before you are billed for a single result.
One guard: the free allowance never covers more than half of a run, so a run returning 6 results gets 3 free. That keeps the offer sustainable.
What it does
Run it once and get the full, current data as clean rows you can export to JSON, CSV or Excel, or pull through the API. Need only fresh data? Turn on monitorEnabled and schedule it: every later run returns only what is new or changed since the previous one, so you never re-download or re-pay for the same rows.
Compared with apify/facebook-ads-scraper
Read on the Store on 2026-10-23 (Facebook Ads Library Scraper). Where it does better, this section says so.
- Data source: this Actor runs jmlp/meta-ad-library-scraper for you, then cleans and checks every row.
- Only here (fields its Store page does not list):
change_type(new or changed since your last scheduled run);runs_seen(how many of your runs have seen it);long_running_creative(ad running long enough to be a proven winner);why_it_matters(one-line reading of the row). - This Actor's fee is free on the first results of every run, and a hard cost cap (
maxTotalChargeUsd) limits it. - Price: about $12.65 per 1,000 in total here ($12.5 for this Actor + $0.15 for jmlp/meta-ad-library-scraper), $5.8 at apify/facebook-ads-scraper.
Why this scraper
- Try before you pay. The first 10 results of every run are free, on every run.
- Pay only for data delivered. Failed sources and failed inputs are never billed.
- Cost cap on this Actor's fee. Set
maxTotalChargeUsdto cap this Actor's own fee; the supplier Actor is capped separately on every call, at its own price. - Only-new mode. With
monitorEnabledon a schedule, you get just the new or changed rows, plus a spike signal when volume suddenly jumps. - Clean, normalized rows with the same field names every run, plus a
RUN_SUMMARY.json— ready for spreadsheets, databases, n8n/Make/Zapier and AI agents (MCP).
Example input
{"pageNames": ["Nike","Allbirds"],"maxTotalChargeUsd": 1.0}
This returns the full current data right away. To receive only what is new on a schedule, add "monitorEnabled": true: the first monitored run stores a free baseline, later runs return only new or changed rows. Pin a monitorId to keep separate targets from sharing state.
Output
Each row is one ad. A real row from a run on Apify (long texts are cut here and people's names hidden; your dataset has them in full):
A real row from this Actor's latest run on Apify (2026-10-26; long texts are cut and people's names hidden here, your dataset has them in full):
{"ad_id": "1077427058038979","page_name": "Nike","creative": "Meus looks favoritos são a combinação perfeita entre o esportivo e o casual 😮💨 @nikesportswear \nAs fotos são do melhor fotógrafo do mund...","landing_url": "https://www.nike.com.br/busca?term=initiator","is_active": true,"start_date": "2026-08-14T07:00:00Z","ad_archive_id": "1077427058038979","page_id": "15087023444","has_user_reported": "(hidden here)","page_is_deleted": false,"categories": ["UNKNOWN"],"collation_count": 1,"collation_id": "1617744163243628","contains_digital_created_media": false,"contains_sensitive_content": false,"end_date": 1792998000,"gated_type": "ELIGIBLE","hide_data_status": "NONE","is_aaa_eligible": false,"publisher_platform": ["FACEBOOK","INSTAGRAM"],"snapshot_branded_content_page_id": "15087023444","snapshot_branded_content_page_is_deleted": false,"snapshot_branded_content_page_profile_uri": "https://www.facebook.com/nike/","snapshot_branded_content_page_name": "Nike","snapshot_page_id": "15087023444","snapshot_page_is_deleted": false,"snapshot_page_profile_uri": "https://www.facebook.com/nike/","snapshot_page_name": "Nike","snapshot_page_profile_picture_url": "(hidden here)","snapshot_body_text": "Meus looks favoritos são a combinação perfeita entre o esportivo e o casual 😮💨 @nikesportswear \nAs fotos são do melhor fotógrafo do mund...","snapshot_is_reshared": false,"snapshot_caption": "nike.com.br","snapshot_cards_count": 8,"snapshot_cards_title": ["initiator - Nike","initiator - Nike"],"snapshot_cta_text": "Shop now","snapshot_cta_type": "SHOP_NOW","snapshot_display_format": "CAROUSEL","snapshot_link_url": "https://www.nike.com.br/busca?term=initiator","snapshot_page_categories": ["Sportswear"],"snapshot_page_like_count": 39495632,"snapshot_title": "Nike","impressions_with_index_impressions_index": -1,"regional_regulation_data_finserv_is_deemed_finserv": false,"regional_regulation_data_finserv_is_limited_delivery": false,"regional_regulation_data_tw_anti_scam_is_limited_delivery": false,"record_id": "1077427058038979","creative_fingerprint": "8f1b0ca4710d186f5b748e5fff41430d4aac3a4dfb106a43ac06f8493953da98","change_type": "new","runs_seen": 0,"long_running_creative": false,"why_it_matters": "Competitor launched a new ad — see what they're pushing."}
| Field | What it holds |
|---|---|
pageName | advertiser's Facebook page name |
adArchiveID | ad ID in Meta's Ad Library |
isActive | true while the ad is still running |
startDateFormatted | date the ad started |
endDateFormatted | date the ad stopped (or last seen) |
publisherPlatform | where it runs: Facebook, Instagram, Messenger, Audience Network |
collationCount | how many near-identical versions of this ad run |
categories | ad category (e.g. political, housing) |
containsSensitiveContent | flagged as sensitive by Meta |
long_running_creative | true when the ad has run long enough to be a proven winner |
runs_seen | how many of your runs have seen this ad |
why_it_matters | one-line reading of the ad for a marketer |
Each row also keeps the other fields the source returns, so you get everything above and more. In the Output tab, the Overview table shows these columns, readable without any code; export them as CSV, Excel, JSON or HTML.
Every field
| Field | What it holds |
|---|---|
ad_id | ad ID |
page_name | page name |
creative | creative |
landing_url | landing URL |
is_active | is active |
start_date | start date |
ad_archive_id | ad archive ID |
page_id | page ID |
has_user_reported | has user reported |
page_is_deleted | page is deleted |
categories | categories |
collation_count | collation count |
collation_id | collation ID |
contains_digital_created_media | contains digital created media |
contains_sensitive_content | contains sensitive content |
end_date | end date |
gated_type | gated type |
hide_data_status | hide data status |
is_aaa_eligible | is aaa eligible |
publisher_platform | publisher platform |
snapshot_page_id | snapshot page ID |
snapshot_page_is_deleted | snapshot page is deleted |
snapshot_page_profile_uri | snapshot page profile uri |
snapshot_page_name | snapshot page name |
snapshot_page_profile_picture_url | snapshot page profile picture URL |
snapshot_body_text | snapshot body text |
snapshot_is_reshared | snapshot is reshared |
snapshot_caption | snapshot caption |
snapshot_cta_text | snapshot call to action text |
snapshot_cta_type | snapshot call to action type |
snapshot_display_format | snapshot display format |
snapshot_link_url | snapshot link URL |
snapshot_page_categories | snapshot page categories |
snapshot_page_like_count | snapshot page like count |
snapshot_title | snapshot title |
impressions_with_index_impressions_index | impressions with index impressions index |
regional_regulation_data_finserv_is_deemed_finserv | regional regulation data finserv is deemed finserv |
regional_regulation_data_finserv_is_limited_delivery | regional regulation data finserv is limited delivery |
regional_regulation_data_tw_anti_scam_is_limited_delivery | regional regulation data tw anti scam is limited delivery |
record_id | stable ID of the row (used for new-only delivery) |
creative_fingerprint | fingerprint of the ad creative (detects edits) |
change_type | new / changed / removed since your last run |
runs_seen | how many runs this ad has been seen in |
long_running_creative | true when an ad keeps running (a likely winner) |
why_it_matters | one-line reason this row deserves attention |
snapshot_link_description | snapshot link description |
snapshot_branded_content_page_id | snapshot branded content page ID |
snapshot_branded_content_page_is_deleted | snapshot branded content page is deleted |
snapshot_branded_content_page_profile_uri | snapshot branded content page profile uri |
snapshot_branded_content_page_name | snapshot branded content page name |
source_data | every field jmlp/meta-ad-library-scraper returns for this row, untouched |
Each row also carries source_data: the full row returned by jmlp/meta-ad-library-scraper, every field it gives, untouched — you never get less than the supplier itself delivers. Our own fields above stay exactly as they are. A row over 200 KB is trimmed and source_data_trimmed lists the fields cut.
How you're charged
- Source Actor charge: this Actor runs jmlp/meta-ad-library-scraper inside your run, and Apify bills that run to your account at jmlp/meta-ad-library-scraper's own price (about $0.15 per 1,000 results, read on 2026-10-23), on top of this Actor's price. Each call to it is capped at $0.50.
- Ad — $0.0125 per ad ($12.50 per 1,000), billed for each ad delivered to your dataset. With scheduled monitoring on, only ads that are new or changed since the last check are delivered and billed.
- Scheduled monitoring check ($0.45) — only when you turn on scheduled monitoring (
monitorEnabled), once per target per run, and only when the source responded. One-off runs never pay it: you pay only per result. - One-off runs pay only per result. The monitoring check applies only to scheduled monitoring; every call to the supplier Actor is capped per call, at its own price, and
maxTotalChargeUsdcaps this Actor's own fee.
Related tools
- Want to know what changed since your last pull, not just today's ads? → Facebook Ad Creative Tracker - New, Edited, Dropped Ads
How to use it in 3 steps
- Click Try for free and fill in Facebook/Instagram Page names to track (
pageNames). - Optional: adjust the other fields; every one has a description and a sensible default.
- Click Start and download the results as JSON, CSV or Excel, or read them from the API.
Use cases
- Competitor ad research
- Agencies
- Media buyers
Use it from code (API)
Every Apify Actor is an API. Start a run and read the results with one call.
Python
from apify_client import ApifyClientclient = ApifyClient("<YOUR_APIFY_TOKEN>")run = client.actor("om_kh/facebook-ads-library-scraper").call(run_input={"pageNames": ["Nike", "Allbirds"]})for item in client.dataset(run["defaultDatasetId"]).iterate_items():print(item)
JavaScript
import { ApifyClient } from 'apify-client';const client = new ApifyClient({ token: '<YOUR_APIFY_TOKEN>' });const run = await client.actor('om_kh/facebook-ads-library-scraper').call({"pageNames": ["Nike","Allbirds"]});const { items } = await client.dataset(run.defaultDatasetId).listItems();console.log(items);
One HTTP call (cURL) — runs the Actor and returns the dataset in the same response:
curl -X POST "https://api.apify.com/v2/acts/om_kh~facebook-ads-library-scraper/run-sync-get-dataset-items?token=<YOUR_APIFY_TOKEN>" \-H "Content-Type: application/json" \-d '{"pageNames": ["Nike", "Allbirds"]}'
Integrations: n8n, Make, Zapier, Google Sheets
- n8n — the official Apify node, operation Run Actor and get dataset, Actor
om_kh/facebook-ads-library-scraper. - Make — Apify › Run an Actor, then Apify › Get Dataset Items.
- Zapier — Apify › Run Actor; map the dataset items into your next step.
- Google Sheets, webhooks, Slack — add an integration from the Integrations tab of this Actor.
- Schedules — run it every hour or day from Schedules in Apify Console.
Use it from an AI agent (MCP and x402)
Connect Claude Desktop, Cursor, VS Code or any MCP client to Apify's MCP server
at https://mcp.apify.com and add this Actor, om_kh/facebook-ads-library-scraper, as a tool — the
agent passes the same JSON as the run input and gets the dataset back.
AI agents that pay with x402 can run it too, without an Apify account: the Actor charges only per result delivered, so an agent pays exactly for what it gets.
FAQ
Is it legal to scrape Facebook Ads Library? This Actor collects only publicly available Facebook Ads Library data and never logs in. You are responsible for how you use it; check Facebook Ads Library's terms and your local law (GDPR, CCPA) if you store personal data, and ask a lawyer if unsure.
Do I need an account, cookies or an API key? No. You only need an Apify account to run it.
What data do I get? Active ads with copy, creative, start date and platforms. Download it as JSON, CSV, Excel, HTML or XML, or read it from the API.
Am I charged when something fails? No. An input that fails is listed with its reason in the run summary and is never charged.
Can I run it on a schedule? Yes. Create a schedule in Apify Console (hourly, daily, weekly) and connect webhooks, Google Sheets, Slack, n8n, Make or Zapier.
Can I use it from Python, JavaScript or an AI agent?
Yes: see the code samples above, or connect AI agents through MCP with the facebook_ads_library_check tool.
All input fields
The main fields are described above; these are the others the form accepts:
currentAds(Bring your own ads (optional)) — Skip the chained Meta Ad Library fetch and pass ad data directly.previousAds(Previous ads (non-monitor mode)) — Ads from the prior run; used to identify changes when not using persistent monitor mode.
Your feedback
Did this Actor save you time? A short review on the Reviews tab helps other people find it, and every review is read. Something missing or broken? Open an issue on the Issues tab: it is answered and fixed fast.