Get account stats
social_account_stats_listUse this when the user asks how one of their own accounts performed over a date range: followers and follower growth, views, reach, likes, comments, shares and the other account-level metrics the channel provides, per day, week or month. Needs an account ID from social_accounts_list. Returns one row per period; the metric names differ by channel. For single posts or engagement rate per post, use social_account_posts_list. For competitors, use social_competitor_stats_list.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>",
"since": "<since>",
"until": "<until>"
},
"name": "social_account_stats_list"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| since | Yes | First day of the range, YYYY-MM-DD, for example 2026-10-01. | |
| until | Yes | Last day of the range, YYYY-MM-DD, included. The last 1 to 3 days may not be available yet, depending on the channel; whatever data exists is returned. | |
| period | No | Group the rows by day (default), week or month. | |
| account_id | Yes | The account ID from social_accounts_list. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| account | No | ||
| _envelope | Yes | Versioned response envelope metadata. | |
| account_stats | Yes | List of account stats for the given period. | |
| action_required | No | Present only when a user action is required before this request can be answered. The data block is empty and no credits were charged. Do not re-call this tool with different arguments or a wider date range; the workspace needs a change first, unless the action says how to adjust the call or names a tool that makes the change. |