Ad stats
get_ad_statsRetrieve views, clicks, CTR, CPC, CPM, and spend for a single Telegram ad over the last 24 hours or lifetime, with optional charts.
Instructions
Get views/clicks/CTR/CPC/CPM/spend for one ad. period=5min: last 24h; day: lifetime. summary.spend is already scaled (Gram); never divide. For many ads use get_ads. detail=full adds charts.
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": {
"ad_id": "<ad_id>"
},
"name": "get_ad_stats"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ad_id | Yes | ||
| detail | No | summary | |
| period | No | 5min |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||