Get a connected account's insights
get_account_insightsAccount-level insights of ONE connected account: the follower total and its growth for every platform, and what each platform adds. Platforms and the figures each one reports (the activity.series / activity.totals keys; the follower total is followers.current, and followersNow): Instagram (INSTAGRAM): followersCount, followerCount, follows, unfollows, reach, views, accountsEngaged, totalInteractions, likes, comments, saves, shares, replies, reposts, profileLinksTaps; Facebook (FACEBOOK): followersCount; YouTube (YOUTUBE): followersCount; Pinterest (PINTEREST): followersCount, impressions, totalInteractions, saves, pinClicks, outboundClicks; TikTok (TIKTOK): followersCount; Bluesky (BLUESKY): followersCount; Mastodon (MASTODON): followersCount; X (Twitter) (TWITTER): followersCount. Only Instagram (connected through either Instagram Login or Facebook Login) reports reach, views, accounts engaged, follows and unfollows per day and the audience's country, city and age/gender; Pinterest reports a daily series of impressions, totalInteractions (Pinterest's own engagement count), saves, pinClicks and outboundClicks; Facebook, YouTube, TikTok, Bluesky, Mastodon, X (Twitter) report the follower total only, so for them activity, followChanges and both demographics blocks come back NO_DATA, which means the platform does not report that block — it is not a zero and not "yet", so do not promise it will fill in. YouTube rounds its subscriber count down to three significant figures, so a YouTube channel's followers are YouTube's rounded figure, and a channel that hides its subscriber count has none. TikTok means Login Kit accounts (a TikTok Business account is refused). Collected once a day; every platform's follower series starts on the first day PostRite collected the account (for an account connected before account insights shipped, the first nightly run after that, not the day it was connected), so a new account has a single point (Pinterest also backfills the last 30 days of its daily series and stores only days Pinterest has finished counting, a few days late). Instagram: reports with a delay of up to 48 hours, so the latest days can still change (dataLagHours is that Instagram figure); the first collection backfills the last 30 days of reach and of the daily follower change and the last 7 days of views, accounts engaged, interactions, follows and unfollows, while the follower total and the audience start on the first day PostRite collected the account, so a new account has fewer days than the period asked; Instagram reports the follower figures only for accounts with at least 100 followers (minFollowers). Every block (followers, activity, followChanges, demographics.followers, demographics.engaged) is {data, reason}: either its data or the reason it has none (MISSING_PERMISSION, NOT_OFFERED, BELOW_FOLLOWER_THRESHOLD, NOT_COLLECTED_YET, NO_DATA, CONNECTION_INACTIVE, METRICS_OFF, METRICS_PAUSED) — an empty block is NOT zero, so say why it is empty instead of reporting 0. MISSING_PERMISSION and CONNECTION_INACTIVE are fixed by reconnecting the account in PostRite (MISSING_PERMISSION is Instagram's); NOT_OFFERED means PostRite does not request the permission right now, so reconnecting changes nothing; BELOW_FOLLOWER_THRESHOLD is Instagram's rule (followersNow and minFollowers say how far the account is); NOT_COLLECTED_YET resolves after the next daily run, and after the next weekly read for the audience (up to a week); NO_DATA means the platform answered with an empty dataset, or does not report that block at all. METRICS_OFF and METRICS_PAUSED are X's: reading an X account's metrics may add costs to the customer's own X developer account, so it is off until someone turns it on with the switch on the account's card in the app's Platforms page (METRICS_OFF), and X refusing the read (no credit left, or keys without read access) pauses it until someone clicks Resume there (METRICS_PAUSED) — no tool changes either, so tell the user where the switch is; what was collected before stays readable. In activity.series a null metric on a day was not returned, never zero; totals sum the period, and previousTotals the equally long one before only for the metrics whose number of days matches (otherwise null: no comparison). Instagram's reach and accountsEngaged are sums of daily unique counts, higher than Instagram's own period figure, which counts each account once, so never present them as unique accounts for the period. Demographics are an Instagram weekly snapshot (capturedAt, covering the response's timeframe) of the top values Instagram returns, so a share is of the listed values, not of all followers. For the hours an Instagram account's followers are online use get_analytics_insights with this platformConnectionId (audienceActivity). Find the id with list_platform_connections (any platform listed above).
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": {
"platformConnectionId": "<platformConnectionId>"
},
"name": "get_account_insights"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| days | No | Period in days (7, 30, 90; default 30) | |
| 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 | Yes | The account's connection id (from list_platform_connections); a platform without account insights, or a TikTok Business account, is refused |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| days | No | Period length in days | |
| activity | No | {series[{date, reach, views, accountsEngaged, totalInteractions, likes, comments, saves, shares, impressions, pinClicks, outboundClicks, …}], totals, previousTotals}: a null metric was not returned, never zero. Which keys a platform fills is the tool description's per-platform list; a platform with no daily series has no activity (NO_DATA) | |
| platform | No | ||
| username | No | The account's handle | |
| followers | No | {current, asOf, change, start, series[{date, followers, gained}]}: the follower total, its change over the period (null with fewer than two figures) and one entry per collected day | |
| periodEnd | No | YYYY-MM-DD, UTC days | |
| periodStart | No | YYYY-MM-DD, UTC days | |
| dataLagHours | No | How late Instagram reports its figures (Instagram only) | |
| demographics | No | ||
| followersNow | No | Latest known follower total; null before the first collection | |
| minFollowers | No | Followers Instagram needs before it reports its follower metrics (Instagram only) | |
| followChanges | No | {series[{date, follows, unfollows}], totals, previousTotals}: Instagram only (NO_DATA for every other platform) | |
| lastCollectedDate | No | Newest collected day, YYYY-MM-DD; null before the first run | |
| platformConnectionId | No |