What is Facebook Ad Library Scraper?
Facebook Ad Library Scraper reads Meta's public Ad Library for you and returns one record per ad. You give it a brand's Facebook page or an Ad Library search, pick a country and whether you want active or past ads, and you get the copy, the creative, the button, the landing page and the dates in a table instead of an endless scroll.
The Ad Library lists ads running across Meta's apps, so the same record tells you whether an ad shows on Facebook, Instagram or both.
You ask
Get 10 active US ads from Nike's Facebook page in the Ad Library with ad text, format, platforms and start date.
It runs
From your AI assistant over MCP or from your code over REST
You get
- Ad creative
- Delivery
- Advertiser
- Transparency
- Audit a competitor's adsSee every ad a rival runs in your market today, with the message, the format and how long each has run.
- Build a swipe fileSave strong ads from your niche with their copy, images and links for the next creative brief.
- Spot launches and salesNew ads with a fresh start date show when a brand pushes a product, a discount or a new market.
- Follow ads to their landing pagesCollect the links and read the pages they lead to, so you see the full funnel.
- Let your agent do the reviewClaude or ChatGPT groups the ads by offer or angle and writes the summary in the same chat.
What data does the Facebook Ad Library scraper extract?
Each ad comes back as one record with the advertiser's page details attached. These are the fields our test run returned; some stay empty when Meta does not publish them for that ad.
Ad creative
- Ad Library ID and link
- Ad text
- Headline
- Button text and type
- Landing page link
- Display caption
- Format, such as a product catalog
- Cards with title, text, link and image
- Images
- Videos with preview images
Delivery
- Start date
- End date
- Active or inactive
- Platforms, such as Facebook and Instagram
- Number of ads sharing the creative
Advertiser
- Page name and ID
- Page category
- Page like count
- Page creation date
- Confirmed page owner
- Whether the page is running ads
- Page link
Transparency
- Spend and currency
- Reach estimate
- Impressions
- Targeted or reached countries
- Paid-for-by disclaimer
- Sensitive content flag
- Digitally created media flag
Meta publishes spend, reach and impressions mainly for ads about social issues, elections or politics, so for ordinary commercial ads like our Nike test those fields come back empty. Image and video links are signed links from Meta's servers that expire, so save the files you need soon after a run.
Sample output: Nike's active US ads
The table at the top of this page is a real run from 16 November 2026: 10 active ads from Nike's Facebook page, United States, sorted by impressions. The page record names NIKE, Inc. as the confirmed owner and lists 39,489,332 page likes. Here is what the 10 ads show.
One result in full
One ad in full
- Ad Library ID
- 1120113070497516
- Page
- Nike, Sportswear, 39,489,332 likes
- Page owner
- NIKE, Inc. is responsible for this Page.
- Started
- 23 Oct 2026, active at run time
- Platforms
- Facebook, Instagram
- Format
- Product catalog ad with 6 cards
- Ad text
- Get the gear not afraid to put in the work.
- Card headlines
- Nike Air Monarch IV (5 cards), Nike Tempo Shorts (1 card)
- Button and link
- Shop now, nike.com
- Spend, reach, impressions
- Empty for this ad
What this sample tells you
All 10 are product catalog ads with six cards each, and every one promotes the same two products: Nike Air Monarch IV in five cards and Nike Tempo Shorts in one.
The 10 ads share 3 lines of ad text: 4 use “Get the gear that goes hard on and off the field”, 3 “Get the gear not afraid to put in the work” and 3 “Ball’s in your court”. Copy tests on the same products are easy to spot this way.
9of 10
9 of 10 started on 23 October 2026; the other has run since 20 June 2025. All 10 show on both Facebook and Instagram.
Spend, reach and impressions are empty on all 10. The ad-level headline is a catalog template, {{product.name}}, so read product names from the cards.
How to scrape the Facebook Ad Library with your AI assistant
Connect AI/ML API
Click Try it now, pick your client and add the MCP server. You sign in with your AI/ML API account once.
Name the brand or the topic
Give a Facebook page link for one advertiser, or an Ad Library search link for a keyword.
Set the market
Say which country, active or past ads, a date range if you need one, and how many ads you want.
Review the ads in the chat
Ask for the offers, angles and landing pages, a comparison with another brand or a CSV for your swipe file.
Prompts to start with
Use the AI/ML API MCP Facebook Ad Library Scraper tool. Get 10 active US ads from facebook.com/nike in the Meta Ad Library and show the ad text, format, platforms and start date.
Use the AI/ML API MCP Facebook Ad Library Scraper tool. Collect the 30 most recent ads from [competitor page] in the UK and group them by offer: discount, bundle, new product or other.
Use the AI/ML API MCP Facebook Ad Library Scraper tool. Search the Ad Library for “meal kit” ads running in Germany in the last 30 days and list each advertiser with its main message.
Use the AI/ML API MCP Facebook Ad Library Scraper tool. Compare this month's ads from [brand A] and [brand B]: ad text, buttons, formats and landing pages.
Ad Library settings
In a chat you name the brand and the market and your assistant fills these in. In code you pass them yourself.
| Setting | What it controls | Tip |
|---|---|---|
| Page or search link | A Facebook page link, or an Ad Library search link with your keyword and filters | A page for one brand, a search for a whole category |
| Number of ads | Total ads, plus a limit per link | The per-link limit can run over by up to 30 ads, so set it a little low |
| Country | Two-letter country code, or ALL | Run each market separately to compare them |
| Active status | Active, inactive or all ads | Inactive ads show what a brand tested and dropped |
| Date range | Last 24 hours, 7, 14 or 30 days | Use 7 days to watch a launch week |
| Sort | By impressions or most recent | Impressions puts the ads Meta ranks highest first |
| Ad details | Extra details per ad, such as EU reach | Useful for EU markets, where Meta publishes reach |
| Run tag | A label copied into every row | Tag runs by client or week to merge files later |
Sorting by impressions puts the ads Meta ranks highest first; most recent shows what a brand just launched. In our Nike test, the top-ranked ad had run since June 2025, while the other nine started in October 2026.
What marketers do with Ad Library data
Competitor creative audits
Pull a rival's active ads each month and see which messages, formats and products they keep paying for.
Ad textFormatStart date
Swipe files
Save standout ads in your category with copy and images, ready for the next brief.
Ad textImagesCards
Launch and promo watch
Spot new start dates to catch a competitor's product launch or sale the week it begins.
Start dateAd textLanding link
Landing page research
Collect the links behind the ads and read the pages with Page Reader to see the offer in full.
Landing linkButton
Agency and client reports
Show a client what their category runs in each country, with ad IDs and Library links as evidence.
PageLibrary linkDates
Political and issue ad research
Study disclaimers, spend and reach where Meta publishes them for ads about elections and social issues.
DisclaimerSpendReach
Facebook Ad Library scraper API for your code
In your code
REST · your AI/ML API key, JSON records back
The same tool runs over REST with your AI/ML API key. Your backend sends page or search links with the country, status and limits, and gets JSON records with the fields above, ready for a dashboard, a creative database or a weekly competitor email.
Use MCP when a marketer reviews ads in a chat and REST when the pull runs on a schedule. Both use one AI/ML API account and one balance, with no Meta developer app to register. Start with the Toolbox REST quickstart. To see the same brand's Google ads, use Google Advertiser Ad Search.
Facebook Ad Library API and other ways to collect ads
Meta runs an official Ad Library API, and it is often the first thing people try. Outside the EU it covers mainly ads about social issues, elections or politics, and access needs a developer account with a confirmed identity. For commercial ads from brands, most teams browse the website or use a scraper.
| Browse the Ad Library website | Meta Ad Library API | Your own scraper | ||
|---|---|---|---|---|
| Setup | Connect once with your AI/ML API account | None | Developer account, identity confirmation, your own code | Browser automation, proxies and parsing to maintain |
| What you get | Commercial and other ads by page or keyword, with creative and links | Any ad, read one at a time | Political and issue ads, plus ads delivered in the EU | Whatever you build and keep working |
| Inside an AI chat | Yes. Over MCP | No. No | Only if you build it | Only if you build it |
Pricing
Pay as you goBilled per run from your AI/ML API balance
- No subscription
- No seat fee
- One balance for every tool
Runs are billed from your AI/ML API balance by the number of ads returned, with no subscription or seat fee. Our 10-ad test cost less than one cent. A keyword search across a whole category can return many ads, so set a limit and check the current price in your dashboard first.
FAQ
Is it legal to scrape the Facebook Ad Library?
The Ad Library is a public transparency tool, and reviewing competitors' ads there is standard marketing research. Meta's terms apply to the service, and ad creatives belong to the advertiser, so use them as reference rather than republishing them. Ask a lawyer about your specific case.
Is this the official Facebook Ad Library API?
No. Meta's Ad Library API is a separate developer product that needs a confirmed identity and, outside the EU, focuses on ads about social issues, elections or politics. Facebook Ad Library Scraper reads the public Library, including ordinary commercial ads, through your AI/ML API account.
Does it show ad spend, reach or impressions?
The record has fields for them, and Meta fills them mainly for political and issue ads. For the commercial Nike ads in our test, all three were empty. Turn on ad details to request EU reach information for ads shown in the EU.
Can I search by keyword instead of a page?
Yes. Run your search on the Ad Library website, copy the link with its keyword, country and filters, and pass it in. Broad words return ads from many advertisers, so keep the phrase specific.
Does it include Instagram ads?
Yes, when the ad runs there. Each record lists its platforms; all 10 Nike ads in our test showed on both Facebook and Instagram.
Can I download the ad images and videos?
The record includes links to images, videos and preview images. They are signed links that expire, so ask your assistant or your code to save the files soon after the run.
Can I see ads for one country?
Yes. Set a two-letter country code such as US, GB or DE, or ALL for every country. Brands often run different ads per market, so compare countries in separate runs.
Can I use it from Claude, ChatGPT or Cursor?
Yes. Add the AI/ML API MCP server once and ask in plain English. Hermes, OpenClaw and other MCP clients work the same way.
How fresh is the data?
Each run reads the Ad Library at that moment. Active means the ad was running at run time, and a new ad appears once Meta lists it in the Library.
Pull a competitor's ads
Connect once, then ask for any brand's ads in plain English.