InloggenGratis proefperiode starten
easyCoexistence Officiële API's

Instagram Reels-insights via de API

Het media-insights-endpoint van Instagram, GET /<IG_MEDIA_ID>/insights, geeft deze statistieken voor een Reel terug: views, reach, likes, comments, shares, saved, reposts, total_interactions, ig_reels_avg_watch_time, ig_reels_video_view_total_time en reels_skip_rate, plus crossposted_views en facebook_views voor een Reel die is gecrosspost. plays, clips_replays_count en ig_reels_aggregated_all_plays_count zijn in april 2025 vervallen, met views als vervanging.

easyCoexistence leest de insights van een Reel met get_social_insights, zodat Claude, ChatGPT of je eigen code kan vragen hoe een Reel het deed en views, reach, kijktijd en skip rate rechtstreeks van Meta krijgt voor het verbonden account, met de eigen fout van Meta wanneer een metricnaam is vervallen.

3 seconds

Het tijdvenster dat reels_skip_rate meet: het aandeel views dat de Reel binnen de eerste 3 seconden oversloeg.

21 Apr 2025

Wanneer plays, clips_replays_count en ig_reels_aggregated_all_plays_count in elke API-versie zijn vervallen.

3 Dec 2025

Wanneer reels_skip_rate, reposts, crossposted_views en facebook_views aan de media-insights zijn toegevoegd.

48 hours

Hoe lang de gegevens achter mediastatistieken vertraagd kunnen zijn.

2 years

Hoe lang Meta mediastatistieken bewaart.

Welke statistieken geeft een Reel terug?

Die uit de referentie van Meta voor media-insights met media_product_type REELS, opgevraagd met GET /<IG_MEDIA_ID>/insights en een door komma's gescheiden metric-parameter. Meta markeert sommige als geschat of in ontwikkeling, dat staat bij elk vermeld, en telt likes en comments alleen als organische activiteit:

viewsTimes the Reel was played on Instagram. In development.
reachUnique accounts that saw the Reel at least once. Estimated.
likesLikes on the Reel, organic only.
commentsComments on the Reel, organic only.
sharesTimes the Reel was shared.
savedTimes the Reel was saved.
repostsReposts, minus reposts later deleted.
total_interactionsLikes, saves, comments and shares, minus unlikes, unsaves and deleted comments. In development.
ig_reels_avg_watch_timeAverage time spent playing the Reel.
ig_reels_video_view_total_timeTotal time the Reel was played, replays included. In development.
reels_skip_rateShare of initial views that skipped within the first 3 seconds. Estimated, in development.
crossposted_viewsPlays across Instagram and where the Reel was crossposted, combined. Throws if it was not crossposted.
facebook_viewsPlays of the crossposted Reel outside Instagram. Throws if it was not crossposted.

Wat geeft een Reels-insights-verzoek terug?

Één object per metric in data, elk met name, period, values, title, description en id. period staat altijd op lifetime: Meta stelt dat in voor mediastatistieken en het kan niet worden gewijzigd, dus het verzoek hoeft het niet mee te sturen. Meta's referentie beschrijft de twee kijktijdstatistieken als hoeveelheden tijd zonder een eenheid te noemen, dus controleer ze tegen een Reel die je kent voordat je ze in een grafiek zet.

A Reels insights request and the shape of its answer
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"
    }
  ]
}

Welke Reels-statistieken zijn vervallen, en wat kwam ervoor in de plaats?

Meta heeft de eerste drie vanaf Graph API v22.0 laten vervallen op 21 januari 2025, de dag waarop views werd ingevoerd, en in elke versie op 21 april 2025; video_views verviel vanaf v21.0 en in elke versie op 8 januari 2025. Een verzoek dat een vervallen metric noemt, mislukt, dus een metriclijst die vóór 2025 is geschreven moet worden bijgewerkt:

