get_account_analytics
Account-level Instagram insights for a date range: total/daily reach, daily follower count, follows vs unfollows, this-week-vs-last-week totals (views/reach/accounts engaged/interactions/profile link taps), and follower demographics (age+gender, top cities, top countries).
`engaged_audience` has the same three breakdowns for the people who
engaged with the content (followers or not), for Instagram's this_week
and this_month timeframes — compare it with the follower demographics to
tell whether the content reaches a different crowd than the follower base.
It ignores since/until (Instagram only offers those two timeframes), is
empty for accounts under 100 engagements in the timeframe, and can lag by
up to 48 hours.
`breakdowns` splits the selected window's totals: views by follower vs
non-follower (`views_by_follower_type`) and by format
(`views_by_media_product_type`: REEL, POST, CAROUSEL_CONTAINER, STORY,
AD), reach the same two ways (`reach_by_follow_type`,
`reach_by_media_product_type`), and profile link taps by contact button
(`profile_links_taps_by_contact_button_type`). `views_non_follower_share`
and `reach_non_follower_share` (0..1) are the share from non-followers,
the clearest reach-growth signal and a good companion to trial reel
results. Meta marks `views` as in development, so present view counts and
their splits as estimates (`views_is_estimate: true`).
Meta only retains account insights for 90 days — a range extending
further back is clamped automatically (`clamped: true` in the result),
and a range entirely older than that returns empty series with
`out_of_retention: true` rather than an error.Two ways to pick the window, pick exactly one style per call:
days: an integer count ending today, in the workspace's own local time — e.g. days=50 for "the last 50 days". Preferred for relative asks ("last N days", "this month so far") since it does the date math correctly against the account's own clock instead of you computing it.
since/until: explicit "YYYY-MM-DD" bounds (inclusive), in the workspace's own timezone (list_workspaces/get_posting_slots show it) — for a specific calendar window ("August 1 to August 15"). Passing days together with since/until is rejected as ambiguous. Omitting all three defaults to the last 30 days.
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": {
"workspace_id": "<workspace_id>"
},
"name": "get_account_analytics"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| days | No | ||
| since | No | ||
| until | No | ||
| workspace_id | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| range | Yes | The window a response was actually built for. Always echoed so a caller labels the numbers from what came back, not from request state — the 90-day clamp and the cache can both make those differ. | |
| reach | Yes | ||
| cities | Yes | ||
| clamped | No | ||
| follows | Yes | ||
| countries | Yes | ||
| last_week | Yes | ||
| this_week | Yes | ||
| unfollows | Yes | ||
| age_gender | Yes | ||
| breakdowns | No | Window totals split by audience, format and contact button. Keys inside each split are Meta's dimension values, e.g. FOLLOWER / NON_FOLLOWER for the audience splits, REEL / POST / CAROUSEL_CONTAINER / STORY / AD for the format splits, and EMAIL / CALL / TEXT / DIRECTION / BOOK_NOW / INSTANT_EXPERIENCE / UNDEFINED for contact buttons. An empty dict means Meta returned nothing for that split (or the call failed). | |
| totals_28d | Yes | ||
| follower_count | Yes | ||
| followers_total | Yes | ||
| engaged_audience | No | Who engaged with the content (engaged_audience_demographics), for Instagram's two supported timeframes. Both are fetched up front so the Account tab's week/month toggle is instant and shares one cache entry. Unlike the account series these ignore the date picker: Meta only offers this_week / this_month. Meta returns nothing for an account under 100 engagements in the timeframe, so empty blocks are normal for small accounts, and the numbers can lag by up to 48 hours. | |
| out_of_retention | No |