Instagram API Reels total_interactions: how it is calculated

Instagram's insights reference defines total_interactions as likes, saves, comments and shares minus unlikes and deletions, and marks it in development.

5 min readSume
All posts

Instagram's insights reference says total_interactions for a Reel is likes, saves, comments and shares, minus unlikes, unsaves and deleted comments. The page marks total_interactions, views and reels_skip_rate as in development, so their methods may change.

From the IG Media insights reference, read 2026-10-02.

The Reels metrics on the page

Definitions as the page words them.

Selected Reels metrics (read 2026-10-02)
MetricDefinition on the page
viewsTotal number of times the IG Media has been played on Instagram
reachUnique users who viewed the Reel at least once
sharesNumber of shares of the Reel
repostsReposts minus deleted reposts
ig_reels_avg_watch_timeAverage viewing duration per Reel
reels_skip_ratePercentage of viewers who skipped within the first 3 seconds
total_interactionsLikes, saves, comments and shares, minus unlikes, unsaves and deleted comments

What the changelog adds

The April 22, 2026 changelog entry lists reposts_count, saved_count and shares_count, plus aggregated total_like_count, total_comments_count and total_views_count. The insights page says the total_likes, total_comments and total_views style metrics include promoted content and are for Facebook Login only. Field names differ between the two pages, so test a real call before you hard-code a column.

A reporting habit that survives changes

Three habits.

  • Store the metric name and the date you pulled it. A definition marked in development can move.
  • Do not add total_interactions and its parts together. It already contains them.
  • Report views and total_interactions side by side, not one as a stand-in for the other.

Where Sume fits

Sume's docs do not list an Instagram insights reader, so pull these numbers from Instagram itself. Where Sume helps is the file side: if you make several cuts of one Reel with video trim, record the job id and your Idempotency-Key next to each published media id. Later you can tie a cut to its numbers.

Sources

Related posts

More in Developers

All Developers posts

Written by Sume