Prototype · Preview: every server in the official registry, synced every 30 minutes. Reviews and accounts come in a later step.
PopNx MCPMCP servers for people who use AI · explained in plain words

Facebook/Meta Ads Library Scraper API - Winning Ads, Scam Check

by AnshumanAtreyversion 1.0.11i★ –iRuns in the cloud
Registry nameio.github.AnshumanAtrey/facebook-ads-library-api

Install

Overview

Description from the maker (original English)

Facebook/Meta Ads Library Scraper - Winning Ads

PopNx MCP’s three pillars

These three are never merged into one score: opinions, measurements and popularity are different things.

What you can do with it

We have not written a plain-language summary for this one yet. Below are the facts we read from the registry.

  • Connection: Runs in the cloud
  • Transport: Streamable HTTP
  • Category: Marketing & social media
  • You need to fill in: Authorization

Install

Pick the AI app you use, then copy the settings.

Before you install

  • Basic checks: 3 of 3 passed
  • Runs on the maker’s server: what you ask it goes through their server.
  • You fill in yourself: Authorization

Values marked secret are keys to your account. Never share them or paste them into a chat.

You need

Which app do you use?

Pick your app above. We remember it, so next time the button says “Install in …”.

This address needs a key in a request header, which the add-connector menu cannot set. Use Claude Code, Cursor or VS Code instead.

Run this in your terminal

claude mcp add --transport http facebook-ads-library-api 'https://mcp.apify.com/?tools=anshumanatrey/facebook-ads-library-api' --header 'Authorization: your-value'

Fill in the empty values before running it.

Open in Cursor

Or copy the settings yourself

Paste into .cursor/mcp.json in your project, or ~/.cursor/mcp.json

{
  "mcpServers": {
    "facebook-ads-library-api": {
      "url": "https://mcp.apify.com/?tools=anshumanatrey/facebook-ads-library-api",
      "headers": {
        "Authorization": "your-value"
      }
    }
  }
}

Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.

Open in VS Code

Or copy the settings yourself

Paste into .vscode/mcp.json in your project

{
  "servers": {
    "facebook-ads-library-api": {
      "type": "http",
      "url": "https://mcp.apify.com/?tools=anshumanatrey/facebook-ads-library-api",
      "headers": {
        "Authorization": "your-value"
      }
    }
  }
}

Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.

This address needs a key in a request header, which the add-connector menu cannot set. Use Claude Code, Cursor or VS Code instead.

Your choice stays on this device in a cookie; no account needed.

Values you fill in

  • Authorization secret required HTTP header
    Apify API token, as 'Bearer '. Runs bill to this account.

These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.

What it can do

The server asks you to sign in before it lists its tools.

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 7, 2026

  • ✓ Pass

    Maker matches the repo

    The registry name was verified with the GitHub account AnshumanAtrey, which owns the repo

  • … Not checked yet

    Still maintained

    We have not read this repo from GitHub yet

  • … Not checked yet

    Has a licence

    We have not read this repo from GitHub yet

  • ✓ Pass

    Endpoint responds

    Responded in 39 ms (HTTP 401)

  • ✓ Pass

    Sign-in with OAuth

    Declares OAuth sign-in, so your AI app can take you to log in

  • … Not checked yet

    No hidden instructions in tool descriptions

    Not checked yet; we read the tool list when we check the endpoint

Compared with others in Marketing & social mediai

  • More stars than 0% of the other 2987 servers in this category
  • Published to the registry more recently than 80% of the other 2987 servers in this category
  • Basic checks equal to or better than 100% of the other 2987 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is Facebook/Meta Ads Library Scraper API - Winning Ads, Scam Check safe?

It passed 3 of 3 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

You need to fill in: Authorization

Does it run on my computer or in the cloud?

It runs in the maker’s cloud. Connect over the internet with nothing to install, but what you send passes through the maker’s servers.

Is it still maintained?

The GitHub repo last changed –, and the latest version (1.0.11) reached the registry 9 days ago.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. It connects by URL, so apps that accept remote MCP servers work too, such as ChatGPT in developer mode.

What can I use instead?

In the same category: MCP YouTube Transcript, Google Analytics MCP, BibiGPT YouTube Video Summarizer

Alternatives

Servers in the same category from other makers, sorted by stars.

Reading a card:★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

An MCP server retrieving transcripts of YouTube videos

Runs on your computer★ 495MITUpdated 10 days ago
Install

GA4 MCP server for AI agents: schema discovery, server-side aggregation, analysis-ready defaults.

Runs on your computer★ 244MITUpdated 10 days ago
Install

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

Facebook/Meta Ads Library Scraper API - Winning Ads, Scam Check

