Does this include the actual image or video files?

Facebook Ads Library returns the media URL and destination link, plus all the creative text and metadata, but it does not download raw video or image files.

How fresh is the data?

Every request to Facebook Ads Library fetches data live from the source. Mindcase does not serve cached results.

Can I fetch ads from multiple pages in one run?

Yes. Pass an array of pages in a single call and Facebook Ads Library fans out the requests in parallel. The response is one consolidated table with a column noting which page each row came from.

How do I integrate with Zapier, n8n, Google Sheets, or Airtable?

Facebook Ads Library returns clean JSON and CSV output. Both formats work with every workflow tool. Pipe them in via a webhook step, file download, or by hitting the REST endpoint on a schedule. Same for Slack notifications, Notion databases, and other downstream systems.

What fields are returned?

The agent returns the ad URL, library ID, page name and URL, headline, body text, link description, CTA text, destination URL, format, start and end dates, days active, media URL, platforms, advertiser, carousel cards, and EU reach where disclosed.

All APIs

$0.005 per ad ($5.00 per 1,000 ads)21 datapoints

Facebook Ads Library API

See every ad a brand is running in Meta's Ad Library — one row per ad with creative copy, headline, CTA, destination link, dates, how long it's been live, format, platforms, the advertiser's profile, carousel cards, and EU reach where it's disclosed.

Sample

Sample data

Here's a sample run of active ads from the Nike, HelloFresh, Gymshark, Temu, and IKEA Facebook Ad Libraries, showing the exact schema and results you can expect — including carousel cards and EU reach where Meta discloses it.

#	Ad URL	Library ID	Page URL	Headline	Body Text	CTA Text	Destination URL	Format	Start Date	End Date	Days Active	Is Active	Media URL	Media Type
1	www.facebook.com/ads/library/?id=1869276447125570	1869276447125570	www.facebook.com/nike/	Nike: Shoes, Apparel, Stories	Celebra tu cumpleaños con Nike y obtén acceso a productos exclusivos, MSI, envío y devoluciones gratis el resto del año.	Install now	itunes.apple.com/app/id1095459556	DPA	2026-03-17T07:00:00.000Z	2026-06-24T07:00:00.000Z	99	true	scontent.fwbw1-1.fna.fbcdn.net	Carousel
2	www.facebook.com/ads/library/?id=1702938977100376	1702938977100376	www.facebook.com/nike/	{{product.name}}	Bring sports more fully into your day with the Nike App.	Install now	itunes.apple.com/app/id1095459556	DPA	2025-04-07T07:00:00.000Z	2026-06-24T07:00:00.000Z	443	true	scontent.fabe1-1.fna.fbcdn.net	Carousel
3	www.facebook.com/ads/library/?id=1559738104701476	1559738104701476	www.facebook.com/nike/	{{product.name}}	Encuentra tu mejor estilo. Llegó el momento de que disfrutes los beneficios que la Nike App tiene para ti 😎. ¡Descárgala ahora!	Install now	play.google.com/store/apps/details?id=com.nike.omega	DPA	2025-04-25T07:00:00.000Z	2026-06-24T07:00:00.000Z	425	true	scontent.fwbw1-1.fna.fbcdn.net	Carousel
4	www.facebook.com/ads/library/?id=1679096793539720	1679096793539720	www.facebook.com/nike/	{{product.name}}{{product.current_price strip_zeros}}	Celebra tu cumpleaños con Nike y obtén acceso a productos exclusivos, MSI, envío y devoluciones gratis el resto del año.	Install now	play.google.com/	DPA	2026-03-31T07:00:00.000Z	2026-06-24T07:00:00.000Z	85	true	scontent.fabe1-1.fna.fbcdn.net	Carousel
5	www.facebook.com/ads/library/?id=821206474330606	821206474330606	www.facebook.com/nike/	Nike: Shoes, Apparel & Stories	Celebra tu cumpleaños con Nike y obtén acceso a productos exclusivos, MSI, envío y devoluciones gratis el resto del año.	Install now	play.google.com/store/apps/details?id=com.nike.omega	DPA	2026-03-17T07:00:00.000Z	2026-06-24T07:00:00.000Z	99	true	scontent.fwbw1-1.fna.fbcdn.net	Carousel
6	www.facebook.com/ads/library/?id=1249043200627555	1249043200627555	www.facebook.com/nike/	Nike: Shoes, Apparel & Stories	Celebra tu cumpleaños con Nike y obtén acceso a productos exclusivos, MSI, envío y devoluciones gratis el resto del año.	Shop now	play.google.com/store/apps/details?id=com.nike.omega	DPA	2026-03-17T07:00:00.000Z	2026-06-24T07:00:00.000Z	99	true	scontent.fabe1-1.fna.fbcdn.net	Carousel
7	www.facebook.com/ads/library/?id=1495531918341011	1495531918341011	www.facebook.com/nike/	The Best of Nike - Personalized to You	Bring sports more fully into your day with the Nike App.	Install now	itunes.apple.com/app/id1095459556	DPA	2025-09-24T07:00:00.000Z	2026-06-24T07:00:00.000Z	273	true	scontent.fwbw1-1.fna.fbcdn.net	Carousel
8	www.facebook.com/ads/library/?id=1707733356798266	1707733356798266	www.facebook.com/nike/	Nike: Shoes, Apparel & Stories	Compra los mejores estilos con la mejor tecnología e innovación Nike.	Shop now	play.google.com/store/apps/details?id=com.nike.omega	DPA	2025-05-31T07:00:00.000Z	2026-06-24T07:00:00.000Z	389	true	scontent.fabe1-1.fna.fbcdn.net	Carousel
9	www.facebook.com/ads/library/?id=1168278878270467	1168278878270467	www.facebook.com/nike/	{{product.name}}{{product.current_price strip_zeros}}	Compra los mejores estilos con la mejor tecnología e innovación Nike.	Use app	itunes.apple.com/app/id1095459556	DPA	2025-03-01T08:00:00.000Z	2026-06-24T07:00:00.000Z	479	true	scontent.fabe1-1.fna.fbcdn.net	Carousel
10	www.facebook.com/ads/library/?id=974682078847448	974682078847448	www.facebook.com/nike/	{{product.name}}	Celebra tu cumpleaños con Nike y obtén acceso a productos exclusivos, MSI, envío y devoluciones gratis el resto del año.	Install now	itunes.apple.com/	DPA	2026-04-07T07:00:00.000Z	2026-06-24T07:00:00.000Z	78	true	scontent.fwbw1-1.fna.fbcdn.net	Carousel

