InloggenGratis proefperiode starten
easyCoexistence Officiële API's

Verouderde Instagram API-metrics: impressions en plays vervangen door views

Meta verving impressions door views in de insights-API van Instagram. Views werd op 21 januari 2025 ingevoerd, en impressions, plays, clips_replays_count en ig_reels_aggregated_all_plays_count werden op 21 april 2025 in elke API-versie uitgefaseerd, nadat video_views en zes accountmetrics op 8 januari waren gestopt. Latere wijzigingen voegden metrics toe, zoals reposts en reels_skip_rate in december 2025.

easyCoexistence leest Instagram-insights met get_social_insights, dat de metricnamen die je geeft rechtstreeks aan Meta doorgeeft, views inbegrepen, en Meta's eigen data teruggeeft, of Meta's eigen foutmelding wanneer een naam is uitgefaseerd, zodat Claude, ChatGPT of je eigen code een hernoeming volgt op de dag dat Meta die doorvoert.

21 Apr 2025

Wanneer impressions, plays, clips_replays_count en ig_reels_aggregated_all_plays_count in elke API-versie werden uitgefaseerd.

21 Jan 2025

Wanneer Meta views voor account- en mediainsights invoerde, en insights openstelde voor apps met Instagram Login.

8 Jan 2025

Wanneer video_views en zes accounttijdreeksen, waaronder profile_views en website_clicks, in elke versie hun ondersteuning verloren.

2 Jul 2024

Media die op of na deze datum is aangemaakt, geeft een fout in plaats van data terug wanneer impressions na 21 april 2025 wordt aangevraagd.

total_value

De enige metric_type die de accountbrede views-metric accepteert; impressions bood ook een dagelijkse time_series aan.

Welke Instagram-metrics heeft Meta in 2025 uitgefaseerd?

Twee rondes, elk maanden van tevoren aangekondigd in Meta's changelog en eerst toegepast vanaf een nieuwe Graph API-versie, daarna in elke versie:

  • 8 januari 2025: video_views op media en de accounttijdreeksen email_contacts, get_direction_clicks, phone_call_clicks, profile_views, text_message_clicks en website_clicks, eerst weggehaald uit v21.0.
  • 21 januari 2025: impressions op account- en mediainsights, en plays, clips_replays_count en ig_reels_aggregated_all_plays_count op media, uitgefaseerd voor v22.0 en later, op de dag dat views verscheen.
  • 21 april 2025: die vier uitgefaseerd in elke API-versie.

Wat moet elke uitgefaseerde metric worden?

Meta koppelde views aan de uitfaseringen van april 2025 in hetzelfde changelog-item. Voor de januari-metrics noemde het geen opvolger, dus de rechterkolom geeft de dichtstbijzijnde metric die de account- en mediareferenties per 31 oktober 2026 documenteerden.

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

Levert impressions nog iets op?

Alleen voor oudere media. Meta's changelog zegt dat verzoeken na 21 april 2025 voor media die op of na 2 juli 2024 zijn aangemaakt een fout teruggeven, en de referentie voor mediainsights houdt impressions alleen voor media van voor die datum. Op het account is impressions in elke versie uitgefaseerd, dus code die je vandaag schrijft heeft er geen zin aan.

Wat telt views?

Op het account het aantal keren dat de content is afgespeeld of getoond, over Reels, posts en Stories heen; op één post, Reel of Story het aantal keren dat het op Instagram is afgespeeld. impressions telde de keren dat content in beeld was, advertenties inbegrepen, dus een grafiek die van de ene naar de andere loopt, verandert bij de overstap wat hij meet. Accountbrede views accepteert alleen metric_type=total_value en splitst op media_product_type, en Meta labelt het nog als in ontwikkeling.

Welke metrics heeft Meta sindsdien toegevoegd?

De changelog van Meta somt deze toevoegingen op na de uitfaseringen van 2025:

  • 3 december 2025: reels_skip_rate en reposts op media, reposts op het account, en crossposted_views en facebook_views voor gecrosspost Reels.
  • 22 april 2026: total_likes, total_comments en total_views, geaggregeerd over alle oppervlakken en inclusief gesponsorde media, die Meta's referentie alleen met Facebook Login aanbiedt; facebook_views ook uitgebreid naar posts en Stories.
  • 22 juni 2026: link_clicks op Stories, die tikken op links telt, zoals linkstickers, wat de changelog beperkt tot Facebook Login.

Wat moet er in de code veranderen?

