Get Engagement Trends
get_engagement_trends[Read · free] Get engagement time series for a profile with gap-filled buckets, rolling averages, and trend direction. Each bucket includes avg engagement, likes, comments, shares, and conversation rate. Useful for understanding whether engagement is growing or declining. Pass scope (a post_collections.id) to plot trends for a specific collection.
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": {
"profile_id": "<profile_id>"
},
"name": "get_engagement_trends"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| scope | No | Optional post_collections.id to scope the time series | |
| date_to | No | End date (ISO 8601) | |
| date_from | No | Start date (ISO 8601) | |
| profile_id | Yes | Tracked profile ID from list_profiles | |
| granularity | No | Time bucket granularity | weekly |
| rolling_window | No | Rolling average window size in buckets (default: 4 for weekly, 7 for daily, 3 for monthly) |