Insights Tools
Instagram insights tab by tab, connecting Instagram, and workspace-wide member numbers.
Every tool here takes workspaceId. Instagram numbers are as of the last sync, the same ones Grow → Insights shows; each answer says when that was and what Meta does not expose for the account.
get_instagram_insights
The Overview tab: profile (followers, following, posts), KPIs against the period just before (followers, posts, reach, views, interactions, engagement rate), the daily trend, the split by format (posts, reels, stories), the best posts and what each metric means. connected: false means Instagram is not connected; see connect_instagram.
| Parameter | Notes |
|---|---|
account | Username or account id. Omit for the main account. |
days | Last N days, 1 to 180 (default 30) |
startDate, endDate | YYYY-MM-DD, in place of days |
Permission: instagram:read
get_instagram_history
The Posts, Reels and Stories tabs: what an account published in a date range, one page at a time, with caption, link, hashtags and metrics (views, reach, likes, comments, saves, shares, engagement rate; reels add plays and watch time). With postId, that one post's detail.
| Parameter | Notes |
|---|---|
account | Username or account id. Omit for the main account. |
kind | posts (default), reels or stories |
mediaType | Posts only: image, video or carousel |
sort | publishedAt, engagements, engagementRate, views, plays, reach, likes, comments, saves or shares; prefix - for highest first (default -plays for reels, -publishedAt otherwise) |
page, pageSize | From 1; 1 to 50 per page (default 20) |
days or startDate, endDate | As above |
postId | One post's detail instead of a page |
Permission: instagram:read
get_instagram_audience
The Audience tab: the follower timeline, age and gender, countries, cities, the hours followers are online (UTC) and reach from followers against non-followers. Meta withholds some of these for small accounts; the answer says which and why.
Parameters: account, days or startDate/endDate, as above. Permission: instagram:read
get_instagram_hashtags
The Hashtags tab: each hashtag the account used in the range with its post count, median views, reach, likes, comments and saves, its lift against the account's own median (audienceMatch, shown only with enough posts), a few of those posts, and the hashtag pairs used together.
| Parameter | Notes |
|---|---|
sort | postCount (default), views, reach, likes, comments or saves, with a leading - for highest first |
tag | Only this hashtag |
account, days, startDate, endDate, page, pageSize | As above |
Permission: instagram:read
connect_instagram
Whether the workspace has Instagram connected (account, last sync) and, when it has not, a Betterness One link that starts the connection for this workspace. The person opens it, signs in and authorizes Instagram there; nothing connects from the chat. One account per workspace: to switch, disconnect the current one in Betterness One settings first.
Parameters: workspaceId. Permission: instagram:connect
get_member_insights
Workspace-wide numbers about the business's members, never one member's data: sessions, bookings, check-ins, fill rate, busiest hours, churned and paused members, credits and lab redemption per plan, and the latest weekly report. Revenue and the weekly report appear only for connections and keys of an owner or admin (financialsShown, weeklyReportShown). Needs Membership access in the workspace.
| Parameter | Notes |
|---|---|
workspaceId | Required. From list_workspaces |
days | Last N days, 1 to 180 (default 30) |
Permission: insights:read