vexqo Get an API key
A guide to the Meta Ad Library API

What Meta's official Ad Library API returns, and what it leaves out

The official API covers ads about social issues, elections or politics, plus ads of any type that reached the EU or the UK. A brand's ads that ran only in other countries do not come back. The public Ad Library page shows more, and the two are easy to confuse.

Checked against Meta's Ad Library API page in November 2026.

What the official API covers

Meta built the API for transparency on political ads and later added ads delivered to the EU and the UK. The coverage follows that history.

Source: Meta's Ad Library API page.

What access takes

Getting in takes an identity check and a developer app. What comes back depends on the kind of ad.

Before the first call

  • Confirm your identity with Meta, through the same process it requires from people who run political ads. Meta says the review can take a few days.
  • Create a Meta for Developers account and accept the platform terms.
  • Create an app and use its access token on the ads_archive endpoint.

In the answer

  • Spend and impressions come back as ranges, and only for ads about social issues, elections or politics. Ads delivered to the EU or the UK carry an estimated reach.
  • A commercial ad comes back with its creative text, its start date and the page that ran it. The stop date can be blank.
  • Images and video are not in the answer. Each ad carries a link to Meta's rendered snapshot of it.

The official API and the public library page

The Ad Library website shows the ads an advertiser is running, with no account. The API and the page hold different sets of ads.

RouteAds you can getWhat you sendWhere it stops
Meta's official Ad Library API Political and issue ads worldwide. Other ads only if they reached the EU or the UK. Search terms or page IDs, the countries reached and an access token Commercial ads that ran only outside the EU and the UK
The public Ad Library page, read by vexqo The ads the page shows for an advertiser, commercial ads included An advertiser's page ID or its Ad Library URL No keyword search today. The page hides the creatives of age-restricted ads from visitors who are not logged in. Spend and reach stay null unless the library publishes them. It is web scraping, which Meta has not approved.

When the official API is enough

Use Meta's API when it covers your ads. It is the first-party source, and nothing is scraped.

It fits

  • Research on ads about social issues, elections or politics, in any country.
  • Advertisers whose ads all reach the EU or the UK.
  • Work that needs Meta's own spend and impression ranges for political ads.

It falls short

  • Commercial advertisers whose ads run only outside the EU and the UK.
  • Products that follow all the active ads of one advertiser across countries.
  • Teams where nobody can go through Meta's identity confirmation.

For these, the public library page is the source. The Meta Ad Library API from vexqo reads it.

Questions

Something else? Write to [email protected].

Why does the Ad Library API return no ads for a US brand?

The API returns ads of any type only when they reached the EU or the UK. A commercial ad that ran only in the United States is outside it, even though the Ad Library website shows it.

Is the Facebook Ad Library API the same thing?

Yes. Meta renamed the Facebook Ad Library to the Meta Ad Library. The API, its ads_archive endpoint and its limits are the same under both names.

Does the official API return spend?

As a range, and for ads about social issues, elections or politics. vexqo leaves spend null unless the library publishes it and does not estimate it.

Does the API still show political ads in the EU?

Only past ones. Meta stopped delivering ads about social issues, elections or politics in the EU on 6 October 2025, so EU results for those ads end there.

Can I use the official API without confirming my identity?

No. Meta asks for the identity confirmation before it gives access.

Is vexqo an official Meta API?

No. vexqo reads public Ad Library pages, logged out, with no Meta account. It is web scraping, with no approval from Meta and no claim of one. Check that your intended use fits their terms.

What does a vexqo ad record hold?

The Meta Ad Library API page shows a real ad record and lists what each one holds.

Get an API key.
Test it on an advertiser you know.

Call the API with the page ID of an advertiser whose ads you already know. The ads the public Ad Library shows for it come back as JSON records. Compare them with what you have before you spend anything.

curl https://api.vexqo.dev/facebook/pages/16453004404/ads \
  -H "X-API-Key: YOUR_KEY"
  • Free test key, nothing to sign
  • Blocked and failed requests never billed
  • You set the monthly cap

Your test keyFree

We send the key to this address and use it for nothing else.