All sites
Data API
Facebook Data API
Public pages, posts and profile data from Facebook.
17endpointslogin_wall · Rate Limit handled for you
Example (captured live)
facebook.com
ExampleJSON responseclick the page to trace a field
{
"query": "coffee",
"country": "US",
"results": [
{
"scraped_at": "2026-08-10T21:05:13.482911+00:00",
"page": "Blue Bottle Coffee",
"text": "Blue Bottle Coffee · Sponsored. Freshly roasted, shipped within 48 hours. Try our starter pack today and taste the difference of specialty coffee.",
"image": "https://scontent.xx.fbcdn.net/v/t39.30808-6/ad_bluebottle_starter.jpg"
},
{
"scraped_at": "2026-08-10T21:05:13.501244+00:00",
"page": "Death Wish Coffee",
"text": "Death Wish Coffee · Sponsored. The world's strongest coffee. Save 20% on your first subscription and never run out again.",
"image": "https://scontent.xx.fbcdn.net/v/t39.30808-6/ad_deathwish.jpg"
},
{
"scraped_at": "2026-08-10T21:05:13.512088+00:00",
"page": "Stumptown Coffee Roasters",
"text": "Stumptown Coffee Roasters · Sponsored. Cold brew, bottled fresh in Portland. Free shipping on orders over $40.",
"image": "https://scontent.xx.fbcdn.net/v/t39.30808-6/ad_stumptown.jpg"
}
]
}
GET
/v1/data/facebook/ads/search1 credit / run VerifiedAds Search
Search the public Ad Library archive.
Handled for you:login_wallRate Limit
Parameters
| Name | Type | Req | Description |
|---|---|---|---|
| query | string | yes | Advertiser name or keyword. |
| Advanced filters | |||
| country | string | no | Country code the ads ran in. (default: US) |
| ad_type | string | no | Ad category to search. (default: all) |
| active_status | string | no | Ad delivery status. (default: all) |
| media_type | string | no | Creative media type. (default: all) |
| cursor | string | no | Pagination cursor from a previous response. |