Ad API Guide

Platform guide

Meta Ad Library: official API versus third-party routes

What Meta's own Ad Library API returns for commercial advertisers, who can get access, and what the three third-party routes returned for the same ten advertisers on the same day, field by field, with prices and latency.

By Shirley Lou, ResearchPublished 2026-09-15Facts re-checked 2026-09-21Last material change 2026-09-21

Written for people asking: What are the best Meta Ad Library API alternatives for commercial competitor research?Can I use the Meta Ad Library API to see competitors' Facebook ads?Does the Meta ad library API show spend and impressions?

Meta's official Ad Library API is the wrong tool for commercial competitor research outside Europe: its own documentation says ads that did not reach the EU are returned only if they are political or issue ads, and access requires the political-advertiser identity confirmation at Facebook.com/ID plus a developer app. For ordinary commercial ads the usable routes are third-party. On 15 September 2026 ScrapeCreators returned 30 active ads per page for each of ten advertisers at $0.0019 a call in about 4 seconds, by page name or by keyword; Apify's Meta scraper returned the same ads with more fields at $0.10 per 20 ads and 28 seconds a call. Every route returned creative, dates, placements, status, landing page and copy; none returned spend or reach, because Meta publishes those only for political ads and for EU-delivered ads.

The official API, as Meta describes it

Everything in this section is quoted from Meta’s own pages on 15 September 2026; the URLs are inline.

Who can access it. Step one is identity confirmation: “Go to Facebook.com/ID and follow the confirmation process required to run ads about social issues, elections or politics”, which “can take several days”. Then a Meta for Developers account, an app, and a role on that app. Every request carries an OAuth token. Source: facebook.com/ads/library/api and the ads_archive reference.

Which ads it returns. Two buckets: political and issue ads delivered anywhere in the world in the past seven years, and “ads of any type that were delivered to the United Kingdom or European Union during the past year”, plus the special categories of employment, housing and financial products. The reference is explicit about the rest: “Ads that did not reach any location in the EU will only return if they are about social issues, elections or politics.” A US-only commercial campaign is not in the API at all.

Which fields. For every returned ad: library ID, creative, page, delivery dates and placement (Facebook, Instagram, Audience Network, Messenger, WhatsApp, Oculus, Threads, streaming services). Spend range, impressions range, demographic distribution, delivery by region and estimated audience size are restricted to political and issue ads. EU and UK ads add total EU reach, age, gender and country reach breakdowns, target ages, gender and locations, and beneficiary and payer names. Source: ads_archive reference and release notes.

Cost and limits. No fee is stated. A rate limit exists (error 613) but its number is not published for this endpoint.

So for a growth team in the US researching US competitors, the official API returns nothing. For EU-targeted competitors it returns more than any third-party route can, including targeting and reach, once you have cleared identity confirmation.

The third-party routes, measured

Ten advertisers, one call each, first page. The tables show the latest weekly run; raw responses for every run are on the evidence page and run-to-run changes on the notes page.

Meta routes, cohort v1. Apify bills per result; its cost is per 20-ad page. 3 rows. Download CSV ↓
RouteReturnedAds per callAds returnedp50p95Cost per call
Apify · Meta Ads Scraper92018040,224 ms109,610 ms$0.100
ScrapeCreators · Meta, by page name103029815,728 ms45,166 ms$0.0019
ScrapeCreators · Meta, keyword search83023716,317 ms80,954 ms$0.0019
Share of returned ads carrying each field, Meta routes. 3 rows. Download CSV ↓
RouteAdsCreativeStartEndPlacementStatusSpendReachLandingCopy
Apify · Meta Ads Scraper180100%100%100%100%100%0%0%98%99%
ScrapeCreators · Meta, by page name298100%100%100%100%100%0%0%99%100%
ScrapeCreators · Meta, keyword search237100%100%100%100%100%0%0%98%100%

Reading the tables:

  • ScrapeCreators, by page name or by keyword, is the same dataset. Thirty active ads a page with a cursor for the rest, library ID, creative, dates, placements, active flag, landing URL and body copy on every ad. The library totals are in the response too: HubSpot had 191 active ads, monday.com 667, Shopify 4,986 on 15 September 2026.
  • Apify’s Meta Ads Scraper returns the same ads with more fields, most of them empty for these advertisers. It adds page like counts, categories, EU reach, spend and currency. On 200 ads across ten US-targeted advertisers, spend was null on all 200 and EU impressions on all 200, which is exactly what Meta’s field rules predict. Its price is 50 times ScrapeCreators per page and each call took 28 seconds at the median, over a minute at p95. It earns that when you want a whole library paginated in one run or when your competitors deliver in the EU.
  • Nothing returned spend or reach. Not because the routes are weak but because Meta does not publish them for commercial ads outside the EU. A vendor that shows you competitor spend from the Meta library is estimating it.

