Meta Ad Library / API Reference
meta_ad_library_search_ads
Search Meta's public Ad Library by keyword. Searches ad copy across advertisers. Note that a keyword search misses brands whose ads never mention their own name -- use meta_ad_library_find_advertiser when you want everything one company runs. COVERAGE: ordinary commercial ads come back only for EU countries and GB. For the US, Israel, Canada and elsewhere Meta's API carries political and social-issue ads only, and a commercial search there returns empty. That is not an error; read the `note` in the response and follow its `next_step`. Args: search_terms: What to search for in ad text, e.g. 'house painting'. countries: Two-letter country codes, comma separated, e.g. 'IE' or 'DE,FR'. Use an EU country or 'GB' for commercial ads. ad_type: 'ALL' (default), 'POLITICAL_AND_ISSUE_ADS', 'HOUSING_ADS', 'EMPLOYMENT_ADS', 'FINANCIAL_PRODUCTS_AND_SERVICES_ADS'. ad_active_status: 'ACTIVE' (default), 'INACTIVE' or 'ALL'. media_type: Optional 'IMAGE', 'VIDEO', 'MEME', 'NONE'. publisher_platforms: Optional, comma separated, e.g. 'FACEBOOK,INSTAGRAM'. date_min: Optional earliest delivery date, YYYY-MM-DD. date_max: Optional latest delivery date, YYYY-MM-DD. limit: Max ads to return. Default 25. after: Paging cursor from a previous call's `after`. refresh: Skip the cache and ask Meta again.
This is a read-only tool: it returns ad library search ads for your Meta Ad Library account. It changes nothing.
Ask Claude
You do not call this tool yourself. Ask for the outcome and the client picks the tool:
Ad library search ads in my Meta Ad Library account for [search terms].
It takes 1 required and 10 optional parameters.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
search_terms | string | Yes | Search Terms |
countries | string | No | Countries |
ad_type | string | No | Ad Type |
ad_active_status | string | No | Ad Active Status |
media_type | string | No | Media Type |
publisher_platforms | string | No | Publisher Platforms |
date_min | string | No | Date Min |
date_max | string | No | Date Max |
limit | integer | No | Limit |
after | string | No | After |
refresh | boolean | No | Refresh |
Related Meta Ad Library tools
meta_ad_library_ad_detailsmeta_ad_library_advertiser_adsmeta_ad_library_check_accessmeta_ad_library_creative_anglesmeta_ad_library_eu_reachmeta_ad_library_find_advertiser
Start free — 30 tool calls a month
No card required. Connect Google Ads, Meta Ads, GA4 or Search Console and ask Claude for the outcome — it picks the tool.