Meta Ad Library API
Meta's official API stops at political ads. Spreshapp gives you structured access to the public Facebook Ad Library for ecommerce, DTC, SaaS, and every other commercial category.
curl -X POST https://api.spreshapp.com/v1/ad-search \
-H "Authorization: Bearer <token>" \
-H "Content-Type: application/json" \
-d '{
"query": "running shoes",
"active_status": "ACTIVE",
"countries": ["US"],
"media_type": "VIDEO",
"limit": 25
}'What you get
Four endpoints, plus the guarantees you actually care about.
Use the endpoints directly or plug them into your own queue, scheduler, or reporting stack.
Search ads
Search by keyword with country, media type, and active status filters.
POST
/v1/ad-searchFind brands
Resolve a brand name into page IDs, categories, and page metadata.
GET
/v1/brand/page-searchPull active ads
Fetch all live ads for a brand page with cursor pagination.
GET
/v1/brand/:page_idAd details
Get DSA transparency data: reach, age/gender breakdown, audience, and estimated spend.
GET
/v1/ad-details/:ad_archive_idRobust infrastructure
Handle even the most demanding needs.
Performance
Sub-1 second average response time
Uptime
99% uptime SLA
API pricing
Estimate your monthly API spend.
Start with a base plan, then scale with simple usage blocks until unlimited becomes cheaper.
Monthly ads served
Estimated monthly price
$19
Solo API plan
Solo includes 10,000 ads, so there is no overage at this volume.
Pricing notes
Solo starts at $19 for 10,000 ads.
Each extra 5,000 ads adds $3.
Unlimited caps heavy usage at $450 per month.
Best fit
Solo API plan
Solo is the cheapest fit at this volume before unlimited pricing is necessary.
FAQ
Common questions
What is the Facebook Ad Library API? +
The Facebook Ad Library is Meta's public database of ads running on Facebook and Instagram. Spreshapp wraps that public surface in a clean REST API so you can query it programmatically.
Does Meta have an official Ad Library API? +
Meta has an official endpoint for political, electoral, and social issue ads. It does not expose regular commercial ad data. Spreshapp covers commercial categories like ecommerce, SaaS, and DTC.
Can I use this as an ad spy API? +
Yes. You can monitor active ads, capture body copy, landing pages, media URLs, and other structured fields without manually browsing the public library.
Where does the data come from? +
Spreshapp reads from the same public Facebook Ad Library anyone can browse at facebook.com/ads/library, then returns structured API output on top of it.
What data does each ad response include? +
Each ad object includes archive ID, page name, body copy, CTA text, landing page URL, display format, media URLs, and the ad start date.
How does pagination work? +
The API uses cursors. When more ads are available, the response includes a next_cursor value that you pass into the next request.
Ready to build
Start querying commercial Facebook ads today.
Get the API surface, throughput, and uptime needed for real product workflows.