get_page_ads
List a competitor's Meta ads, newest and most relevant first, to analyze their active or inactive campaigns by country, platform, and media type.
Instructions
List the ads of one advertiser (competitor), newest and most relevant first.
Cost: 1 credit per 10 ads returned, rounded up; an empty result costs 0.
Args: page_id: Numeric advertiser page ID (use search_pages to find it from a brand name). country: ISO-3166 alpha-2 country or 'ALL' (default). status: 'active' (default), 'inactive' or 'all'. media_type: 'all', 'image', 'video', 'meme' or 'none'. platforms: Subset of facebook, instagram, messenger, audience_network, threads. languages: ISO-639-1 language codes. active_from: YYYY-MM-DD. active_to: YYYY-MM-DD. sort: 'relevance' (default) or 'impressions'. limit: Ads per page, 1-50 (default 10). cursor: next_cursor from a previous call, to get the next page (same filters).
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": {
"page_id": "<page_id>"
},
"name": "get_page_ads"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| sort | No | relevance | |
| limit | No | ||
| cursor | No | ||
| status | No | active | |
| country | No | ALL | |
| page_id | Yes | ||
| active_to | No | ||
| languages | No | ||
| platforms | No | ||
| media_type | No | all | |
| active_from | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |