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.

1

Create an Account

Sign up for a free account to get your API key. No credit card required.

Create account
2

Get Your API Key

Generate an API key from your dashboard. Your key starts with sal_.

Go to API Keys
3

Make Your First Request

Search the active ads that mention a keyword in one country:

cURL
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/v1

One 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.

Limits

A few limits to keep in mind when you design your integration:

LimitValue
Free credits every month100
Ads per page (limit)1-50
Cursor lifetime1 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:

GET/v1/ads/search
GET/v1/ads/{ad_id}
GET/v1/pages/{page_id}
GET/v1/pages/{page_id}/ads
GET/v1/pages/search

Next Steps