Scrape the Facebook Ads Library, which Meta now calls the Meta Ad Library (ads on Facebook, Instagram, Messenger, Threads and Audience Network), with no login, no cookies and no Meta API token. Type a keyword or paste a Facebook page, and get every matching ad as a row: the advertiser, how many days the ad has run, how many versions it has, the text, headline and button, the landing page and its domain, image and video links, platforms, and the reach, spend and EU audience data Meta publishes. On top of that: an advertiser list (businesses advertising on a keyword right now, one row each) and a brand scam check (ads that use a brand's name from pages that are not the brand's own). $0.70 per 1,000 ads, no start fee. Use it from the Apify Console, the API, Python, JavaScript, n8n, Make, Zapier or an AI agent through the Apify MCP server.

What does it do?

It reads the public Meta Ad Library, the same one at facebook.com/ads/library, and returns what you would otherwise copy by hand, for as many keywords or advertisers as you give it:

  • Ads for keywords (`ads`): every ad matching your words in a country or worldwide.
  • Ads of advertisers (`pages`): all ads of the Facebook pages you list, by link, page id or just the name.
  • Advertiser list (`advertisers`): the businesses advertising on your keywords now, with how many ads, their longest-running ad and the websites they send people to.
  • Brand scam check (`impersonation`): ads that name a brand but come from other pages, each with a risk level and the signals behind it (look-alike page name, look-alike landing domain, a new ad from a small page).

Why do people use the Ad Library data?

Answer: to see what already works in someone else's ads. Meta shows every running ad but no results, so the best free signal is time: an ad that has run for 30 to 90 days is almost always paying for itself, because nobody keeps paying for an ad that loses money.

  • Media buyers and DTC brands find competitors' long-running ads and copy the hook, offer and format instead of paying to test from zero. daysRunning and versions are here for that: several live versions of one ad are an A/B test, and the survivors are the winners.
  • Creative strategists and agencies keep a weekly watchlist of 10 to 20 brands and build swipe files; the landing domain shows the funnel behind each ad.
  • Agencies prospecting use the advertiser list: a business spending on ads now has a budget, so it is a warm lead.
  • E-commerce and dropshipping spot products pushed with many long-running ads.
  • Developers build ad-spy tools, n8n and Make flows (scrape, then have GPT or Gemini pull out hooks and write new variations) and AI-agent tools on top of it, without maintaining a scraper.
  • Brand protection and security teams run the brand scam check. Meta itself estimated about 15 billion scam ads are shown every day and expanded its brand-impersonation detection in March 2026; this finds the ones using your name.

How is it different from other Facebook Ads Library scrapers?

  • Cheaper than the two most-used Facebook/Meta Ads Library scrapers: $0.70 per 1,000 ads against $5.80 for Apify's own and $0.75 plus a start fee for curious_coder (together about 70% of this category's users). With no start fee it is also the cheapest for small runs: under 40 ads compared with automation-lab and under 250 compared with memo23. On large runs those two and jmlp cost less per ad; the table below shows every price.
  • Winning-ad signals built in: daysRunning is computed for every ad, versions is Meta's own count of an ad's variants, and Min days live (`minDaysRunning`) keeps only the long runners.
  • Landing domain on every ad, so you can group ads by the site they send people to.
  • Advertiser list and brand scam check in the same actor, charged the same way.
  • Simple for anyone: type a keyword and press Start; country names work (India, USA, UK), commas split keywords, and a pasted Ad Library link or Facebook page link is understood.
  • No proxy to set up: Meta blocks cloud and datacenter IPs (in our 2026-09-25 test both returned 0 ads), so every search runs on Apify's residential proxy, included in the price.
  • You pay only for rows saved, and a spending limit stops the run cleanly between batches.

How much does it cost to scrape the Facebook Ads Library?

