Meta Ad Library API for Facebook and Instagram ads
Search active and past ads by keyword or advertiser across countries, get creatives, copy, platforms and run dates, and EU transparency data of a single ad.
No credit card needed. One API key works on every endpoint.
Endpoints and prices
| Endpoint | What you get | Price |
|---|---|---|
| GET /v1/ads/search | Search ads | 5 credits / call$5 per 1,000 callsup to 30 ads per call |
| GET /v1/ads/{ad_id} | Get an ad | 5 credits / call$5 per 1,000 calls |
| GET /v1/ads/pages/search | Search advertisers | 5 credits / call$5 per 1,000 callsup to 10 advertisers per call |
| GET /v1/ads/pages/{page_id} | Get an advertiser | 5 credits / call$5 per 1,000 calls |
| GET /v1/ads/pages/{page_id}/ads | List an advertiser's ads | 5 credits / call$5 per 1,000 callsup to 30 ads per call |
Make your first request
https://api.scrapecrate.com/v1/ads/searchcurl "https://api.scrapecrate.com/v1/ads/search?q=running%20shoes" \
-H "X-API-Key: YOUR_API_KEY"Response:
{
"data": [
{
"id": "1234567890123456",
"url": "https://www.facebook.com/ads/library/?id=1234567890123456",
"page": {
"id": "102030405060708",
"name": "Example Shoes"
},
"status": "active",
"started_at": "2026-10-15",
"platforms": [
"facebook",
"instagram"
],
"format": "image",
"body": "Run further with our new trainers.",
"title": "New collection",
"link_url": "https://example.com/shoes",
"cta": {
"text": "Shop now",
"type": "SHOP_NOW"
},
"images": [
{
"type": "image",
"url": "https://example.com/creative.jpg"
}
]
}
],
"pagination": {
"next_cursor": "eyJwIjoyfQ",
"has_more": true
},
"meta": {
"request_id": "req_8f2c1a9b0d3e4f5a6b7c",
"credits_used": 5,
"credits_remaining": 9999
}
}Illustrative values: a real response carries the live data you ask for.
What people build with it
Competitor ad research
See every active ad of a brand, with creatives, copy, call to action and start date.
Creative inspiration
Search ads by keyword and media type across countries to find what runs longest.
Political ad monitoring
Track political and issue ads with spend ranges, impressions and disclaimers.
Agency reporting
Export an advertiser's ads every week into your own dashboards.
Pricing
- 5 credits per successful call on every endpoint, whatever it returns
- $5 per 1,000 calls, volume packs down to half price
- 100 free credits every month (20 calls), no credit card
- Starter plan: 4.4k calls a month for $19
- Only successful calls are billed
- Credits are valid for 12 months and work on every API
Also for AI assistants (MCP)
The ScrapeCrate MCP server exposes every endpoint of this API as a tool for Claude, Cursor and other MCP clients. Run it with uvx scrapecrate-mcp; see the MCP guide.
Frequently asked questions
- Do I need a Meta developer account or identity verification?
- No. You only need your API key; the data is the public Ad Library.
- Which countries are covered?
- Every country the Ad Library shows; use `country=ALL` or a two-letter code.
- How are calls billed?
- 5 credits per successful call, whatever it returns: a page of up to 30 ads or one ad with its EU transparency data. The next page is a new call; errors are free.
- How long do creative URLs last?
- Image and video links are served by Meta's CDN and expire after a few days: download what you need to keep.
- Am I charged for failed requests?
- No. Only successful calls cost credits; errors, timeouts and not-found results are free.
- Can I use the same API key for the other ScrapeCrate APIs?
- Yes. One account, one API key and one credit balance work on every API: YouTube, Google Maps, Trustpilot, Meta Ad Library.
Other APIs with the same key
Start using the Meta Ad Library API
100 free credits every month. No credit card required.