Een metriclijst die vóór 2025 is geschreven, heeft deze wijzigingen nodig om te blijven werken:

  • Vervang impressions, plays, clips_replays_count, ig_reels_aggregated_all_plays_count en video_views door views, in verzoeken voor account en media gelijk.
  • Vraag accountbrede views aan met metric_type=total_value. Het heeft geen time_series, dus lees één totaal per periode waar impressions vroeger een dagelijkse lijn gaf.
  • Vraag crossposted_views en facebook_views alleen op gecrosspost media, in een eigen verzoek: Meta's referentie zegt dat beide een fout geven wanneer het media niet gecrosspost was.
  • Laat total_likes, total_comments en total_views weg uit apps met Instagram Login, want Meta biedt ze alleen aan met Facebook Login.
  • Vervang phone_call_clicks, email_contacts, text_message_clicks en get_direction_clicks door profile_links_taps, uitgesplitst op contact_button_type.
  • Behandel een fout op een metricnaam als een signaal om de lijst bij te werken, niet om opnieuw te proberen.

Hoe bereiken uitfaseringen oudere API-versies?

In twee stappen. Een wijziging geldt eerst vanaf een nieuwe Graph API-versie, v21.0 voor video_views en v22.0 voor impressions, en bereikt daarna elke versie op een datum die in hetzelfde changelog-item staat, in beide gevallen ongeveer drie maanden later. Vastzetten op een oudere versie koopt hooguit een paar maanden, en Meta's Instagram Platform-changelog vermeldt voor elke wijziging beide data.

Welke eerdere uitfaseringen raken nog oude code?

Twee van vóór 2025 duiken op in code die sinds niemand meer heeft aangeraakt:

  • 11 december 2023: de carousel_album-metrics, taps_forward, taps_back, exits en engagement op media, en audience_gender_age, audience_locale, audience_country en audience_city op het account, waar follower_demographics nu leeftijd, stad, land en geslacht dekt.
  • 19 augustus 2024: de tijdsbereiken last_14_days, last_30_days, last_90_days en prev_month voor engaged_audience_demographics en reached_audience_demographics; this_week en this_month blijven.

Veelgemaakte fouten

  • Impressions aanvragen voor een post die sinds juli 2024 is geplaatst. Meta geeft voor die media een fout terug; vraag views aan.
  • Accountviews als time_series opvragen. Meta documenteert het alleen met total_value, dus lees een totaal per periode die je nodig hebt.
  • crossposted_views of facebook_views aanvragen voor media die nooit gecrosspost is. Meta's referentie zegt dat beide in dat geval een fout geven.
  • total_likes, total_comments of total_views verwachten bij Instagram Login. Meta maakt ze alleen beschikbaar met Facebook Login; likes, comments en views blijven.
Dit doen met EasyCoexistence

US$ 9 tot US$ 0,75 per verbinding per maand, dalend naarmate je verbindingen toevoegt, met een gratis proefperiode van 3 dagen.

Veelgestelde vragen

Wat verving phone_call_clicks en email_contacts in de Instagram API?

Meta noemde geen directe opvolger toen ze op 8 januari 2025 in elke versie stopten. De dichtstbijzijnde metric die zijn accountreferentie nu documenteert is profile_links_taps, uitgesplitst op contact_button_type.

Wat verving plays op Instagram Reels?

views. Meta faseerde plays, clips_replays_count en ig_reels_aggregated_all_plays_count in elke API-versie uit op 21 april 2025, drie maanden nadat views was ingevoerd.

Waarom begon mijn Instagram insights-aanroep te falen?

Controleer eerst de metriclijst: impressions, plays, video_views en de oude profielmetrics zijn uitgefaseerd, en accountviews accepteert alleen total_value. Hetzelfde verzoek opnieuw proberen geeft dezelfde fout.

Heeft Meta in 2026 Instagram-metrics uitgefaseerd?

Geen enkele verschijnt in Meta's Instagram-changelog tot en met 28 oktober 2026. De items van 2026 voegen daar juist metrics aan toe, waaronder total_views, een bredere facebook_views en link_clicks op Stories.

Lees verder

Koppel je eerste kanaal in twee minuten.

Geen platformbeoordelingen om op te wachten. Verbind WhatsApp, Instagram, TikTok of een ander kanaal, vraag je AI om te posten, te reageren of een rapport te maken, en zie het aan het werk.

  • 3 dagen gratis
  • Op elk moment opzegbaar
  • Alleen officiële API's
  • 24/7 bewaakt

Geverifieerd op