search_interests
Discover relevant audience interests for Meta Ads targeting by entering keywords to find matching topics and categories.
Instructions
Find audience interests by keyword.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | ||
| meta_access_token | No | ||
| page_size | No | ||
| page_cursor | No |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |
Implementation Reference
- The implementation of the `search_interests` tool which searches for audience interests using the Meta API.
@mcp_server.tool() @meta_api_tool async def search_interests( query: str, meta_access_token: Optional[str] = None, page_size: int = 25, page_cursor: str = "", ) -> str: """Find audience interests by keyword.""" if not str(query or "").strip(): return _as_json({"error": "No query provided"}) params: Dict[str, Any] = { "type": "adinterest", "q": query, "page_size": int(page_size), } if page_cursor: params["page_cursor"] = page_cursor payload = await make_api_request("search", meta_access_token, params) return _as_json(payload)