Facebook Ad Library API

The ad spy API for Facebook

Meta's official API only covers political ads. Spreshapp gives you a REST API for all Facebook ads, commercial, ecommerce, DTC, and more, built on top of the same public Ad Library dashboard anyone can browse.

Get started free Read the docs

Facebook Ad Library API

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"],
    "ad_type": "VIDEO"
  }'

100 free credits / month

$3 per 5,000 additional credits

All ad types, not just political

View plans

Endpoints

Three Facebook Ad Library API endpoints

Search by keyword, look up any brand page, or pull all active ads for a specific brand.

POST /v1/ad-search

Ad search

Keyword search across the full Facebook Ad Library. Filter by country, ad type, active status, and more.

1 credit per ad returned View docs →

GET /v1/brand/page-search

Brand search

Find any brand's Facebook page by name. Returns page ID, category, follower count, and verification badge.

5 credits per call View docs →

GET /v1/brand/:page_id

Brand active ads

Pull all live ads for any brand page. Filter by format, sort by run length, and paginate with cursors.

1 credit per ad returned View docs →

Use cases

Build your own ad spy tools

Use the Facebook Ad Library API as a foundation for any ad intelligence product.

Competitive ad intelligence

Monitor any competitor's active Facebook ads programmatically. Track creative changes, new angles, and offer shifts without touching the Ad Library manually.

Agency reporting pipelines

Pull client competitor ad data into your own dashboards and reports. No more manual research in Meta's Ad Library every week.

AI creative analysis

Feed Facebook ad data directly into your AI pipelines to extract hooks, copy patterns, and creative frameworks at scale.

FAQ

Common questions

What is the Facebook Ad Library API?

The Facebook Ad Library is Meta's publicly accessible database of all ads running on Facebook and Instagram. Spreshapp wraps this public dashboard in a clean REST API so you can query it programmatically without building and maintaining a scraper yourself.

Does Meta have an official Ad Library API?

Meta does have an API, but it is restricted to political, electoral, and social issue ads. It does not expose commercial ads from brands. The Spreshapp Facebook Ad Library API covers all ad categories, including ecommerce, DTC, SaaS, and every other type of advertiser running on Facebook.

Can I use this as an ad spy API?

Yes. The Spreshapp API is built for ad intelligence. You can monitor any brand's active ads, extract body copy and landing pages, filter by country and ad format, and track creative changes over time, all without logging into the Ad Library manually.

Where does the data come from?

Spreshapp reads from the same publicly available Facebook Ad Library that anyone can browse at facebook.com/ads/library. No special Meta access or app approval is required. The data is public, and Spreshapp gives you a structured API on top of it.

What data does each ad response include?

Each ad object includes the archive ID, page name, body copy, CTA text, landing page URL, display format (image or video), media URLs, and the date the ad started running.

How does pagination work?

The API uses cursor-based pagination. Each response includes a next_cursor field when more results are available. Pass that cursor in your next request to fetch the following page.

Start with 100 free credits

All ad types. All brands. The data Meta's own API does not expose.

Get started free Read the docs