# Facebook Ad Library API

Search public Facebook Ad Library creatives and advertiser campaigns.

- Platform ID: `fb-adlibrary`
- Capabilities: 4
- Execute endpoint: `POST https://data.upscrape.com/execute`



## Capabilities

### [Get ad detail](https://docs.upscrape.com/docs/platforms/fb-adlibrary/fb-adlibrary.ad.get)

- Capability ID: `fb-adlibrary.ad.get`
- Cost: 1 credit per request

Looks up one public Ad Library archive ID from the anonymous deeplink detail payload and returns source-provided creative and transparency metadata.
### [Search ads](https://docs.upscrape.com/docs/platforms/fb-adlibrary/fb-adlibrary.ad.search)

- Capability ID: `fb-adlibrary.ad.search`
- Cost: 1 credit per request

Searches the public Facebook Ad Library by keyword and returns raw creative and transparency metadata. Supports validated country, language, publisher-platform, media, status, date, and sort filters.
### [List advertiser ads](https://docs.upscrape.com/docs/platforms/fb-adlibrary/fb-adlibrary.advertiser-ads.list)

- Capability ID: `fb-adlibrary.advertiser-ads.list`
- Cost: 1 credit per request

Lists public Facebook Ad Library creatives for a numeric advertiser page ID, with validated country, language, publisher-platform, media, status, date, and sort filters.
### [Discover advertisers](https://docs.upscrape.com/docs/platforms/fb-adlibrary/fb-adlibrary.advertiser.discover)

- Capability ID: `fb-adlibrary.advertiser.discover`
- Cost: 1 credit per request

Finds public Ad Library page suggestions by name or prefix and returns numeric page IDs for advertiser ad listings.

## Common uses

- Monitor competitors' active advertising
- Research creative and messaging trends
- Build public ad-transparency datasets

## Integration contract

All capabilities use the shared `POST /execute` envelope. A `200` response completed inline; a `202` response must be polled through `GET /jobs/{id}`.

See [authentication](https://docs.upscrape.com/docs/api/authentication), [jobs and results](https://docs.upscrape.com/docs/api/jobs), and [errors and retries](https://docs.upscrape.com/docs/api/errors).