Meta Ad Library: What It Shows, Fields, API, Limits

Meta Ad Library is Meta's public search for ads on Facebook, Instagram and other Meta products. Every active ad is in it. Spend and reach show for political ads; reach and payer for EU and UK ads.

What it shows

Search by keyword or advertiser name at facebook.com/ads/library. You get every ad that is active now across Meta products (Meta help).

ad type fields
any ad Library ID, ad content, Page name and ID, delivery dates, where it ran (Facebook, Instagram, other)
social issues, elections, politics plus spend (range), impressions (range), reach by age, gender and location
delivered in the EU or UK plus estimated impressions, targeting and reach by demographic, advertiser and payer (EU only)

Source: Meta Ad Library API page.

How long ads stay

  • Active ads: while they run.
  • EU and UK ads: archived 1 year after the last impression.
  • Political and social-issue ads: 7 years, active or not.

Source: Meta transparency. A scam ad that ran in the US only and stopped is gone from the library.

Ads can be removed from the library for “serious Community Standards violations or by valid government request”. An ad that breaks Meta’s ad policies may still show, behind a warning (Meta help).

API

The Ad Library API (ads_archive in the Graph API) searches two sets: ads about social issues, elections or politics delivered anywhere in the past 7 years, and ads of any type delivered to the UK or EU in the past year (Meta).

To get access:

  1. Confirm your identity and location at facebook.com/ID.
  2. Create a Meta for Developers account.
  3. Create an app and select Access the API.

Query limits from the docs: search_terms up to 100 characters; up to ten Page IDs per query.

Use it for brand work

  1. Search your brand name and your domain as keywords.
  2. Open ads from Pages you do not know.
  3. Save the Library ID, a screenshot and the landing URL.
  4. Report the ad: how to report fake Facebook ads.

More on this: scam ads using my brand. Other libraries: ad library list.

[TODO: our own run: number of ads found for a sample brand, dated]

Questions

Is the Meta Ad Library free?

Yes. Search at facebook.com/ads/library. The API needs a Meta developer account and an identity check.

Can I see ads that stopped running?

Ads delivered in the EU and UK are archived for one year after their last impression. Ads about social issues, elections or politics stay for 7 years. Other inactive ads are not shown.

Can I see how much a competitor spends?

Only for political and social-issue ads, where spend is a range. For other ads there is no spend figure.

Can I report an ad from the library?

Yes. Open the ad, click Options, choose Report ad.