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.
When impressions, plays, clips_replays_count and ig_reels_aggregated_all_plays_count were deprecated in every API version.
When Meta introduced views for account and media insights, and opened insights to Instagram Login apps.
When video_views and six account time series, profile_views and website_clicks among them, lost support in every version.
Media created on or after this date returns an error, not data, when impressions is requested after 21 April 2025.
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_viewson media, and the account time seriesemail_contacts,get_direction_clicks,phone_call_clicks,profile_views,text_message_clicksandwebsite_clicks, first dropped in v21.0. - 21 January 2025: impressions on account and media insights, and plays,
clips_replays_countandig_reels_aggregated_all_plays_counton 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.
| Retired | Request instead | |
|---|---|---|
| impressions | Account and media, 21 Apr 2025 | views |
| plays | Media, 21 Apr 2025 | views |
| clips_replays_count | Media, 21 Apr 2025 | views |
| ig_reels_aggregated_all_plays_count | Media, 21 Apr 2025 | views |
| video_views | Media, 8 Jan 2025 | views |
| phone_call_clicks, email_contacts, text_message_clicks, get_direction_clicks | Account, 8 Jan 2025 | profile_links_taps, by contact_button_type |
| profile_views | Account, 8 Jan 2025 | profile_visits, per post or Story |
| website_clicks | Account, 8 Jan 2025 | profile_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_rateand reposts on media, reposts on the account, andcrossposted_viewsandfacebook_viewsfor crossposted Reels. - 22 April 2026:
total_likes,total_commentsandtotal_views, aggregated across surfaces and including promoted media, which Meta's reference offers with Facebook Login only;facebook_viewsalso extended to posts and Stories. - 22 June 2026:
link_clickson 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_countandvideo_viewsfor views, in account and media requests alike. - Request account-level views with
metric_type=total_value. It has notime_series, so read one total per range where impressions used to give a daily line. - Ask for
crossposted_viewsandfacebook_viewsonly 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_commentsandtotal_viewsout of Instagram Login apps, since Meta offers them with Facebook Login only. - Replace
phone_call_clicks,email_contacts,text_message_clicksandget_direction_clickswithprofile_links_tapsbroken down bycontact_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_albummetrics,taps_forward,taps_back, exits and engagement on media, andaudience_gender_age,audience_locale,audience_countryandaudience_cityon the account, wherefollower_demographicsnow covers age, city, country and gender. - 19 August 2024: the
last_14_days,last_30_days,last_90_daysandprev_monthtimeframes forengaged_audience_demographicsandreached_audience_demographics;this_weekandthis_monthremain.
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.
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