Meta Ad Library API Alternative: 5 Things the Official API Won't Give You

Every week, developers discover the same thing in the same order. First: Meta has an official Ad Library API — great. Second: it only returns political and social-issue ads in most countries. Third: getting access requires identity verification with a government ID. Fourth: even after all that, it doesn't hand you the ad creatives. If you searched for a "Meta Ad Library API alternative", you are somewhere between steps two and four.

This article walks through the five concrete things the official API withholds, why each one matters if you're building anything commercial — a competitor-tracking dashboard, a swipe-file tool, an ad-intelligence product — and how to get each one through a REST API that requires nothing but an API key.

Why the official API sends people looking for an alternative

Meta's ads_archive endpoint exists because regulators demanded transparency around political advertising. That origin shapes everything about it. Access requires a Facebook account, a developer app, and a completed identity confirmation — you upload a government-issued ID and verify your location, a process that takes days and is tied to specific countries. Then you query through the Graph API with an access token.

And after clearing all of that, the core restriction hits: in most countries the API only serves ads about social issues, elections, and politics. The EU is the exception — the Digital Services Act forced Meta to expose all ads that target EU users — but if your competitor runs ads in the United States, the official API will not show you their campaigns. The commercial ads you can see by browsing facebook.com/ads/library in a browser are simply not queryable through the official programmatic interface for most markets.

That gap between "visible on the website" and "available in the API" is the entire reason alternatives exist. What follows is the concrete list of what falls into that gap.

1. Commercial ads — not just political ones

This is the deal-breaker for almost everyone. If you want to know what ads Nike, a DTC skincare brand, or your direct competitor is running, the official API returns nothing outside the EU — those are commercial ads, and ad_type=POLITICAL_AND_ISSUE_ADS is the only game in town for most countries.

An alternative built on the public Ad Library itself doesn't have this restriction. Captapi's Facebook Ad Library Search API queries the same public library you see in the browser, so commercial ads come back like any other result — searchable by keyword or brand, filterable by country, active status, media type, and date range. The chain for competitor monitoring is two calls: search-companies to resolve a brand to its page ID, then company-ads to list everything that page is running.

2. The actual creative files

The official API returns ad text fields and an ad_snapshot_url — a link that renders the creative inside a Meta-hosted viewer, behind your access token. It does not give you the image file. It does not give you the video URL. For a swipe-file product or any tool that displays, downloads, or analyzes creatives, this is fatal: there is nothing to store or show.

A proper alternative returns the media itself. Each ad from Captapi's Facebook endpoints carries a media[] array of canonical CDN URLs plus typed images[] and videos[] arrays, along with mediaUrlsExpireAt so you know exactly how long those signed URLs stay fetchable before you should re-pull or persist them. Carousel ads include per-card creatives in cards[].

3. Access without app review or identity verification

No government ID, no location verification, no developer app, no Graph API token, no waiting period. You sign up, you get an API key with 100 free credits, and your first request works the same minute. Authentication is a plain Authorization: Bearer header (or x-api-key) on a REST endpoint.

This matters beyond convenience. The official API's verification is country-gated — developers in many countries cannot complete it at all. And because access hangs off your personal Facebook identity, an account problem becomes an API outage for your product. An independent key decouples your infrastructure from your social media account.

4. TikTok, LinkedIn and Google behind the same schema

Meta's API — even where it works — covers Meta. Your competitors also run ads on TikTok, LinkedIn, and Google, and each platform's transparency surface is a separate integration with its own quirks: TikTok's Commercial Content Library, LinkedIn's Ad Library, Google's Ads Transparency Center.

Captapi puts all four behind one interface with one response convention: withheld fields are null, never missing, so a parser written for Facebook results works unchanged for TikTok search, LinkedIn search, or Google company ads. Thirteen ad-library endpoints total — search, advertiser listing, and per-ad details on every platform. The full map is on the Ad Library API page.

5. Advertiser metadata, run dates, and search that finds brands

The official API's search parameters were designed for political-ad research, and the fields follow the same logic: spend and impressions appear as ranges, and only for political ads where disclosure is mandatory. For commercial ads, the practical intelligence signals are different — how long an ad has been running, how many variants a brand is testing, which platforms it targets — and you have to be able to search by ordinary brand terms to get any of it.

Here is the field-level difference, side by side:

What a request looks like

One GET request, keyword and country, JSON back. The same call in curl and Python:

# curl
curl "https://api.captapi.com/v1/ad-library/facebook/search?q=nike&country=US" \
  -H "Authorization: Bearer YOUR_API_KEY"

# Python
import requests

resp = requests.get(
    "https://api.captapi.com/v1/ad-library/facebook/search",
    params={"q": "nike", "country": "US"},
    headers={"Authorization": "Bearer YOUR_API_KEY"},
)
ads = resp.json()["ads"]

A trimmed response — note the creative URLs and run dates that the official API never returns for commercial ads:

{
  "ads": [
    {
      "id": "1181321139918234",
      "text": "Just Do It. Shop the new Pegasus 41.",
      "headline": "Nike Pegasus 41",
      "cta": "Shop now",
      "landingUrl": "https://www.nike.com/running",
      "isActive": true,
      "firstShown": "2026-08-02",
      "lastShown": "2026-09-11",
      "publisherPlatforms": ["FACEBOOK", "INSTAGRAM"],
      "media": ["https://scontent.xx.fbcdn.net/v/...jpg"],
      "advertiser": { "id": "15087023444", "name": "Nike" }
    }
  ],
  "searchResultsCount": 8340,
  "country": "US"
}

Ad-library searches cost 2 credits per call, and failed calls are never charged. The pricing page has the current plans; every account starts with 100 free credits and no card. If you want to eyeball results before writing any code, the free Ad Library search tool runs on the same endpoint.

Frequently asked questions

Is there an alternative to the Meta Ad Library API?

Yes. Captapi reads the public Meta Ad Library directly and returns commercial ads, creative URLs, and advertiser metadata as JSON — plus the TikTok, LinkedIn, and Google ad libraries behind the same REST interface. No app review or identity verification is required.

Can I use an ad library API without app review?

With the official Meta API, no — identity verification with a government ID is mandatory before ads_archive returns anything. With Captapi you sign up, take your API key, and call the endpoints immediately; the verification step doesn't exist.

Does the official Meta Ad Library API show commercial ads?

Only for ads that target EU countries, where the Digital Services Act requires it. In the US and most other markets, the official API is limited to political and social-issue ads — commercial campaigns are visible on the Ad Library website but not through the official programmatic API.

Can I download ad creatives — images and videos?

Not from the official API, which only exposes a token-gated snapshot viewer URL. Captapi responses include direct creative URLs in media[], images[], and videos[] arrays with an explicit expiry timestamp, so you can display, analyze, or persist the files.