Meta ad library search
meta-ad-librarySearch active Facebook and Instagram ads by brand or keyword in one country: ad text, headline, creative links, call to action, start date and platforms. Use it when: You are studying a competitor's advertising or collecting ad creative ideas. Not for: Ad spend figures; Meta publishes those only for political and social-issue ads. Returns: 20 ads: page name, ad text, headline, image and video links, call to action, start date, platforms and active flag. Typical time: about 9 s. Price: $0.022 per search (up to 20 ads), charged only on success. One call = up to 20 ads.
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": "meta-ad-library"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | Brand or keyword, e.g. allbirds | |
| country | No | Two-letter country code, uppercase, e.g. US, GB, DE; default US |