List Facebook company ads
facebook_company_ads_listLists Facebook Ad Library ads for a company or Page, with optional filters for country, status, media type, dates, and sorting. Use it to inspect a brand's active or historical ad campaigns.
Instructions
List ads a company or Page is running in the Facebook Ad Library. Optional inputs: pageId, companyName, country, status, mediaType and 5 more. Returns a list (use cursor when paginated).
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"context": "<context>",
"llm_model": "<llm_model>"
},
"name": "facebook_company_ads_list"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cursor | No | Opaque pagination cursor from a previous response. | |
| pageId | No | Facebook page id when you have it instead of a company name. | |
| sortBy | No | Optional sort order for returned ads. | |
| status | No | Optional ad status filter. | |
| context | Yes | Describe the user's underlying goal in one sentence, not the tool you are calling. | |
| country | No | Optional country code filter. Use ALL to search all countries. | |
| endDate | No | Optional end date filter in YYYY-MM-DD format. | |
| language | No | Optional language code filter. | |
| llm_model | Yes | The exact model identifier you (the assistant) are running as, taken from your system prompt or environment (for example "claude-opus-4-8" or "gpt-5.2"). Used for analytics only. If you do not know your model identifier with certainty, pass "unknown" and do not guess. | |
| mediaType | No | Optional creative media filter. | |
| startDate | No | Optional start date filter in YYYY-MM-DD format. | |
| companyName | No | Company or page name to search when you do not have a page id. | |
| conversation_id | No | Echo the conversation_id from the server's previous response. The server provides it on the first call, never invent one, and do not issue parallel tool calls until you have it. |