Facebook Ads Library Scraper API - Ad Copy, CTA, Impressions avatar

Facebook Ads Library Scraper API - Ad Copy, CTA, Impressions

Pricing

from $6.88 / 1,000 ads

Go to Apify Store
Facebook Ads Library Scraper API - Ad Copy, CTA, Impressions

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

Khandji Omar

Maintained by Community

Actor stats

0

Bookmarked

2

Total users

2

Monthly active users

9 hours ago

Last modified

Features

Limited permissions

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 giveFacebook page names
We doRead the advertiser's ads in Meta's public Ad Library
You getOne 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 notSign 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

  1. Try before you pay. The first 10 results of every run are free, on every run.
  2. Pay only for data delivered. Failed sources and failed inputs are never billed.
  3. Cost cap on this Actor's fee. Set maxTotalChargeUsd to cap this Actor's own fee; the supplier Actor is capped separately on every call, at its own price.
  4. Only-new mode. With monitorEnabled on a schedule, you get just the new or changed rows, plus a spike signal when volume suddenly jumps.
  5. 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."
}
FieldWhat it holds
pageNameadvertiser's Facebook page name
adArchiveIDad ID in Meta's Ad Library
isActivetrue while the ad is still running
startDateFormatteddate the ad started
endDateFormatteddate the ad stopped (or last seen)
publisherPlatformwhere it runs: Facebook, Instagram, Messenger, Audience Network
collationCounthow many near-identical versions of this ad run
categoriesad category (e.g. political, housing)
containsSensitiveContentflagged as sensitive by Meta
long_running_creativetrue when the ad has run long enough to be a proven winner
runs_seenhow many of your runs have seen this ad
why_it_mattersone-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

FieldWhat it holds
ad_idad ID
page_namepage name
creativecreative
landing_urllanding URL
is_activeis active
start_datestart date
ad_archive_idad archive ID
page_idpage ID
has_user_reportedhas user reported
page_is_deletedpage is deleted
categoriescategories
collation_countcollation count
collation_idcollation ID
contains_digital_created_mediacontains digital created media
contains_sensitive_contentcontains sensitive content
end_dateend date
gated_typegated type
hide_data_statushide data status
is_aaa_eligibleis aaa eligible
publisher_platformpublisher platform
snapshot_page_idsnapshot page ID
snapshot_page_is_deletedsnapshot page is deleted
snapshot_page_profile_urisnapshot page profile uri
snapshot_page_namesnapshot page name
snapshot_page_profile_picture_urlsnapshot page profile picture URL
snapshot_body_textsnapshot body text
snapshot_is_resharedsnapshot is reshared
snapshot_captionsnapshot caption
snapshot_cta_textsnapshot call to action text
snapshot_cta_typesnapshot call to action type
snapshot_display_formatsnapshot display format
snapshot_link_urlsnapshot link URL
snapshot_page_categoriessnapshot page categories
snapshot_page_like_countsnapshot page like count
snapshot_titlesnapshot title
impressions_with_index_impressions_indeximpressions with index impressions index
regional_regulation_data_finserv_is_deemed_finservregional regulation data finserv is deemed finserv
regional_regulation_data_finserv_is_limited_deliveryregional regulation data finserv is limited delivery
regional_regulation_data_tw_anti_scam_is_limited_deliveryregional regulation data tw anti scam is limited delivery
record_idstable ID of the row (used for new-only delivery)
creative_fingerprintfingerprint of the ad creative (detects edits)
change_typenew / changed / removed since your last run
runs_seenhow many runs this ad has been seen in
long_running_creativetrue when an ad keeps running (a likely winner)
why_it_mattersone-line reason this row deserves attention
snapshot_link_descriptionsnapshot link description
snapshot_branded_content_page_idsnapshot branded content page ID
snapshot_branded_content_page_is_deletedsnapshot branded content page is deleted
snapshot_branded_content_page_profile_urisnapshot branded content page profile uri
snapshot_branded_content_page_namesnapshot branded content page name
source_dataevery 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 maxTotalChargeUsd caps this Actor's own fee.

How to use it in 3 steps

  1. Click Try for free and fill in Facebook/Instagram Page names to track (pageNames).
  2. Optional: adjust the other fields; every one has a description and a sensible default.
  3. 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 ApifyClient
client = 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.

More Actors from the same author