facebook_adLibrary_search_ads
Search Meta Ad Library ads by keyword and apply country, language, status, media type, ad type, phrase match, sort, and impression-date filters to find matching creatives.
Instructions
facebookAdLibrary: Search. GET /v1/facebook/adLibrary/search/ads. Search the Meta Ad Library by keyword, with the Ad Library's own filters: country, language, status, media type, ad type, exact phrase, sort, and an impressions date range. Returns searchResults (one card per creative group, as the Ad Library shows them: ad_archive_id, page_name, is_active, publisher_platform, collation_count, start/end dates and a snapshot with body text, images, videos, cards and cta_text), searchR Costs 1 credit when it succeeds. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
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_adLibrary_search_ads"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| trim | No | Set true for a trimmed response. | |
| query | Yes | Keyword to search for (up to 200 characters) | |
| cursor | No | The cursor from the previous page. Send it with the same filters. | |
| status | No | Status of the ad. Defaults to ACTIVE. | |
| ad_type | No | Search for all ads or only political and issue ads | |
| country | No | Where Facebook showed the ad: one two-letter country code, such as US, or ALL (default). Results can include advertisers from other countries whose ads reached it. | |
| sort_by | No | Sort by impressions (high to low), or Most Recent (relevancy_monthly_grouped). Defaults to impressions. | |
| end_date | No | Only ads with impressions on or before this date, YYYY-MM-DD. | |
| language | No | Only ads in this language: a two-letter code such as EN, ES or FR. | |
| media_type | No | Ad media type. Defaults to ALL. MEME means an image with text. | |
| start_date | No | Only ads with impressions on or after this date, YYYY-MM-DD. | |
| search_type | No | keyword_unordered (default) matches the words in any order; keyword_exact_phrase matches the phrase as written. |