Skip to documentation
Browse documentation

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.

Capability ID fb-adlibrary.advertiser-ads.list
Cost 1 credit per request
Maximum runtime 120 seconds
View raw

POST /execute Shared execution endpoint

Input parameters

active string optional

Filter by delivery status

Available values allactiveinactive
country string optional

Two-letter uppercase ISO country code

Example US
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

Example 5
media_type string optional

Filter by creative media type

Available values allimagevideomemenone
page_id string required

Numeric Facebook page ID of the advertiser

Example 15087023444
platforms array<string> optional

Optional JSON array of publisher platforms

sort_by string optional

Sort the returned creatives

Available values impressionsrelevancedate
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 sample The full redacted fixture is shown in the response panel.

Illustrative output fields

Derived from the sample above for orientation only. These observed fields are not a fixed response schema.

PathObserved typeExample
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.