Playground

Run this API

Advanced parameters are collapsed below.

Inputs

Give a Facebook page URL or handle; set how many ads to return and whether to include inactive ads.

Page URL*

Active Status

Output limits

Max Results

$0.005 per ad

Billed per ads returned — no row cap set

live

curl -X POST https://api.mindcase.co/v1/data/facebook/ads/run \
  -H "Authorization: Bearer mk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "params": {
    "urls": "",
    "activeStatus": ""
  }
}'

Edit the form to update this live.

Overview

About Facebook Ads Library API

Facebook Ads Library shows every ad a brand is running in Meta's Ad Library, one row per ad. It returns the creative copy, headline, CTA, destination link, dates, how long it has been live, format, platforms, the advertiser's profile, carousel cards, and EU reach where Meta discloses it.

Growth marketers use Facebook Ads Library to monitor competitor creative strategies and messaging. Performance designers analyze high-performing layouts and copy across an industry to inform their own briefs.

Real-time dataSelf-servePay per resultZero setup time

Cost

Pricing

$0.005per ad

$5.00 per 1,000 ads

$5.00 per 1,000 ads. Each row returned counts as one ad. The total count is calculated by multiplying the number of Facebook pages provided by the max results requested per page. Failed runs don't count.

Pay as you goNo subscriptionNo setup feeCancel anytime

Cost calculator

Number of companies

Ads per company

Total rows250 ads

Total cost$1.25

Examples

Use cases

A few common ways teams put Facebook Ads Library API to work — copy a prompt below to try it yourself.

Competitive creative analysis

Track the hooks and calls to action competitors use in their current campaigns.

Get the latest 50 ads from Nike

Multi-brand monitoring

Compare active ad volume and messaging across several players in a category.

200 active ads from Salesforce, HubSpot, and Zendesk

Carousel and format study

Inspect carousel cards and ad formats to see how competitors structure creative.

Pull the carousel cards from Temu's active ads

Historical benchmarking

Include inactive ads to analyze a brand's seasonal promotional calendar.

Get 200 ads from Coca-Cola including inactive ones

Get started

Ready to pull ads?

FAQ

Frequently asked questions

Does this include the actual image or video files?: Facebook Ads Library returns the media URL and destination link, plus all the creative text and metadata, but it does not download raw video or image files.
How fresh is the data?: Every request to Facebook Ads Library fetches data live from the source. Mindcase does not serve cached results.
Can I fetch ads from multiple pages in one run?: Yes. Pass an array of pages in a single call and Facebook Ads Library fans out the requests in parallel. The response is one consolidated table with a column noting which page each row came from.
How do I integrate with Zapier, n8n, Google Sheets, or Airtable?: Facebook Ads Library returns clean JSON and CSV output. Both formats work with every workflow tool. Pipe them in via a webhook step, file download, or by hitting the REST endpoint on a schedule. Same for Slack notifications, Notion databases, and other downstream systems.
What fields are returned?: The agent returns the ad URL, library ID, page name and URL, headline, body text, link description, CTA text, destination URL, format, start and end dates, days active, media URL, platforms, advertiser, carousel cards, and EU reach where disclosed.

More Facebook APIs

See all →

Facebook Comments API

Extract comments and replies from Facebook posts, reels, and photos — text, author, likes, reply count, and thread position — by post URL

Facebook$0.0025 per comment$2.50 per 1,000 comment

Facebook Events API

Find Facebook events by keyword search or event URL — one row per event with name, date, venue, host, attendance, and ticket link.

Facebook$0.01 per event$10.00 per 1,000 events

Facebook Followers & Following API

Pull the profiles that follow a Facebook page — or the profiles that page follows — as clean stubs with name, profile URL, profile ID, avatar, and bio. Choose followers, following, or both.

Facebook$0.0075 per profile$7.50 per 1,000 profile

Facebook Marketplace API

Extract Facebook Marketplace listings — title, price, condition, location, attributes, and photos — from any category or search URL.

Facebook$0.005 per listing$5.00 per 1,000 listings

Facebook Pages API

Look up public Facebook pages and get a clean business profile for each — name, category, intro, follower and like counts, contact details (phone, email, website, address), rating, price range, hours, the confirmed owner behind the page, whether it's running ads, and its links to Instagram, X, YouTube, TikTok and more.

Facebook$0.01 per page$10.00 per 1,000 pages

Facebook Posts API

Extract posts and reels from any public Facebook page, profile, or group — text, author, engagement (reactions, comments, shares, video views), the full reaction-type breakdown, media, links, hashtags, mentions, and collaborators

Facebook$0.005 per post$5.00 per 1,000 posts