Log inStart Free Trial
easyCoexistence Official APIs

Instagram API deprecated metrics: impressions and plays replaced by views

Meta replaced impressions with views in Instagram's insights API. It introduced views on 21 January 2025 and deprecated impressions, plays, clips_replays_count and ig_reels_aggregated_all_plays_count in every API version on 21 April 2025, after video_views and six account metrics had ended on 8 January. Later changes added metrics, such as reposts and reels_skip_rate in December 2025.

easyCoexistence reads Instagram insights with get_social_insights, which passes the metric names you give straight to Meta, views included, and returns Meta's data, or Meta's own error message when a name is retired, so Claude, ChatGPT or your own code can follow a rename the day Meta makes it.

21 Apr 2025

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

21 Jan 2025

When Meta introduced views for account and media insights, and opened insights to Instagram Login apps.

8 Jan 2025

When video_views and six account time series, profile_views and website_clicks among them, lost support in every version.

2 Jul 2024

Media created on or after this date returns an error, not data, when impressions is requested after 21 April 2025.

total_value

The only metric_type the account-level views metric takes; impressions also offered a daily time_series.

Which Instagram metrics did Meta retire in 2025?

Two rounds, each announced months ahead in Meta's changelog and applied first from a new Graph API version, then to every version:

  • 8 January 2025: video_views on media, and the account time series email_contacts, get_direction_clicks, phone_call_clicks, profile_views, text_message_clicks and website_clicks, first dropped in v21.0.
  • 21 January 2025: impressions on account and media insights, and plays, clips_replays_count and ig_reels_aggregated_all_plays_count on media, deprecated for v22.0 and later, the day views arrived.
  • 21 April 2025: those four deprecated in every API version.

What should each retired metric become?

Meta paired views with the April 2025 retirements in the same changelog entry. For the January ones it named no successor, so the right-hand column gives the closest metric its account and media references documented as of 31 October 2026.

RetiredRequest instead
impressionsAccount and media, 21 Apr 2025views
playsMedia, 21 Apr 2025views
clips_replays_countMedia, 21 Apr 2025views
ig_reels_aggregated_all_plays_countMedia, 21 Apr 2025views
video_viewsMedia, 8 Jan 2025views
phone_call_clicks, email_contacts, text_message_clicks, get_direction_clicksAccount, 8 Jan 2025profile_links_taps, by contact_button_type
profile_viewsAccount, 8 Jan 2025profile_visits, per post or Story
website_clicksAccount, 8 Jan 2025profile_activity per post, whose action_type includes BIO_LINK_CLICKED

Does impressions still return anything?

Only for older media. Meta's changelog says that requests made after 21 April 2025 for media created on or after 2 July 2024 return an error, and its media insights reference keeps impressions only for media created before that date. On the account, impressions is deprecated in every version, so code written today has no use for it.

What does views count?

On the account, the number of times the content was played or displayed, across Reels, posts and Stories; on a single post, Reel or Story, the number of times it was played on Instagram. impressions counted the times content was on screen, ads included, so a chart that runs from one into the other changes what it measures at the switch. Account-level views takes metric_type=total_value only and breaks down by media_product_type, and Meta still labels it in development.

Which metrics has Meta added since?

Meta's changelog lists these additions after the 2025 retirements:

  • 3 December 2025: reels_skip_rate and reposts on media, reposts on the account, and crossposted_views and facebook_views for crossposted Reels.
  • 22 April 2026: total_likes, total_comments and total_views, aggregated across surfaces and including promoted media, which Meta's reference offers with Facebook Login only; facebook_views also extended to posts and Stories.
  • 22 June 2026: link_clicks on Stories, counting taps on links such as link stickers, which the changelog limits to Facebook Login.

What has to change in code?

A metric list written before 2025 needs these changes to keep working:

  • Swap impressions, plays, clips_replays_count, ig_reels_aggregated_all_plays_count and video_views for views, in account and media requests alike.
  • Request account-level views with metric_type=total_value. It has no time_series, so read one total per range where impressions used to give a daily line.
  • Ask for crossposted_views and facebook_views only on crossposted media, in a request of their own: Meta's reference says both throw when the media was not crossposted.
  • Leave total_likes, total_comments and total_views out of Instagram Login apps, since Meta offers them with Facebook Login only.
  • Replace phone_call_clicks, email_contacts, text_message_clicks and get_direction_clicks with profile_links_taps broken down by contact_button_type.
  • Treat an error on a metric name as a cue to update the list, not to retry.

How do deprecations reach older API versions?

In two steps. A change applies first from a new Graph API version, v21.0 for video_views and v22.0 for impressions, and then reaches every version on a date given in the same changelog entry, about three months later in both cases. Pinning an older version buys a few months at most, and Meta's Instagram Platform changelog lists both dates for each change.

Which earlier retirements still catch old code?

Two from before 2025 turn up in code that has not been touched since:

  • 11 December 2023: the carousel_album metrics, taps_forward, taps_back, exits and engagement on media, and audience_gender_age, audience_locale, audience_country and audience_city on the account, where follower_demographics now covers age, city, country and gender.
  • 19 August 2024: the last_14_days, last_30_days, last_90_days and prev_month timeframes for engaged_audience_demographics and reached_audience_demographics; this_week and this_month remain.

Common mistakes

  • Requesting impressions for a post published since July 2024. Meta returns an error for that media; ask for views.
  • Asking for account views as a time_series. Meta documents it with total_value only, so read a total for each range you need.
  • Requesting crossposted_views or facebook_views for media that was never crossposted. Meta's reference says both throw in that case.
  • Expecting total_likes, total_comments or total_views with Instagram Login. Meta makes them available with Facebook Login only; likes, comments and views remain.
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 phone_call_clicks and email_contacts in the Instagram API?

Meta named no direct successor when they ended in every version on 8 January 2025. The closest metric its account reference documents today is profile_links_taps, broken down by contact_button_type.

What replaced plays on Instagram Reels?

views. Meta deprecated plays, clips_replays_count and ig_reels_aggregated_all_plays_count in every API version on 21 April 2025, three months after introducing views.

Why did my Instagram insights call start failing?

Check the metric list first: impressions, plays, video_views and the old profile metrics are retired, and account views takes total_value only. Retrying the same request returns the same error.

Did Meta retire any Instagram metrics in 2026?

None appear in Meta's Instagram changelog through 28 October 2026. Its 2026 entries add metrics instead, among them total_views, a wider facebook_views and link_clicks on Stories.

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