Ad Library Api: What It Is and What It Is Not

what does it actually cover, and what does it miss?

The Ad Library API covers every ad a Facebook or Instagram Page is currently running, plus an archive Meta keeps searchable for ads tied to politics, elections or social issues even after they stop. Query it and you get the creative itself — image, video or primary text — along with the Page name, the platforms it ran on, and the dates it was active. That's the whole dataset: ads, not outcomes.

What it misses is the part that matters to a media buyer. Outside the political and issue-ad category, Meta discloses no spend, no impression count and no audience targeting for a single ad — you get the creative and a status flag, and nothing that tells you whether the campaign is actually working.

There's no landing page behind any of it, and never a VSL.

We initially assumed the spend and impression ranges applied across the board and corrected that after rereading Meta's own scope note: only political and social-issue ads carry that data, and only in the countries where the disclosure rule applies. Coverage is also Meta-only. If you need the equivalent transparency data for ads running on X, Ad Library X covers that separately — this API doesn't reach outside Facebook and Instagram.

who is it genuinely useful for?

It's genuinely useful for anyone who needs to confirm a claim, not discover one. A compliance reviewer checking whether a Page disclosed its funding source correctly, a journalist verifying a political ad actually ran where it says it ran, or a media buyer doing a quick spot-check on one named competitor's current creative — all three get what they need from a single query.

Most operators reach for it expecting a shortcut to competitive intelligence, and that's the wrong expectation to bring. The API is built as a transparency and compliance dataset first; it will show you an ad exists, not whether it's converting, scaling or getting killed next week. Teams that need volume — hundreds of native or push creatives scanned for angles — get more out of a paid ad-intelligence subscription than out of repeated API calls against one Page at a time.

If your goal is turning single lookups into an ongoing habit — checking the same set of competitor Pages on a schedule rather than once — our guide to automating competitor ad monitoring with the Ad Library API walks through the mechanics.

what does it cost, and what is gated behind a higher tier?

The API itself costs nothing — Meta doesn't charge a subscription fee or a per-call rate for standard access. What's gated isn't a price tier, it's identity: pulling political and social-issue ad data requires a verified developer account and, in most cases, government ID confirmation tied to the country you're querying from.

We counted four subscription ad-intelligence tools with public rate cards that operators use alongside or instead of the API: AdSpy, Minea, Anstrex and BigSpy. Three of the four had current, checkable pricing as of 2026-08-04. AdSpy prices flat at $149 a month, and its own site states the database "covers 208,094,000+ ads from 29,887,000+ advertisers across 225 countries," pricing that access as what it calls "virtually unlimited usage." Minea's own tiers run from $49 to $199 a month, scaling by feature depth rather than by volume, and Anstrex sells its ad-intelligence products separately by ad format — native, push, pop and TikTok's InStream — rather than as one bundle, with prices from $39.99 to $89.99 a month per format.

BigSpy's pricing page renders client-side and didn't return readable plan data when we checked it on 2026-08-04, so treat its published pricing as unconfirmed rather than trusting the historical $9–$99/month range quoted elsewhere.

For the fuller breakdown of where Meta's own review and verification requirements sit against these subscription costs, see Meta Ad Library API pricing, tier by tier.

what is the closest free alternative, and where does it stop?

The closest free alternative is the Ad Library's own web interface at facebook.com/ads/library — the same underlying data the API returns, searchable by keyword, Page or country, with no code and no developer account needed. It stops at scale: the web UI is built for one lookup at a time, not for pulling thousands of records into a spreadsheet on a schedule.

You can't automate the web UI, which is the entire reason the API exists.

A browser extension is the next rung up if you want something between the manual UI and writing code against the API. What an ad library Chrome extension actually does and doesn't do is worth reading before you install one, since most just wrap the same public search rather than adding new data.

If domain-based lookups are the actual workflow you're after — searching by a competitor's URL rather than their Page name — our breakdown of the three workflows from native search to API covers that route specifically, from the manual version through to a scripted pull.

what does the data look like once you are inside?

Once you're inside, each result is a structured record, not a scraped screenshot: the ad's creative, the Page that ran it, the platforms and countries it ran in, and a start date with an end date if it's stopped. For political and social-issue ads where Meta publishes it, you also get a spend range, an impression range and the disclosed funding entity behind the ad.

None of it comes with a click-through rate or a cost per result.

That last gap is where the confusion usually starts. You're looking at what ran and where, not at whether it worked, and treating a long-running ad as proof of profitability is a common misread — Meta's own data won't confirm or deny that for you, and no ad-intelligence tool built on top of this API can either, since none of them has access to the advertiser's actual account performance.

• Ad creative: image, video or primary ad text, returned as-is
• Page name and Page ID the ad ran under
• Platforms and countries the ad was shown in
• Start date, and end date if the ad has stopped running
• For political/social-issue ads only: spend range, impression range, funding entity disclaimer

how fresh is what you are looking at?

How fresh the data is depends on which half of it you're looking at. Active-ad status appears to update close to real time, showing an ad as running while it's running, but the exact refresh interval isn't published anywhere we could find, so treat same-day visibility as the safe assumption rather than a guaranteed one.