Change since last run (9 November 2026). ScrapeCreators’ page-name route returned all ten advertisers, ClickUp included (391 active ads). Its active-ad counts moved by more than a quarter for three brands: monday.com 302 to 137, Canva 2,341 to 1,641 and Shopify 3,721 to 5,710. The keyword route failed on Shopify and Semrush with the same upstream proxy error as last week (HTTP 500, “status code 429”, no credits charged, not retried). This run did not share its machine with the SEO cohort, so that overlap does not explain the error. By keyword, HubSpot rose from 3,399 to 4,474 and Apollo.io from 70 to 103. Apify’s Semrush run timed out at the 90-second limit treg now applies, the first Apify Meta timeout in nine weekly runs; the other nine returned 20 ads each. The p50 and p95 columns still overstate provider time (see the Google page). Each weekly run is logged on the notes page.

Who each route fits

  • Weekly check on competitors’ creatives, any market: ScrapeCreators by page name, paginate with the cursor. One credential, cents a week.
  • EU competitors, need targeting and reach: the official API if you can clear identity confirmation; otherwise Apify with details per ad, which reads the same EU fields.
  • Political or issue ads: the official API, which is what it was built for and where spend and impressions exist.
  • All four platforms in one workflow: see the choose an API page for the cross-platform comparison.

What this page cannot tell you

Ten advertisers, first page each, US-targeted. An EU cohort would show Apify’s reach and targeting fields populated. Meta’s rate limit for the official endpoint is unpublished, and the official route was not called here because this account has not completed identity confirmation. Creative URLs expire.

Next step

Questions this page answers

What are the best Meta Ad Library API alternatives for commercial competitor research?

For commercial advertisers outside the EU the official API returns nothing, by Meta's own rules, so the working routes are third-party: ScrapeCreators by page name or keyword ($0.0019 a call, 30 active ads a page, about 4 s) and Apify's Meta Ads Scraper ($0.10 per 20 ads, 28 s) which adds EU fields where they exist.

Can I use the Meta Ad Library API to see competitors' Facebook ads?

Only if the ads reached the EU or UK, or are political or issue ads; Meta's reference states that ads that did not reach the EU return only if they are about social issues, elections or politics. Access also requires the political-advertiser identity confirmation and a developer app.

Does the Meta ad library API show spend and impressions?

Spend and impressions ranges are restricted to political and issue ads; EU-delivered ads carry EU reach and targeting fields; ordinary commercial ads carry creative, dates, page and placement only. On 200 commercial ads through Apify and 594 through ScrapeCreators, spend was null on every one.

How many ads do big brands keep active in the Meta ad library at once?

From dozens to thousands. The active counts ScrapeCreators returned by page name were 191 for HubSpot on 15 September 2026, and between 15 and 21 September 36 then 46 for Apollo.io, 667 then 535 for monday.com, 4,350 then 2,961 for Canva and 4,986 then 5,665 for Shopify. The set turns over quickly: between 16% and 28% of first-page ads were not on the previous week's first page.

Is the Meta Ad Library API free?

Meta states no fee for its official Ad Library API, but it is not open: access needs the political-advertiser identity confirmation and a developer app, and it returns commercial ads only if they reached the EU or UK. The third-party routes that return US commercial ads are paid: ScrapeCreators at $0.0019 a call for 30 ads, Apify at $0.10 per 20 ads (15 September 2026).

How do you use the Meta Ad Library?

By hand: open facebook.com/ads/library, pick a country and an ad category, then search an advertiser's page name or a keyword and read the cards. That works for a few advertisers. For a repeated check, call a route instead: ScrapeCreators by page name returned 30 active ads a call with library ID, creative, dates, placements and landing URL for $0.0019 (15 September 2026), with a cursor for the rest. Download the creatives you want to keep promptly: Meta's links for ordinary ad images and most videos expired 104 to 108 hours after fetch in September 2026. The full field list per route is on the ad library data fields guide.

How can I find and analyze a competitor's Meta ads?

To look at one advertiser, open facebook.com/ads/library, set the country and category, and search the page name; it is free and shows the cards. To compare several advertisers or repeat the check, call a route by page name: ScrapeCreators returned 30 active ads a call for $0.0019 on 15 September 2026, each with library ID, creative, start date, placements, copy and landing URL, plus the page's active-ad count. Long-running ads and creative turnover are what those fields can show. Spend and reach are not: on 200 commercial ads through Apify and 594 through ScrapeCreators, spend was null on every one.

How do you scrape the Facebook ads library?

Call a route that reads the library for you rather than scraping the page yourself. The official Ad Library API is not a substitute for US commercial ads, because Meta returns non-political ads only if they reached the EU or UK. The routes that worked on 15 September 2026 were ScrapeCreators by page name or keyword (30 active ads a call, $0.0019, about 4 s) and Apify's Meta Ads Scraper ($0.10 per 20 ads, 28 s a call). Both call the library from the provider's side, so no Facebook account of yours is used. The field-by-field comparison is on the Apify vs ScrapeCreators page.

What is an access token for the Meta Ad Library API, and how do you get one?

It is the OAuth token every Ad Library API request carries, issued to a Meta for Developers app on which you hold a role. Before the app's token can read the library, Meta requires the identity confirmation at Facebook.com/ID used for ads about social issues, elections or politics, which Meta says can take several days (Meta's Ad Library API page, read 15 September 2026). The token then returns commercial ads only if they reached the EU or UK. Third-party routes such as ScrapeCreators and Apify need no Meta token, only the provider's own API key.


Spotted an error or a changed price? Email corrections@adapiguide.com with the page URL and a source. Corrections are logged on the corrections page.