# Facebook Ad Library API

Search public Facebook Ad Library creatives and advertiser campaigns.

- Platform ID: `fb-adlibrary`
- Capabilities: 2
- Execute endpoint: `POST https://data.upscrape.com/execute`
- OpenAPI: https://upscrape.com/scrapers/fb-adlibrary/openapi.json

## Capabilities

| Endpoint | Capability ID | Cost | Description |
| --- | --- | --- | --- |
| [Search Ads](https://docs.upscrape.com/docs/platforms/fb-adlibrary/fb-adlibrary.ad.search) | `fb-adlibrary.ad.search` | 1 credit per request | Searches the Facebook Ad Library by keyword. Returns raw ad data including creative content, targeting info, spend data, and all metadata. Supports filtering by language, platform, media type, active status, date range, and sorting. |
| [List Advertiser Ads](https://docs.upscrape.com/docs/platforms/fb-adlibrary/fb-adlibrary.advertiser-ads.list) | `fb-adlibrary.advertiser-ads.list` | 1 credit per request | Lists all ads from a specific Facebook advertiser by their page ID. Returns raw ad data with full filter support. |

## 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).