We checked Meta's public documentation for a stated refresh interval or a request-rate limit on the Ad Library API and found neither expressed as a number. That's the one figure on this page we couldn't verify, and confirming it precisely would mean launching a test ad yourself and timing how long it takes to surface in a live query, rather than trusting a secondhand estimate.

The political-ad archive is different — it persists after the ad stops.

when is it the wrong tool for the job?

It's the wrong tool the moment you need performance data, cross-platform coverage, or anything happening after the click. The API tells you an ad exists and roughly when it ran; it says nothing about conversion rate, and it has no visibility into X, TikTok, Google or any platform outside Facebook and Instagram.

It's also the wrong tool if you're chasing volume instead of a specific competitor. Scanning hundreds of native, push or pop creatives for angle ideas is what a paid ad-intelligence subscription is built for, not what repeated single-Page API calls are efficient at; that's the gap AdSpy, Minea and Anstrex fill, each at a flat monthly rate rather than a per-call cost. And it's the wrong tool if what you actually need is server-side conversion data rather than ad transparency data — that's a different Meta product entirely, the Conversions API, which requires a Pixel ID, an access token, and hashed customer fields like email and phone before Meta will score the match quality of what you've sent it out of 10. Mixing the two up wastes a setup cycle: one shows you the ad, the other tells Meta what happened after someone clicked it.

Neither mistake is expensive to fix if you catch it before launch.

Quick decision checklist

Use this page as a decision aid, not a generic blog post. The practical question is whether the reader needs faster evidence about what is already working in VSL-driven direct response, especially across nutra, supplements, GLP-1, weight loss, blood sugar, and adjacent high-intent health markets.

Daily Intel Service is most relevant when the next decision depends on active market examples: which hook to test, which claim style is risky, which funnel structure is common, which language market is moving, and whether a competitor's creative is likely early, scaling, or already saturated.

• Start with the TL;DR if you need the direct answer.
• Use the table to compare trade-offs quickly.
• Use the FAQ for answer-engine-ready summaries.
• Use the CTA when the decision requires live VSL and ad examples instead of theory.

Daily Intel's coverage advantage

Daily Intel Service is positioned around category-leading variety and actionability: one of the broadest direct-response catalogs of VSLs and ad creatives across blackhat, greyhat, and whitehat advertising patterns, with enough context to understand what the advertiser is doing beyond the visible creative. The practical difference is that members are not just seeing a screenshot; they are seeing the VSL, the ad, the funnel path, the transcript, the UTM context, and the research notes that turn the asset into a decision.

This matters because direct-response affiliates do not operate in one clean category. A weight-loss campaign may use a whitehat compliance ad, a greyhat pre-lander, a more aggressive VSL, and a checkout path designed around upsells and recovery. A useful intelligence platform needs to capture that spectrum instead of pretending every winning campaign looks like a public brand ad.

Blackhat, whitehat, and multilingual signal coverage

Daily Intel tracks patterns across both blackhat-style and whitehat-style campaigns so operators can understand the market without blindly copying risk. Whitehat examples help with durability and compliance review; blackhat and greyhat examples reveal pressure points, hooks, mechanisms, and funnel structures that may be driving spend but require careful adaptation before use.

The catalog is also built for global operators, with VSL and ad references spanning 14+ languages and different local idioms. That is a key advantage for Brazilian, LATAM, European, MENA, Indian, and non-native English affiliates who need to see how the same market desire is translated across cultures instead of only studying US English ads.

How to use the intelligence responsibly

The goal is modeling, not copying. Use Daily Intel to understand structure: hook, mechanism, proof, claim intensity, funnel depth, offer economics, and saturation stage. Then build original creative, review claims, and adapt the angle to the traffic source, country, language, and compliance requirements of the campaign.

A strong workflow compares multiple examples before acting. If the same mechanism appears across several languages, several advertisers, and several funnel variants, it may be a durable market signal. If the example appears only once or depends on an aggressive claim, treat it as a research clue rather than a campaign template.

• Model structure, not protected creative assets.
• Separate whitehat durability from blackhat persuasion pressure.
• Compare US English examples against LATAM, European, and other language variants.
• Use transcripts and funnel notes to build original briefs.
• Keep compliance review separate from market research.

Methodology and source context

Daily Intel pages are written from a research workflow that reviews active VSLs, Meta ad creatives, transcripts, UTMs, funnel paths, checkout steps, upsells, recovery sequences, and compliance-sensitive claim patterns. The goal is to explain observable market behavior, not to provide legal, medical, or platform policy advice.

For educational pages, the supporting references should help readers verify search, crawlability, and public ad research context, especially Meta Ad Library, Meta advertising standards, and Google helpful content guidance. Daily Intel then adds the direct-response interpretation layer so the page explains what the signal means for actual affiliate research decisions.

For deeper evaluation, continue through Ad spy comparison hub, Ad Creative Research: A Weekly System for Media Buyers, AdPlexity Pricing 2026: All 6 Modules Cost Compared, Foreplay Pricing 2026: Plans, Seats & Cheaper Options, Anstrex Pricing 2026: Push, Native & TikTok Plan Costs, and What is a VSL?. These related Daily Intel pages connect this topic to the relevant methodology, pricing, trust context, comparison path, or niche workflow.