get_analytics
Read published-post performance: views, likes, comments, shares, plus growth over the last 30 days. summary compares the last 30 days with the 30 before (views gained, follower change, posts published; null = not measured, never 0) and followerHistory gives one follower total per day. Call with no argument for every account at once, with accountId for one account, or with postId for a single post. Numbers come from a nightly sync, so they lag the platform by up to a day — lastRefreshedAt says when they were last measured, and a metric a platform does not report comes back as 0. Account and global calls also return bestTimes: the weekday and hours whose posts averaged the most views, to feed scheduledAt in create_post. This is read-only; it never publishes.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | How many top posts to return (default 10). Ignored with postId. | |
| postId | No | postId of one post (from create_post or list_recent_posts). Returns that post's metrics only. | |
| source | No | Which posts topPosts ranks: all (default), mut (published through Multi Upload Tool) or external (posted directly on the platform). Totals and summary always cover every post. | |
| timezone | No | IANA timezone the bestTimes weekday/hour buckets are read in, e.g. Europe/Paris. Defaults to UTC — always pass the user's own zone, because an hour-of-day ranking read in the wrong zone is silently off by the whole offset. | |
| accountId | No | Connected account id (from list_accounts). Omit for all accounts combined. |