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.
Window reels_skip_rate measures: the share of views that skipped the Reel within its first 3 seconds.
When plays, clips_replays_count and ig_reels_aggregated_all_plays_count were deprecated in every API version.
When reels_skip_rate, reposts, crossposted_views and facebook_views were added to media insights.
How long the data behind media metrics can be delayed.
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:
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.
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:
| Retired | Request instead | |
|---|---|---|
| plays | Deprecated in every version on 21 Apr 2025 | views |
| clips_replays_count | Deprecated in every version on 21 Apr 2025 | views |
| ig_reels_aggregated_all_plays_count | Deprecated in every version on 21 Apr 2025 | views |
| video_views | Deprecated in every version on 8 Jan 2025 | views |
| impressions | Not in Meta's Reels list; returns an error for media created on or after 2 Jul 2024 | views |
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_viewsandfacebook_viewsthrow 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_basicandinstagram_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.
{
"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.
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