Analytics
One tool, get_insights, reads the figures each network reports for your accounts: views, reach, engagement, followers, your best posts and when to post. Ask in plain words: your AI app picks the report and the account.
Reports
Your AI app passes report; overview is the default. Not every network has every report: the table below says which.
overview defaultViews, reach, engagement and followers over the last days, in the network’s own terms plus a headline every network shares. Without account, every analytics account side by side.followers The follower count day by day (subscribers on YouTube), with followers gained and lost.audience Followers by country and city, and by age and gender where the network reports them.top_posts Your best posts of the period, ranked by engagement or by sort (views, reach, likes, comments, shares, date). Without account, across every analytics account.timing The weekday and hour slots that work best for your own posts (in UTC), how often you post against the engagement you get, and how fast posts peak. Instagram: when your followers are online.inbox Messages received and sent, the median time to a first reply and the busiest hours.search_keywords The Google searches that showed your Business Profile, month by month.post One post’s figures, by the post_id from list_posts, top posts or create_post. details: true adds its day-by-day curve and the network’s extras.By network
Which report each network has, from the live server.
| Report | Threads | TikTok | YouTube | Google Business Profile | Instagram Business | |
|---|---|---|---|---|---|---|
Overview overview | ||||||
Followers followers | — | — | ||||
Audience audience | — | — | — | |||
Top posts top_posts | ||||||
Best time to post timing | ||||||
Inbox activity inbox | — | — | — | — | — | |
Search keywords search_keywords | — | — | — | — | — | |
One post post |
How your AI asks
You don’t name reports. Ask the way you’d ask a colleague; your AI app turns it into a call.
get_insights({ report: "overview", days: 30 })Every analytics account side by side, over the last 30 days.
get_insights({ report: "top_posts", provider: "tiktok" })Your TikTok posts, ranked by engagement. Ask for views or shares and it sorts by those.
get_insights({ report: "timing", provider: "instagrambusiness" })The best weekday and hour slots from your own posts, and when your followers are online.
Example
What comes back for an overview of every account: the network’s own figures, and a headline in the same shape everywhere.
metricsThe figures as the network names them (reach, saves, page_media_view…), so nothing is lost in translation.headlineviews, reach, engagement and followers in the same shape on every network; null where a network doesn’t report one.sourceaccount when the network reports account figures; posts when they’re summed from the account’s posts (Threads).{ "report": "overview", "from": "2026-10-11", "to": "2026-11-09", "accounts": [ { "account_id": "e2c4a6b8-1d3f-4a5c-9e7b-2f4d6a8c0e13", "provider": "instagrambusiness", "name": "Northwind Studio", "source": "account", "metrics": { "reach": 12480, "views": 48210, "accounts_engaged": 1034, "total_interactions": 2876, "likes": 2310, "comments": 184, "saves": 212, "shares": 97, "profile_views": 1920, "website_clicks": 61 }, "headline": { "views": 48210, "reach": 12480, "engagement": 2876, "followers": null, "followers_gained": null, "followers_lost": null } }, { "account_id": "f1a3c5e7-9b2d-4f6a-8c0e-5d7b9f1a3c48", "provider": "facebookpages", "name": "Northwind Studio", "source": "account", "metrics": { "page_media_view": 21340, "page_total_media_view_unique": 8120, "page_views_total": 640, "page_post_engagements": 1120, "page_video_views": 3010, "page_follows": 3420, "followers_gained": 58, "followers_lost": 9 }, "headline": { "views": 21340, "reach": 8120, "engagement": 1120, "followers": 3420, "followers_gained": 58, "followers_lost": 9 } }, { "account_id": "a4c6e8f0-2b4d-4f6a-9c1e-3d5f7b9a1c72", "provider": "pinterest", "name": "Northwind Studio", "source": "account", "metrics": { "impressions": 30900, "engagements": 1460, "saves": 380, "pin_clicks": 610, "outbound_clicks": 205, "follower_count": 1288, "followers_gained": 41, "followers_lost": 6 }, "headline": { "views": 30900, "reach": null, "engagement": 1460, "followers": 1288, "followers_gained": 41, "followers_lost": 6 } } ] }
The tool
Exactly what your AI app receives from tools/list.
get_insightsGet insights · ReadsReads · 3,000/dayRead
How an account is doing, as its network reports it (Instagram Business, TikTok, YouTube, Pinterest, Google Business Profile, Threads). report: overview (default): the account's figures over the last `days` (views, reach, engagement, followers… as the network reports them, plus a comparable headline); without account, every analytics account side by side; followers: the follower (YouTube: subscriber) count day by day, with gained and lost; audience: followers by country, city, age and gender, as far as the network reports them; top_posts: the best posts of the last `days` by `sort` (engagement by default), with their figures; without account, across every analytics account; timing: when to post, from the account's own posts (best weekday × hour slots in UTC, posts per week vs engagement, how fast posts reach their final engagement; Instagram: when followers are online); inbox: messages received and sent, median time to first reply and the busiest hours; search_keywords: the Google searches that showed the Business Profile, by month; post: one post's figures (post_id from list_posts, top_posts or create_post); details=true adds its day-by-day curve and the network's extras (Facebook earnings, YouTube retention and daily views). Not every network has every report (followers: Instagram Business, TikTok, YouTube, Pinterest; audience: Instagram Business, TikTok, YouTube; inbox: Instagram Business; search_keywords: Google Business Profile). LinkedIn, WhatsApp, Telegram and the personal Instagram and Facebook logins have no insights here. Read-only.
accountaccount_id from list_accounts. Leave it out for overview or top_posts to cover every analytics account; the other reports need it when several are connected.providerreportdayspost_idpost_id (or the scheduled_post_id create_post gave)detailssorttop_posts: what ranks the postslimittop_posts: how many postscursorsearch_keywords: next_cursor from the previous page{ "report": "overview", "from": "2026-10-11", "to": "2026-11-09", "accounts": [ { "account_id": "e2c4a6b8-1d3f-4a5c-9e7b-2f4d6a8c0e13", "provider": "instagrambusiness", "name": "Northwind Studio", "source": "account", "metrics": { "reach": 12480, "views": 48210, "accounts_engaged": 1034, "total_interactions": 2876, "likes": 2310, "comments": 184, "saves": 212, "shares": 97, "profile_views": 1920, "website_clicks": 61 }, "headline": { "views": 48210, "reach": 12480, "engagement": 2876, "followers": null, "followers_gained": null, "followers_lost": null } }, { "account_id": "f1a3c5e7-9b2d-4f6a-8c0e-5d7b9f1a3c48", "provider": "facebookpages", "name": "Northwind Studio", "source": "account", "metrics": { "page_media_view": 21340, "page_total_media_view_unique": 8120, "page_views_total": 640, "page_post_engagements": 1120, "page_video_views": 3010, "page_follows": 3420, "followers_gained": 58, "followers_lost": 9 }, "headline": { "views": 21340, "reach": 8120, "engagement": 1120, "followers": 3420, "followers_gained": 58, "followers_lost": 9 } }, { "account_id": "a4c6e8f0-2b4d-4f6a-9c1e-3d5f7b9a1c72", "provider": "pinterest", "name": "Northwind Studio", "source": "account", "metrics": { "impressions": 30900, "engagements": 1460, "saves": 380, "pin_clicks": 610, "outbound_clicks": 205, "follower_count": 1288, "followers_gained": 41, "followers_lost": 6 }, "headline": { "views": 30900, "reach": null, "engagement": 1460, "followers": 1288, "followers_gained": 41, "followers_lost": 6 } } ] }
gaplimitcooldownpermission