List advertiser ads
Lists public Facebook Ad Library creatives for a numeric advertiser page ID, with validated country, language, publisher-platform, media, status, date, and sort filters.
fb-adlibrary.advertiser-ads.list
/execute
Shared execution endpoint
Input parameters
active
string
optional
Filter by delivery status Allowed values: `all`, `active`, `inactive`. Default: `all`.
country
string
optional
Two-letter uppercase ISO country code or ALL for worldwide Default: `US`.
US
cursor
string
optional
Opaque scoped continuation token returned as next_cursor; restart from the beginning if the source changed
end_date
string
optional
Optional latest impression date (YYYY-MM-DD)
languages
array<string>
optional
Optional JSON array of content-language codes, for example ["en","es"]
limit
integer
optional
Maximum number of ads to return From 1 to 100. Default: `50`.
5
media_type
string
optional
Filter by creative media type Allowed values: `all`, `image`, `video`, `meme`, `none`. Default: `all`.
page_id
string
required
Numeric Facebook page ID of the advertiser
15087023444
platforms
array<string>
optional
Optional JSON array of publisher platforms Allowed values: `facebook`, `instagram`, `messenger`, `audience_network`, `threads`, `whatsapp`.
sort_by
string
optional
Sort the returned creatives Allowed values: `impressions`, `relevance`, `date`. Default: `impressions`.
start_date
string
optional
Optional earliest impression date (YYYY-MM-DD)
Response
Successful output is returned in results[0].data.
Raw platform output is intentionally open-ended and may evolve with the upstream source.
Illustrative output fields
Values illustrate one response. Read the guidance above for missing values and limits; fields can vary with the requested operation and the data available.
| Path | Observed type | Example |
|---|---|---|
items |
array |
3 items |
items |
array |
3 items |
next_cursor |
string |
[redacted:token] |
total_items |
integer |
5 |
Execution behavior
A 200 response completed inline. A 202 response was queued; poll
GET /jobs/:id until the job reaches completed or
failed.