search_ad_library
Search Meta's Ad Library to find ads by keywords, countries, and type for competitive research and transparency analysis.
Instructions
Search the Meta Ad Library for ads. Allows searching by keywords, countries, and ad type. Useful for competitive research and transparency.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| search_terms | Yes | Keywords to search for in ads | |
| ad_reached_countries | Yes | Comma-separated country codes where ads were shown (e.g. 'US,GB,KR') | |
| ad_type | No | Ad type filter: ALL, POLITICAL_AND_ISSUE_ADS, HOUSING_ADS, etc. | |
| fields | No | Comma-separated fields to return | |
| limit | No | Number of results (default 25) | |
| after | No | Pagination cursor for next page | |
| order_by | No | Sort order for results |