Check whether the Instagram server has a working token, which account it reads, which API host it uses, and when the token expires (Instagram Login tokens renew themselves). Call this first if another Instagram tool reports a sign-in problem.

The connected Instagram account's profile and current counts: username, display name, biography, website, followers, following and number of posts. For performance over a period use get_instagram_performance_summary.

Account-level totals for a period, like the Insights overview in the Instagram app: views, reach, accounts engaged, interactions (likes, comments, shares, saves, replies, reposts), profile link taps, follows, unfollows and net follows, each with the previous period and % change, plus engagement rate (interactions / reach). Any range up to 2 years; reach and accounts_engaged need a range of 29 days or less (unique accounts can't be added up). For trends use get_instagram_metrics_over_time; for posts get_instagram_top_media.

A time series of account metrics by day, week or month, for trend analysis and growth charts (views, reach, interactions, likes, comments, shares, saves, follows, unfollows, net follows, …). One Instagram request per bucket: use week or month for long periods. Buckets cut off by the range are flagged partial=true.

Who the audience is: age, gender, age × gender, top cities and top countries of the followers, or of the accounts that engaged with the content. Rows have counts and share_pct; age also has app_share_pct (the app's own rule) and gender share_of_known_pct.

When followers are on Instagram: average followers online per hour of the day, and the best weekday + hour slots, in the report timezone. Use it to pick posting times.

Run any read-only GET on Meta's Instagram Graph API for the connected account and return Meta's raw JSON: the escape hatch when no other tool fits. Account insights allow at most 30 days between since and until (Unix seconds) and go back 2 years. Pagination: pass 'after' from paging.cursors. Meta's error message is returned if a request is invalid.

List the account's posts and reels (newest first) with caption, type, publish time, permalink, likes and comments; optionally with each post's lifetime insights and an embedded thumbnail. Covers the whole history, not just two years. For a ranking within a period use get_instagram_top_media; stories are in list_instagram_stories.

Every lifetime metric Meta has for specific posts, reels or stories: views, reach, likes, comments, shares, saves, reposts, interactions, engagement rate; follows, profile visits and profile activity for feed posts; average and total watch time and skip rate for reels; replies and navigation for stories.

Rank the posts published in a period by a lifetime metric (views, reach, interactions, saves, shares, engagement rate, average watch time, …), with all their insights. Also returns how many posts were published in the period.

The account's current stories (published in the last 24 hours) with their insights: views, reach, replies, shares, interactions, follows, profile visits and navigation (taps forward/back, exits, swipes). Meta doesn't give access to expired stories.

Read comments (username, text, time, likes) on one post or across the latest posts, e.g. to summarise sentiment, find questions or content ideas. Needs the comments permission on the token (instagram_manage_comments or instagram_business_manage_comments).

Public posts by other accounts in which the connected account is tagged (newest first), with owner, caption, likes and comments: useful to track mentions, collaborations and UGC.

Public profile and recent posts of another Business or Creator account (followers, posts, bio, and per post likes, comments and reel views), for benchmarking against peers or vetting partners. Needs a unified login or Facebook Login token.

Everything about the account for a period in one stable JSON snapshot (schema_version 1): profile, performance totals vs the previous period (with content-type and follower splits), follower audience (gender, age, top 10 cities and countries), every post published in the period with its lifetime insights, and the best hours to post. Sections Instagram can't provide are null or empty and explained in unavailable; the call still succeeds. Shape: docs/report.md.