RetiredRequest instead
playsDeprecated in every version on 21 Apr 2025views
clips_replays_countDeprecated in every version on 21 Apr 2025views
ig_reels_aggregated_all_plays_countDeprecated in every version on 21 Apr 2025views
video_viewsDeprecated in every version on 8 Jan 2025views
impressionsNot in Meta's Reels list; returns an error for media created on or after 2 Jul 2024views

Wat tellen views en reach bij een Reel?

views is het aantal keren dat de Reel op Instagram is afgespeeld, een metric die Meta als in ontwikkeling markeert; reach is het aantal unieke accounts dat hem minstens één keer heeft gezien, wat Meta als geschat markeert. likes, comments, views en total_interactions tellen alleen organische activiteit en laten betrokkenheid bij advertenties die van de Reel zijn gemaakt weg. total_likes, total_comments en total_views, die gesponsorde media meerekenen, zijn alleen beschikbaar met Facebook Login.

Welke limieten en vertragingen gelden?

De mediainsights-referentie van Meta stelt deze regels voor de cijfers van een Reel:

  • Gegevens achter de metrics kunnen tot 48 uur vertraagd zijn.
  • Mediastatistieken worden tot 2 jaar bewaard.
  • Ontbrekende of niet beschikbare gegevens leveren een lege data-set op, niet 0.
  • crossposted_views en facebook_views geven een fout voor een Reel die niet is gecrosspost, dus vraag ze in een eigen aanroep op.
  • Een uitsplitsing die een gevraagde metric niet ondersteunt, laat het hele verzoek mislukken met de fout An unknown error has occurred.
  • Met Instagram Login heeft het token instagram_business_basic en instagram_business_manage_insights nodig, op graph.instagram.com.

Hoe leest get_social_insights een Reel?

Met de account_id van de verbinding, de media-ID van de Reel als object_id en een lijst met metrics. easyCoexistence roept GET /<IG_MEDIA_ID>/insights aan op graph.instagram.com met het token van het account, geeft de metricnamen ongewijzigd door aan Meta en geeft de data van Meta terug, of de eigen fout van Meta wanneer een naam is vervallen. list_social_posts geeft de media-ID's van de recente posts en Reels van het account terug.

get_social_insights arguments for one Reel
{
  "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"
  ]
}

Veelgemaakte fouten

  • plays of clips_replays_count opvragen. Beide zijn in elke API-versie vervallen op 21 april 2025; vraag views aan.
  • crossposted_views of facebook_views in een algemeen verzoek mengen. Ze geven een fout voor een Reel die niet is gecrosspost, en die fout laat de aanroep mislukken.
  • Aannemen dat kijktijd een eenheid heeft. Meta's referentie noemt er geen voor ig_reels_avg_watch_time of ig_reels_video_view_total_time, dus controleer tegen een bekende Reel.
  • Een leeg resultaat als nul lezen. Meta geeft een lege data-set terug wanneer de gegevens niet bestaan of op dit moment niet beschikbaar zijn.
Dit doen met EasyCoexistence

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

Veelgestelde vragen

Waarom geeft een Reels-insights-verzoek een leeg resultaat?

Meta geeft een lege data-set terug, niet 0, wanneer de gegevens niet bestaan of op dit moment niet beschikbaar zijn, en de gegevens achter de metrics kunnen tot 48 uur achterlopen.

Hoe haal ik de kijktijd van Reels uit de API?

Vraag ig_reels_avg_watch_time op voor het gemiddelde en ig_reels_video_view_total_time voor het totaal, inclusief herhalingen, via GET /<IG_MEDIA_ID>/insights.

Wat is reels_skip_rate?

Het percentage van de eerste views dat de Reel binnen de eerste 3 seconden heeft overgeslagen. Meta heeft het op 3 december 2025 toegevoegd en markeert het als geschat en in ontwikkeling.

Tellen advertentieviews mee in Reels-insights?

Nee. likes, comments, views en total_interactions tellen alleen organische activiteit; total_views, dat gesponsorde media meerekent, is alleen beschikbaar met Facebook Login.

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