Campaign reach
x_ads_reachCalculate unique reach and average frequency for ad campaigns within a 7-day window, providing audience size insight beyond raw impressions.
Instructions
Unique reach + average frequency for campaigns. Window ≤ 7 days, whole-hour ISO 8601. Impressions cannot tell you this.
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": {
"account_id": "<account_id>",
"campaign_ids": "<campaign_ids>",
"start_time": "<start_time>",
"end_time": "<end_time>"
},
"name": "x_ads_reach"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| end_time | Yes | ||
| account_id | Yes | Ads API account id from x_ads_list_accounts, e.g. 18ce55v2od2 | |
| start_time | Yes | ||
| campaign_ids | Yes |