Getting Started
Search ads, creatives and advertisers of the Meta Ad Library from your own code with the ScrapeAdLibrary API.
Quick Start
Get up and running in less than 5 minutes with these simple steps.
Create an Account
Sign up for a free account to get your API key. No credit card required.
Create accountMake Your First Request
Search the active ads that mention a keyword in one country:
curl "https://api.scrapeadlibrary.com/v1/ads/search?q=nike&country=IT&limit=10" \
-H "X-API-Key: sal_your_api_key"Base URL
All API requests are made to the following base URL:
https://api.scrapeadlibrary.com/v1One API for every part of the Ad Library
Search ads, open one ad with its EU transparency data, list an advertiser's ads or find advertisers by keyword.
- Facebook Ads Search APIAds by keyword or advertiser, filtered by country, platform, media type, language and dates.
- Facebook Ad Details APIOne ad with creatives, payer and EU reach by country, age and gender.
- Facebook Page Ads APIThe profile of an advertiser page and every ad it runs, page by page.
- Facebook Advertiser Search APIThe advertisers that ran ads on a keyword, with their page IDs.
Limits
A few limits to keep in mind when you design your integration:
| Limit | Value |
|---|---|
| Free credits every month | 100 |
| Ads per page (limit) | 1-50 |
| Cursor lifetime | 1 hour |
| Media URLs (images, videos) | Expire after a few days: see media_expires_at |
When you send too many requests you get 429 rate_limit_exceeded with a Retry-After header: wait that many seconds and retry.
Pricing
You pay per item returned, not per call, and only for successful calls:
Free Tier
100 credits/month
No credit card required
Pay As You Go
$1 / 1,000 credits
Credits never expire, errors are never billed
- Ad and page lists: 1 credit per 10 items returned, rounded up (empty results are free)
- Ad detail with transparency data: 2 credits
- Advertiser page: 1 credit
Available Endpoints
The API provides the following endpoints:
/v1/ads/searchSearch ads by keyword or page, with filters/v1/ads/{ad_id}Ad detail with EU transparency data/v1/pages/{page_id}Advertiser page profile/v1/pages/{page_id}/adsAll the ads of one advertiser page/v1/pages/searchAdvertisers that ran ads matching a keyword