# Ad Library API (Meta), free: Facebook Ad Library API

> The Ad Library API helps you perform customized searches of the Ad Library for: Ads about social issues, elections or politics that were delivered anywhere in the world during the past 7 years, Ads of any type that were delivered to the United Kingdom (UK) or European Union during the past year

Ad Library API's Free plan for the Facebook Ad Library API costs $0.00 per 1,000 ads. Ad Library API's docs list 4 of the 7 fields on our checklist: Run dates, Platforms, Text, Advertiser.
We haven't run Ad Library API (Meta) through [our Facebook Ad Library API benchmark](https://datacircle.dev/best-facebook-ad-library-api.txt) yet.
We rank 141 plans for Facebook Ad Library APIs by price. Half the plans cost $0.79 or less per 1,000 ads. This plan and 1 other tie for the lowest price per 1,000 ads of the 141 plans. [See the best free Facebook Ad Library API plan.](https://datacircle.dev/best-facebook-ad-library-api.txt)
[Scrappa](https://datacircle.dev/facebook-ad-apis/scrappa/10-pack/llms.txt), [AdLibAPI](https://datacircle.dev/facebook-ad-apis/adlibapi/299-monthly/llms.txt) and [Metapi](https://datacircle.dev/facebook-ad-apis/metapi/299-monthly-scale-post-v1-tasks-from-url/llms.txt) are the best Facebook Ad Library API providers in the Datacircle benchmark.

- This page: https://datacircle.dev/facebook-ad-apis/ad-library-api-meta/free
- [Facebook Ad Library API: the 10 best providers compared](https://datacircle.dev/best-facebook-ad-library-api.txt)
- Get it: https://www.facebook.com/ads/library/api/?utm_source=datacircle.dev&utm_medium=referral&utm_campaign=facebook-ad-library-api-pricing
- Request: `GET https://graph.facebook.com/v27.0/ads_archive`
- API key: with the plan, on https://www.facebook.com/ads/library/api/?utm_source=datacircle.dev&utm_medium=referral&utm_campaign=facebook-ad-library-api-pricing
- Its API docs: https://developers.facebook.com/docs/graph-api/reference/ads_archive/?utm_source=datacircle.dev&utm_medium=referral&utm_campaign=facebook-ad-library-api-pricing
- Sold by: Ad Library API (Meta) (https://www.facebook.com/ads/library/api/?utm_source=datacircle.dev&utm_medium=referral&utm_campaign=facebook-ad-library-api-pricing)
- Checked: 2026-11-06

## In the answer

- Completeness: 57%
- Run dates: ✓
- Platforms: ✓
- Text: ✓
- Advertiser: ✓

## Price

- $ per 1,000 ads: $0.00
- Per: page of 25
- Billing: free

## Not found

- $ per 1,000: $0.00

## In their words

- Their pitch: The Ad Library API helps you perform customized searches of the Ad Library for: Ads about social issues, elections or politics that were delivered anywhere in the world during the past 7 years, Ads of any type that were delivered to the United Kingdom (UK) or European Union during the past year

## Data

- Keep data: Platform Terms 3.d: "Delete all Platform Data as soon as reasonably possible in the following cases: a. When retaining the Platform Data is no longer necessary for a legitimate business purpose that is consistent with these Terms and all other applicable terms and policies, [...] c. When we request you delete the Platform Data for the protection of Users [...]" and "Update or delete Platform Data promptly after receiving a request from us or the User to do so". Ad Library API, ad_snapshot_url: "While you cannot currently download a batch of archived ads, you can download ad creative such as images and text for an individual ad. If you do so, it must be for analysis and you must comply with the data storage terms in our Terms of Service."
- Use data: Ad Library API: "Content of the ad creative (subject to our Terms of Service)". Ad Library API, step 2: "As part of account creation, you'll need to agree to our Platform Policy." Platform Terms 2.a: "You will not sell, transfer, or sublicense Platform to anyone." Platform Terms 3.a: "You will not perform, or facilitate or support others in performing, any of the following prohibited practices (collectively, “Prohibited Practices”): i. Processing Platform Data to discriminate or encourage discrimination in a manner that disadvantages people based on personal attributes [...] ii. Processing Platform Data to make eligibility determinations about people, including for housing, employment, insurance, education opportunities, credit, government benefits, or immigration status. [...] iii. Processing Platform Data to perform, facilitate, or provide tools for surveillance. [...] iv. Selling, licensing, or purchasing Platform Data. v. Processing Platform Data without valid User consent in order to build or augment user profiles for any purpose. vi. Attempting to decode, circumvent, re-identify, de-anonymize, unscramble, unencrypt, reverse hash, or reverse-engineer Platform Data that is provided to you. vii. Changing your App's core functionality or data Processing so that Users would view it as an unfamiliar or different App, or materially changing the scope of Processing of previously collected Platform Data, unless in each case you first re-submit your App and receive our approval through App Review. viii. Processing Platform Data for purposes other than the applicable permitted purposes set forth in Meta's Developer Docs." Platform Terms 3.c: "You may only share Platform Data in compliance with these Terms [...] and only in the following circumstances".

## Plan

- Pay: $0

## Rate limit

- Batch: 10

## Speed

- Answer: in the call

## The call

- You send: ad_reached_countries. Optional: ad_active_status, ad_delivery_date_max, ad_delivery_date_min, ad_type, bylines, delivery_by_region, estimated_audience_size_max, estimated_audience_size_min, languages, media_type, publisher_platforms, search_page_ids, search_terms, search_type, unmask_removed_content, fields, limit, one of before or after
- Method: GET
- Path: /v27.0/ads_archive

## About the plan

- Plan: Free
- Who can get it: anyone with a Facebook account whose identity and location are confirmed (step 1: "Go to Facebook.com/ID and follow the confirmation process required to run ads about social issues, elections or politics. It can take a few days to confirm the information you submit."), a Meta for Developers account (step 2: "you'll need to agree to our Platform Policy") and an app, calling with an access token, it covers ads about social issues, elections or politics delivered anywhere in the world during the past 7 years and ads of any type delivered to the United Kingdom (UK) or European Union during the past year (ads that did not reach any location in the EU return only if they are about social issues, elections or politics), spend, impressions and demographics come only for ads about social issues, elections or politics, and targeting, reach and payer information for ads delivered to the UK and EU, rate limit: "Calls within one hour = 200 * Number of Users" for an app, error 613 "Calls to this api have exceeded the rate limit."

## The 29 fields the plan's answer can hold

ad archive ID, creation time, ad text, caption, link description, ad title, start date, end date, snapshot URL, audience by country, age and gender, beneficiary payers, Brazil total reach, byline, currency, delivery by region, audience by age and gender, estimated audience size, EU total reach, impressions range, languages, page ID, page name, publisher platforms, spend range, target ages, target gender, target locations, total reach by location, next cursor

## Ad Library API's plans (1)

- [Ad Library API (Meta), free](https://datacircle.dev/facebook-ad-apis/ad-library-api-meta/free/llms.txt): $0.00 per 1,000, 57% complete

## Ad Library API's calls (1)

- `GET /v27.0/ads_archive`: [Ad Library API (Meta), free](https://datacircle.dev/facebook-ad-apis/ad-library-api-meta/free/llms.txt)

## Ad Library API's APIs (1)

- [Ad Library API (Meta): Facebook Ad Library API pricing, 1 plan](https://datacircle.dev/facebook-ad-apis/ad-library-api-meta/free/llms.txt)

## Ad Library API (Meta): Facebook Ad Library API alternatives

- [Scrappa, free](https://datacircle.dev/facebook-ad-apis/scrappa/free/llms.txt): $0.00 per 1,000, 100% complete
- [AdLibAPI, free](https://datacircle.dev/facebook-ad-apis/adlibapi/free/llms.txt): $0.00 per 1,000, 100% complete, live
- [Metapi, free, POST /v1/tasks](https://datacircle.dev/facebook-ad-apis/metapi/free-post-v1-tasks/llms.txt): $0.00 per 1,000, 86% complete
- [Adyntel, free](https://datacircle.dev/facebook-ad-apis/adyntel/free/llms.txt): $0.00 per 1,000, 100% complete, live
- [Spytrend, free](https://datacircle.dev/facebook-ad-apis/spytrend/free/llms.txt): $0.00 per 1,000, 57% complete

## Sources

From each provider's own pricing page and docs, and from what providers tell us. We read this row from these pages on 2026-11-06.

- https://developers.facebook.com/docs/graph-api/overview/rate-limiting/?utm_source=datacircle.dev&utm_medium=referral&utm_campaign=facebook-ad-library-api-pricing
- https://developers.facebook.com/docs/graph-api/reference/ads_archive/?utm_source=datacircle.dev&utm_medium=referral&utm_campaign=facebook-ad-library-api-pricing
- https://developers.facebook.com/docs/graph-api/reference/archived-ad/?utm_source=datacircle.dev&utm_medium=referral&utm_campaign=facebook-ad-library-api-pricing
- https://developers.facebook.com/terms/?utm_source=datacircle.dev&utm_medium=referral&utm_campaign=facebook-ad-library-api-pricing
- https://www.facebook.com/ads/library/api/?utm_source=datacircle.dev&utm_medium=referral&utm_campaign=facebook-ad-library-api-pricing