Log inStart Free Trial
easyCoexistence Official APIs

Instagram Reels insights through the API

Instagram's media insights endpoint, GET /<IG_MEDIA_ID>/insights, returns these metrics for a Reel: views, reach, likes, comments, shares, saved, reposts, total_interactions, ig_reels_avg_watch_time, ig_reels_video_view_total_time and reels_skip_rate, plus crossposted_views and facebook_views for a crossposted Reel. plays, clips_replays_count and ig_reels_aggregated_all_plays_count were retired in April 2025, with views in their place.

easyCoexistence's get_social_insights takes a Reel's media ID and metric names, calls Meta's insights endpoint as the connected Instagram account, and returns Meta's numbers or Meta's own error.

3 seconds

Window reels_skip_rate measures: the share of views that skipped the Reel within its first 3 seconds.

21 Apr 2025

When plays, clips_replays_count and ig_reels_aggregated_all_plays_count were deprecated in every API version.

3 Dec 2025

When reels_skip_rate, reposts, crossposted_views and facebook_views were added to media insights.

48 hours

How long the data behind media metrics can be delayed.

2 years

How long Meta stores media metrics.

Which metrics does a Reel return?

Those Meta's media insights reference lists for media_product_type REELS, read with GET /<IG_MEDIA_ID>/insights and a comma-separated metric parameter. Meta labels several of them estimated or in development, as noted beside each, and counts likes and comments as organic activity only:

viewsTimes the Reel was played on Instagram. In development.
reachUnique accounts that saw the Reel at least once. Estimated.
likesLikes on the Reel, organic only.
commentsComments on the Reel, organic only.
sharesTimes the Reel was shared.
savedTimes the Reel was saved.
repostsReposts, minus reposts later deleted.
total_interactionsLikes, saves, comments and shares, minus unlikes, unsaves and deleted comments. In development.
ig_reels_avg_watch_timeAverage time spent playing the Reel.
ig_reels_video_view_total_timeTotal time the Reel was played, replays included. In development.
reels_skip_rateShare of initial views that skipped within the first 3 seconds. Estimated, in development.
crossposted_viewsPlays across Instagram and where the Reel was crossposted, combined. Throws if it was not crossposted.
facebook_viewsPlays of the crossposted Reel outside Instagram. Throws if it was not crossposted.

What does a Reels insights request return?

One object per metric in data, each with name, period, values, title, description and id. period always reads lifetime: Meta sets it for media metrics and it cannot be changed, so the request needs none. Meta's reference describes the two watch-time metrics as amounts of time without naming a unit, so check them against a Reel you know before charting them.

A Reels insights request and the shape of its answer
GET https://graph.instagram.com/<IG_MEDIA_ID>/insights
  ?metric=views,reach,ig_reels_avg_watch_time,reels_skip_rate
  &access_token=<INSTAGRAM_USER_ACCESS_TOKEN>

{
  "data": [
    {
      "name": "views",
      "period": "lifetime",
      "values": [{ "value": <VALUE> }],
      "title": "<TITLE>",
      "description": "<DESCRIPTION>",
      "id": "<IG_MEDIA_ID>/insights/views/lifetime"
    }
  ]
}

Which Reels metrics were retired, and what replaced them?

Meta deprecated the first three from Graph API v22.0 on 21 January 2025, the day it introduced views, and in every version on 21 April 2025; video_views went from v21.0 and in every version on 8 January 2025. A request that names a retired metric fails, so a metric list written before 2025 needs updating:

RetiredRequest instead
playsDeprecated in every version on 21 Apr 2025views
clips_replays_countDeprecated in every version on 21 Apr 2025views
ig_reels_aggregated_all_plays_countDeprecated in every version on 21 Apr 2025views
video_viewsDeprecated in every version on 8 Jan 2025views
impressionsNot in Meta's Reels list; returns an error for media created on or after 2 Jul 2024views

What do views and reach count on a Reel?

views is the number of times the Reel was played on Instagram, a metric Meta labels in development; reach is the number of unique accounts that saw it at least once, which Meta labels estimated. likes, comments, views and total_interactions count organic activity only, leaving out engagement on ads made from the Reel. total_likes, total_comments and total_views, which include promoted media, are offered with Facebook Login only.

Which limits and delays apply?

Meta's media insights reference sets these rules for a Reel's numbers:

  • Data behind the metrics can be delayed by up to 48 hours.
  • Media metrics are stored for up to 2 years.
  • Missing or unavailable data returns an empty data set, not 0.
  • crossposted_views and facebook_views throw for a Reel that was not crossposted, so request them in a call of their own.
  • A breakdown that a requested metric does not support fails the whole request with An unknown error has occurred.
  • With Instagram Login the token needs instagram_business_basic and instagram_business_manage_insights, on graph.instagram.com.

How does get_social_insights read a Reel?

With the connection's account_id, the Reel's media ID as object_id and a list of metrics. easyCoexistence calls GET /<IG_MEDIA_ID>/insights on graph.instagram.com with the account's token, passes the metric names to Meta as given and returns Meta's data, or Meta's own error when a name is retired. list_social_posts returns the media IDs of the account's recent posts and Reels.

get_social_insights arguments for one Reel
{
  "account_id": "<ACCOUNT_ID>",
  "object_id": "<REEL_MEDIA_ID>",
  "metrics": [
    "views", "reach", "likes", "comments", "shares", "saved",
    "total_interactions", "ig_reels_avg_watch_time",
    "ig_reels_video_view_total_time", "reels_skip_rate"
  ]
}

Common mistakes

  • Requesting plays or clips_replays_count. Both were deprecated in every API version on 21 April 2025; ask for views.
  • Mixing crossposted_views or facebook_views into a general request. They throw for a Reel that was not crossposted, and the error fails the call.
  • Assuming a unit for watch time. Meta's reference names none for ig_reels_avg_watch_time or ig_reels_video_view_total_time, so check against a known Reel.
  • Reading an empty result as zero. Meta returns an empty data set when the data does not exist or is currently unavailable.
Doing this with EasyCoexistence

easyCoexistence reads a Reel's insights with get_social_insights, so Claude, ChatGPT or your own code can ask how a Reel did and get views, reach, watch time and skip rate straight from Meta for the connected account, with Meta's own error when a metric name is retired. 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

Why does a Reels insights request return an empty result?

Meta returns an empty data set, not 0, when the data does not exist or is currently unavailable, and the data behind the metrics can lag by up to 48 hours.

How do I get Reels watch time from the API?

Request ig_reels_avg_watch_time for the average and ig_reels_video_view_total_time for the total, replays included, from GET /<IG_MEDIA_ID>/insights.

What is reels_skip_rate?

The percentage of initial views that skipped the Reel within its first 3 seconds. Meta added it on 3 December 2025 and labels it estimated and in development.

Do Reels insights include ad views?

No. likes, comments, views and total_interactions count organic activity only; total_views, which includes promoted media, is offered with Facebook Login 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