Facebook Ad Library Scraper: Meta Ad Library Ads avatar

Facebook Ad Library Scraper: Meta Ad Library Ads

Pricing

from $0.40 / 1,000 results

Go to Apify Store
Facebook Ad Library Scraper: Meta Ad Library Ads

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

Actor stats

0

Bookmarked

10

Total users

3

Monthly active users

7 hours ago

Last modified

Features

Limited permissions

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

ModeFieldWhen to use
Page ID searchview_all_page_idYou know the Facebook Page ID. Returns ONLY ads from that page. Most precise.
Domain searchdomainYou know the advertiser's website (e.g. toyota.cl). Exact-phrase match.
Keyword searchkeywordYou 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?

FieldDescription
ad_archive_id, ad_urlAd ID (dedup key) and direct link to the ad in the Ad Library
page_id, page_name, page_urlAdvertiser page
status, is_activeactive / inactive
bodyAd text (first 600 characters)
link_url, link_title, link_descriptionDestination URL and link card text
creative_urlImage or video asset URL (when present in the ad)
cta_typeCall to action, e.g. LEARN_MORE, SHOP_NOW (when present)
start_date, end_dateFirst and last shown date (YYYY-MM-DD)
platformsComma-separated platforms (FACEBOOK, INSTAGRAM, ...)
media_typetext, image or video
contains_digital_created_mediatrue 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_upperImpression range, only where Meta discloses it (EU countries)
spend_lower, spend_upper, spend_currencySpend range, same condition
collation_id, keyword, country, scraped_at, sourceGrouping 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

  1. Open the Actor in Apify Console.
  2. Enter a keyword, an advertiser domain or a Facebook Page ID (the form is prefilled with the keyword Nike).
  3. Pick a country and set Max ads (start with 10).
  4. Click Start. A 10-ad run finished in about 20 seconds in our tests.
  5. Download the dataset as JSON, CSV or Excel, or call it from the API.

⚙️ Input parameters

ParameterTypeDefaultDescription
domainstring-Advertiser domain, exact phrase match (e.g. toyota.cl).
keywordstring-Keyword searched in ad text (e.g. Toyota Chile).
view_all_page_idstring-Facebook Page ID; returns only ads from that page.
countrystringESISO 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.
maxResultsinteger200Maximum ads to scrape (1-5000).
headlessbooleantrueHeadless mode for the fallback browser.
proxyConfigurationobjectApify Proxy, RESIDENTIALProxy 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:

EventPrice (USD)When it is charged
Actor Start$0.005Once per run, one event per GB of memory (minimum one)
result$0.0004Each ad saved to the dataset

With the default 2048 MB (2 start events = $0.010):

AdsTotal
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-scraper with the APIFY_TOKEN environment 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."

Compare ads across platforms with Rastriq's other ad-library scrapers. Each has its own output fields, so map them before merging datasets.

ActorWhat it adds
Google Ads Transparency ScraperSearch, Display and YouTube ads from Google's Ads Transparency Center
TikTok Ad Library ScraperAds, targeting and audience data from TikTok's EU ad library
LinkedIn Ad Library ScraperB2B ads from LinkedIn's Ad Library
TikTok Top Ads ScraperBest-performing ads from TikTok Creative Center

❓ FAQ

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.