Skip to documentation
Upscrape Docs
Sign in Get an API key API key
Browse documentation
For AI agents

Connect your agent to live platform data.

Open in
Platform API Ad libraries

Facebook Ad Library API

Search public Facebook Ad Library creatives and advertiser campaigns.

Platform ID fb-adlibrary
Endpoints 2 capabilities
Status 96.7% success rate
View raw OpenAPI Get an API key

Capabilities

Every capability uses the same POST /execute envelope. Open an endpoint for its exact ID, input contract, code samples, cost, runtime, and illustrative output.

Endpoint Description Cost Open
Search Ads fb-adlibrary.ad.search

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.

1 credit per request
List Advertiser Ads fb-adlibrary.advertiser-ads.list

Lists all ads from a specific Facebook advertiser by their page ID. Returns raw ad data with full filter support.

1 credit per request

Common uses

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

Integration contract

A 200 response completed inline. A 202 response was queued; poll GET /jobs/:id until it reaches completed or failed.