Meta Ad Library API
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.
Overview and use cases on the Meta Ad Library API page; response format, pagination and errors are the same for every API (conventions).
- Search ads /v1/ads/search
- Get an ad /v1/ads/{ad_id}
- Search advertisers /v1/ads/pages/search
- Get an advertiser /v1/ads/pages/{page_id}
- List an advertiser's ads /v1/ads/pages/{page_id}/ads
Search ads
GET
/v1/ads/search5 credits / callAds matching a keyword or an advertiser page, with filters, up to 30 per call.
One of q or page_id is required.
| Parameter | In | Type | Default | Description |
|---|---|---|---|---|
| q | query | string | — | Keyword (required unless page_id is set) |
| page_id | query | string | — | Only ads of this advertiser page |
| country | query | string | ALL | Two-letter country code or ALL |
| status | query | active | inactive | all | active | Ad status |
| ad_type | query | all | political | all | All ads or political/issue ads |
| media_type | query | all | image | video | meme | none | all | Creative type |
| platforms | query | string | — | Comma-separated: facebook, instagram, messenger, audience_network |
| languages | query | string | — | Comma-separated ISO 639-1 codes |
| active_from | query | date | — | Running on or after (YYYY-MM-DD) |
| active_to | query | date | — | Running on or before (YYYY-MM-DD) |
| match | query | any | exact | any | Keyword match |
| sort | query | relevance | impressions | relevance | Order |
| limit | query | integer (1–30) | 30 | Ads per page (max 30, one page of the source) |
| cursor | query | string | — | pagination.next_cursor of the previous page |
curl "https://api.scrapecrate.com/v1/ads/search?q=running%20shoes" \
-H "X-API-Key: YOUR_API_KEY"{
"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
}
}Get an ad
GET
/v1/ads/{ad_id}5 credits / callOne ad with creatives, payer and beneficiary, and EU/UK transparency data.
| Parameter | In | Type | Default | Description |
|---|---|---|---|---|
| ad_id* | path | string | — | Ad Library ID |
| country | query | string | ALL | Country used to look the ad up |
curl "https://api.scrapecrate.com/v1/ads/1234567890123456" \
-H "X-API-Key: YOUR_API_KEY"{
"data": {
"id": "1234567890123456",
"page": {
"id": "102030405060708",
"name": "Example Shoes"
},
"status": "active",
"started_at": "2026-10-15",
"payers": [
{
"payer": "Example Shoes Ltd",
"beneficiary": "Example Shoes Ltd"
}
],
"transparency": {
"eu": {
"reach": 120000,
"age_min": 18,
"age_max": 65
}
}
},
"meta": {
"request_id": "req_8f2c1a9b0d3e4f5a6b7c",
"credits_used": 5,
"credits_remaining": 9999
}
}Search advertisers
GET
/v1/ads/pages/search5 credits / callAdvertiser pages whose ads match a keyword.
| Parameter | In | Type | Default | Description |
|---|---|---|---|---|
| q* | query | string | — | Keyword |
| country | query | string | ALL | Two-letter country code or ALL |
| limit | query | integer (1–10) | 10 | Pages (max 10, one page of the source) |
curl "https://api.scrapecrate.com/v1/ads/pages/search?q=running%20shoes" \
-H "X-API-Key: YOUR_API_KEY"{
"data": [
{
"id": "102030405060708",
"name": "Example Shoes",
"category": "Shopping & retail",
"like_count": 52000,
"verified": true
}
],
"pagination": {
"next_cursor": "eyJwIjoyfQ",
"has_more": true
},
"meta": {
"request_id": "req_8f2c1a9b0d3e4f5a6b7c",
"credits_used": 5,
"credits_remaining": 9999
}
}Get an advertiser
GET
/v1/ads/pages/{page_id}5 credits / callAdvertiser page details with Instagram account and active ads estimate.
| Parameter | In | Type | Default | Description |
|---|---|---|---|---|
| page_id* | path | string | — | Advertiser page ID |
curl "https://api.scrapecrate.com/v1/ads/pages/102030405060708" \
-H "X-API-Key: YOUR_API_KEY"{
"data": {
"id": "102030405060708",
"name": "Example Shoes",
"category": "Shopping & retail",
"like_count": 52000,
"instagram": {
"username": "exampleshoes",
"followers": 81000,
"verified": false
},
"active_ads_estimate": 42
},
"meta": {
"request_id": "req_8f2c1a9b0d3e4f5a6b7c",
"credits_used": 5,
"credits_remaining": 9999
}
}List an advertiser's ads
GET
/v1/ads/pages/{page_id}/ads5 credits / callThe ads of one advertiser page, with the same filters as search.
| Parameter | In | Type | Default | Description |
|---|---|---|---|---|
| page_id* | path | string | — | Advertiser page ID |
| country | query | string | ALL | Two-letter country code or ALL |
| status | query | active | inactive | all | active | Ad status |
| media_type | query | all | image | video | meme | none | all | Creative type |
| limit | query | integer (1–30) | 30 | Ads per page (max 30, one page of the source) |
| cursor | query | string | — | pagination.next_cursor of the previous page |
curl "https://api.scrapecrate.com/v1/ads/pages/102030405060708/ads" \
-H "X-API-Key: YOUR_API_KEY"{
"data": [
{
"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."
}
],
"pagination": {
"next_cursor": "eyJwIjoyfQ",
"has_more": true
},
"meta": {
"request_id": "req_8f2c1a9b0d3e4f5a6b7c",
"credits_used": 5,
"credits_remaining": 9999
}
}