Search Ads
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.
fb-adlibrary.ad.search
/execute
Shared execution endpoint
Input parameters
active
string
optional
Filter by delivery status
country
string
optional
Two-letter uppercase ISO country code
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
5
media_type
string
optional
Filter by creative media type
platforms
array<string>
optional
Optional JSON array of publisher platforms
query
string
required
Non-empty search keyword or phrase (maximum 200 characters)
nike
sort_by
string
optional
Sort the returned creatives
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
Derived from the sample above for orientation only. These observed fields are not a fixed response schema.
| 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.