Skip to documentation
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
View raw

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.

Search Ads fb-adlibrary.ad.search

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.

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

Lists public Facebook Ad Library creatives for a numeric advertiser page ID, with validated country, language, publisher-platform, media, status, date, and sort filters.

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.