$0.0007 per ad ($0.70 per 1,000), $0.008 per advertiser in the Advertiser list and $0.002 per ad in the brand scam check (it first reads the brand's own pages to learn their real websites). No start fee, no monthly fee, platform usage and residential proxy included. On paid Apify plans every price is 10% less on Scale and 20% less on Business and above ($0.56 per 1,000 ads on Business).

RunChargedPrice
The example input (20 ads for "running shoes")20 ads$0.014
100 ads for one keyword100 ads$0.07
1,000 ads across 10 keywords1,000 ads$0.70
Advertiser list from 200 ads, 60 advertisers found60 advertisers$0.48
Brand scam check that finds 40 ads from other pages40 scam-check ads$0.08
A search where Meta has no matching ads0$0.00

Apify's free plan includes $5 of monthly credit, which covers about 7,000 ads.

How does the price compare with other Facebook Ads Library scrapers?

The Facebook Ads Library actors with 250 or more users in the last 30 days on 2026-09-25, ordered by those users, at their Apify free-plan price.

ScraperPrice per 1,000 adsStart feeUsers, 30 days
This actor$0.70NoneNew
Facebook Ads Library Scraper by apify$5.80None6,040
Facebook Ads Library Scraper by curious_coder$0.75$0.000055,853
Facebook Ad Library Scraper by igolaizola$0.75$0.00751,048
Facebook Ads Library by automation-lab$0.575$0.005458
Facebook Ads Library Scraper by memo23$0.50$0.05340
Facebook Ads Library Scraper by brilliant_gum$15.00 + platform usage$0.001271
Meta Ad Scraper by whoareyouanas$10.00None256
Meta Ad Library Scraper by jmlp$0.15 + platform usageNone254

Several of these discount their prices on paid Apify plans, and some bill platform usage on top; automation-lab, memo23 and jmlp cost less per ad on large runs. Compare at your own plan if you run large volumes.

Which inputs does it take?

Every field has a plain name with its JSON key in brackets. Only Keywords is needed.

Field (JSON key)RequiredWhat it does
Report type (mode)Noads (default), pages, advertisers or impersonation (brand scam check)
Keywords (searchTerms)Yes, except for pagesOne per line; a, b on one line is two keywords; a pasted Ad Library search link works. For the scam check, the brand
Advertisers (pages)For pagesFacebook page links, page ids or names, for example https://www.facebook.com/nike or Gymshark
Country (country)NoALL (worldwide, default), a name such as India or a code such as IN
Ads per search (maxAds)NoMost ads saved per keyword or advertiser, default 100
Ad status (status)Noactive (default), inactive or all
Ad category (adType)Noall (default), political, housing, employment, credit
Media type (mediaType)Noall, image, video, meme, none
Min days live (minDaysRunning)NoKeep only ads that ran at least this many days
Exact phrase (exactPhrase)NoMatch the keywords as one phrase
Merge versions (groupVersions)NoOne row per group of ad versions
Order (sortBy)Noimpressions (most seen first, default) or relevance
Official pages (officialPages)NoFor the scam check: the brand's own pages; left empty, pages named exactly like the brand are used and listed in the run summary
{ "searchTerms": ["running shoes"], "country": "US", "minDaysRunning": 30, "maxAds": 200 }

What does the output look like?

One row per ad (or per advertiser in the Advertiser list). Every key is always present, empty when Meta has no such part. An example ad row, shortened:

{

"adId": "866569929827744", "adLibraryUrl": "https://www.facebook.com/ads/library/?id=866569929827744", "pageName": "Example Brand", "pageId": "1234567890", "pageLikes": 48210, "isActive": true, "startDate": "2026-06-01T12:30:00", "daysRunning": 116, "versions": 3, "platforms": ["FACEBOOK", "INSTAGRAM", "THREADS"], "adText": "Our best-selling trainer is back in stock...", "headline": "Free shipping this week", "callToAction": "Shop now", "landingUrl": "https://www.example.com/sale", "landingDomain": "example.com", "imageUrls": ["https://scontent.xx.fbcdn.net/..."], "videoUrls": [], "spend": null, "ageGender": [], "impersonation": null }

Brand scam check rows add impersonation: {"brand": "Nike", "risk": "high", "signals": ["page name uses the brand but it is not an official page", "sends people to nike-outlet-sale.shop, a look-alike site, not an official domain"]}. The signals are for you to review, not a verdict: resellers such as Foot Locker also use brand names and come back as low risk.

The run summary is the OUTPUT record: status, notes about anything we changed in your input, one entry per search with how many ads were read and saved, and the charged events.

How fast is it?

In our 2026-09-25 tests on Apify (256 MB, peak 57-70 MB): 20 ads in 16 s, 200 ads for one keyword in 106 s, 3 keywords of 50 ads each in 49 s (they run at once, each on its own residential IP), 60 ads of 2 advertisers in 48 s, and an advertiser list of 86 businesses from 100 ads in 66 s. No run was rate-limited.

Common questions

Q: Is the Facebook Ads Library the same as the Meta Ad Library? Yes. It is the same public library at facebook.com/ads/library; Meta now calls it the Meta Ad Library, and it covers ads on Facebook, Instagram, Messenger, Threads and Audience Network. This actor reads all of them.

Q: Do I need a Facebook account, cookies or a Meta API token? No. It reads the public Ad Library the way a logged-out visitor sees it.

Q: Can I see how much an ad spends or how many people it reached? For political and issue ads, yes: Meta publishes spend and impressions ranges. For ads delivered in the EU, Meta publishes reach by age, gender and region. For other ads Meta shows no numbers, which is why daysRunning and versions matter.

Q: How do I find winning ads? Set Min days live (minDaysRunning) to 30 or more. Ads that keep running for weeks are the ones making money, and versions shows which ones are being tested in several variants.

Q: Is this the official Meta Ad Library API? No. The official API needs a developer account and identity verification and covers political and issue ads plus ads shown in the EU. This actor covers every ad the public Ad Library shows.

Q: Can I monitor competitors every week? Yes. Save the input as an Apify task and schedule it; Ad status (status) active with Order (sortBy) impressions gives the ads that matter first.

Q: Why do I need a residential proxy? You do not set one up. Meta rate-limits cloud and datacenter IPs to zero ads, so the actor uses Apify's residential prox

Only the beginning is shown; read the rest in the repo

Ask PopNx