Search Meta / Facebook Ad Library
facebook_ads_searchRead-onlyIdempotent
Search active or historical commercial ads from the Meta (Facebook & Instagram) Ad Library by keyword or brand without Meta Graph API identity verification (2 credits per ad, min 10 credits).
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": {
"query": "<query>"
},
"name": "facebook_ads_search"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Ads to return (1-50) | |
| query | Yes | Brand, product, or advertiser search query (aliases: q, keyword, advertiser) | |
| cursor | No | Optional pagination cursor from previous response | |
| country | No | Two-letter ISO country code or ALL (e.g. US, GB, DE, ALL) | US |
| active_status | No | Filter by status: active, inactive, or all | active |