Get posting insights
get_analytics_insightsInsights computed from the organization's own posting history over the last 12 months: best day/time slots to post (by average lifetime engagement per publication), engagement by content type (text/image/video), weekly posting cadence vs engagement, and averages. In bestTimes, dayOfWeek is 0 = Sunday … 6 = Saturday and slot n covers hours [n×4, (n+1)×4) — e.g. slot 2 is 8:00–12:00 — both in the organization's timezone; topSlots only includes cells with at least 3 samples. Treat thin buckets as hints, and say so when notEnoughData is true. Restrict every block to one platform or one connected account. For one Instagram account the response also carries audienceActivity: {data, reason} with the hours your followers are online (same dayOfWeek/slot cells, avgOnline followers per hour), or the reason it is empty (MISSING_PERMISSION, NOT_OFFERED, BELOW_FOLLOWER_THRESHOLD, NOT_COLLECTED_YET, NO_DATA, CONNECTION_INACTIVE, METRICS_OFF, METRICS_PAUSED) — never read an empty block as zero. For concrete times to schedule at, use suggest_posting_times.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "get_analytics_insights"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| platform | No | Restrict to one platform | |
| organizationId | No | Organization to act in — an id from list_organizations. Required when this connection was authorized for more than one organization; omit it when there is only one. | |
| platformConnectionId | No | Restrict to one connected account (id from list_platform_connections) — use this when the organization has several accounts on the same platform. Its platform wins over `platform`; a different one is refused. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cadence | No | Posting frequency vs engagement | |
| averages | No | ||
| platform | No | Filter applied, or null for all | |
| timezone | No | IANA zone all bucketing used | |
| bestTimes | No | Day-of-week × time-slot cells, plus the top slots | |
| windowStart | No | ||
| contentTypes | No | Average engagement by media type | |
| notEnoughData | No | True when the sample is too thin to read as signal | |
| audienceActivity | No | When this Instagram account's followers are online: {timezone, capturedAt, dayCount, slots[{dayOfWeek, slot, avgOnline, sampleCount}]} in the organization's timezone. Present only for one Instagram account | |
| availablePlatforms | No | ||
| platformConnectionId | No | Connected-account filter applied, or null for every account |