Log inStart Free Trial
easyCoexistence Official APIs

Instagram insights through the API: account and post metrics

Instagram's API returns insights for a professional account and for each of its posts, Reels and Stories. Account metrics include reach, views, accounts engaged, follows and unfollows, likes, comments, saves and shares; post metrics include reach, views, likes, comments, saves and shares. Meta notes the data can lag by up to 48 hours.

easyCoexistence reads Instagram insights with get_social_insights, so you can ask Claude or ChatGPT how last week's posts did and get reach, views, likes, comments, saves and shares straight from Meta, for the account or for a single post.

48 hours

How long the data behind Instagram metrics can be delayed.

100 followers

Below this, follows and unfollows and follower demographics are not returned for the account.

2 years

How long Meta stores media metrics.

24 hours

How long Story metrics remain available through the API.

21 Apr 2025

When impressions stopped working in every API version, except on media created before 2 July 2024; views replaced it.

Which account metrics are available?

Read with GET /<IG_ID>/insights, mostly with period=day and metric_type=total_value:

  • reach: unique accounts that saw the content, ads included; estimated.
  • views: times the content was played or displayed.
  • accounts_engaged: accounts that interacted with the content, ads included; estimated.
  • follows_and_unfollows: follows and unfollows in the period; needs at least 100 followers.
  • likes, comments, saves, shares, replies and reposts, plus total_interactions.
  • profile_links_taps: taps on the business address, call, email and text buttons.
  • follower_demographics and engaged_audience_demographics: age, city, country and gender.

Which post metrics are available?

Read with GET /<IG_MEDIA_ID>/insights; which metrics apply depends on the format. On a post or Reel, likes, comments, views and total interactions count organic activity only, not engagement on ads made from it.

  • Posts and Reels: reach, views, likes, comments, saved, shares, total_interactions and reposts.
  • Reels only: ig_reels_avg_watch_time, ig_reels_video_view_total_time and reels_skip_rate.
  • Posts and Stories: follows, profile_visits and profile_activity.
  • Stories: reach, views, shares, replies, navigation, reposts and total_interactions.

How do period, metric_type and breakdowns work?

Account metrics take period=day. metric_type=total_value returns one figure for the range and is what breakdowns need; time_series returns a value per day and is available for reach. Breakdowns split a total by media_product_type (posts, carousels, Reels, Stories and ads), by follow_type (followers or not) or by contact_button_type.

Demographic metrics take a timeframe such as this_week or this_month instead of since and until, and without since and until the other metrics look back 24 hours. Asking for a breakdown that one of the requested metrics does not support fails the whole request with an unknown error.

What thresholds and delays apply?

Meta's rules for when a number appears and how long it stays available:

  • Data can be delayed by up to 48 hours.
  • Accounts under 100 followers get no follows_and_unfollows or follower_demographics; engaged_audience_demographics needs 100 engagements in the timeframe.
  • Missing or unavailable data comes back as an empty set, not as 0.
  • Demographic metrics return the top 45 values only.
  • Account metrics are stored for up to 90 days, media metrics for up to 2 years.

What is different for Stories and carousels?

Story metrics are available for 24 hours only, and a value under 5 returns error code 10, not enough viewers, instead of a number. Replies from people in Europe and Japan are left out, and a Story created by an account there reports 0 replies. With Instagram Login there is no story_insights webhook, so Story numbers have to be read while the Story is up.

A carousel reports as one post: Meta returns no insights for the photos and videos inside it.

Why do metric names change?

Because Meta retires and renames metrics between API versions. impressions was deprecated for v22.0 and stopped working in every version on 21 April 2025, except on media created before 2 July 2024, with views introduced in its place, and plays, clips_replays_count and ig_reels_aggregated_all_plays_count went at the same time. video_views and several profile time series, profile_views among them, were dropped earlier. A request with a retired name fails, so a metric list written for an earlier API version can need updating.

Common mistakes

  • Requesting impressions. It no longer works in any API version; ask for views instead.
  • Treating an empty result as zero. Meta returns an empty data set when a metric is unavailable, which is not the same as no activity.
  • Reading Story metrics after the Story ends. They are only available for 24 hours.
  • Adding a breakdown to a request for several metrics. If one of them does not support it, the whole call fails.
Doing this with EasyCoexistence

US$ 9 to US$ 0.75 per connection per month, falling as you add connections, with the first 3 days free.

easyCoexistence is a multichannel API and MCP server that connects AI agents such as Claude and ChatGPT to WhatsApp, Instagram, TikTok, Facebook and more. On WhatsApp it uses Coexistence: the business keeps using its number in the WhatsApp Business app while the AI works through Meta's official API.

Frequently asked questions

What replaced impressions in the Instagram API?

views, which counts the times content was played or displayed. Meta retired impressions in every API version on 21 April 2025, except on media created before 2 July 2024.

Why does my account return no follower data?

Meta does not return follows_and_unfollows or follower demographics for accounts with fewer than 100 followers.

How far back can I read Instagram insights?

Up to 90 days of account metrics and up to 2 years of media metrics, with online_followers covering only the last 30 days.

Do the numbers include ads?

Partly. An account's reach and accounts engaged include ads, while a post's likes, comments and views count organic activity only.

Keep reading

Connect your first channel in two minutes.

No platform reviews to wait for. Connect WhatsApp, Instagram, TikTok or another channel, then ask your AI to post, reply or report, and watch it work.

  • 3 days free
  • Cancel any time
  • Official APIs only
  • Monitored 24/7

Verified on