search_pages
Find Facebook and Instagram advertiser pages by keyword or brand name and retrieve the page_id needed for page and ad lookups.
Instructions
Find advertisers (Facebook/Instagram pages) that ran ads matching a keyword or brand name. Use it to get the page_id needed by get_page and get_page_ads.
Cost: 1 credit per 10 advertisers returned, rounded up; an empty result costs 0.
Args: query: Brand name or keyword. country: ISO-3166 alpha-2 country or 'ALL' (default). limit: 1-30 (default 10).
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": "search_pages"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | ||
| query | Yes | ||
| country | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |