POST /v1/data/facebook/ads/run
Pricing: $0.005 per ad ($5.00 per 1,000).
Give a Facebook page URL or handle; set how many ads to return and whether to include inactive ads.
Request
Send the inputs underparams. Only the keys below are accepted; any other key returns 422 invalid_params.
The advertiser’s Facebook page URL or handle (e.g. facebook.com/nike), or its Instagram profile URL (e.g. instagram.com/nike).Format e.g.
https://www.facebook.com/nike.Which ads to return.Allowed values:
active (Active only), inactive (Inactive only).Pull each ad’s advertiser profile and EU transparency block. Keep on for the full record.
Example
Response fields
Each row indata is one ad, keyed by these fields.
Example response
Abridged: long text and lists are shortened.Related APIs
For TikTok ads usetiktok/ads; for Google ads use google-ads/ads; for LinkedIn ads use linkedin/ads-library.