Skip to main content
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 under params. Only the keys below are accepted; any other key returns 422 invalid_params.
string
required
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.
integer
Number of ads to return in total. Use 0 for all.
string
default:"active"
Which ads to return.Allowed values: active (Active only), inactive (Inactive only).
boolean
default:"true"
Pull each ad’s advertiser profile and EU transparency block. Keep on for the full record.

Example

Response fields

Each row in data is one ad, keyed by these fields.

Example response

Abridged: long text and lists are shortened.
For TikTok ads use tiktok/ads; for Google ads use google-ads/ads; for LinkedIn ads use linkedin/ads-library.