Facebook Reels en video-insights via de API
Facebook video- en Reels-insights komen van GET /{video-id}/video_insights: total_video_views telt afspelingen van minstens 3 seconden, total_video_avg_time_watched en total_video_view_total_time geven de kijktijd in milliseconden, en Reels voegen blue_reels_play_count, fb_reels_total_plays en fb_reels_replay_count toe. Meta heeft in juni 2026 voor alle API-versies de video-impressiemetrics en de metrics voor unieke kijkers uitgefaseerd, zoals total_video_impressions.
easyCoexistence leest Facebook Page- en postinsights met get_social_insights vanuit Claude, ChatGPT of je eigen code, zodat je AI kan vertellen hoe het met de Page en haar posts gaat; de eigen video_insights van een video of Reel lees je in Meta Business Suite.
De kortste afspeling die total_video_views telt, of bijna de volledige lengte bij video's die korter zijn.
Toen Meta total_video_impressions, total_video_views_unique en post_video_views_unique voor alle API-versies uitfaseerde.
Hoe ver terug videoinsights-gegevens beschikbaar zijn.
Hoe total_video_retention_graph een video verdeelt, en per punt de afspelingen rapporteert als percentage van alle weergaven.
Afspelen dat als Reels-afspeling telt in blue_reels_play_count, waarbij herhalingen niet meetellen.
Interacties op Reels zijn niet opgenomen in Page-metrics, een van de beperkingen in de insights-referentie van Meta.
Welke metrics geeft video_insights terug voor een video?
Deze videometrics staan in de referentie van Meta en vallen vanaf november 2026 niet onder de uitfaselijsten. Het zijn allemaal totalen over de levensduur, opgevraagd op het ID van de video. Weergaven laten de tijd buiten beschouwing die binnen één afspeling wordt herhaald, en verschillende metrics bestaan in een organische en een betaalde versie, zoals total_video_views_organic en total_video_views_paid:
Welke metrics gelden voor Reels?
De referentie van Meta heeft een Reels-sectie, uit te lezen op het video-ID van de Reel, met totalen over de levensduur:
blue_reels_play_count: afspelingen van 1 milliseconde of meer nadat een impressie is geteld, zonder herhalingen.fb_reels_total_plays: dezelfde afspelingen met herhalingen erbij;fb_reels_replay_count: alleen herhalingen binnen dezelfde sessie.post_video_avg_time_watchedenpost_video_view_time: gemiddelde en totale milliseconden afgespeeld, met herhalingen erbij.post_video_followers: nieuwe volgers via de Reel.post_video_likes_by_reaction_type: likes op de Reel.post_video_social_actions: de reacties en gedeelde keren.post_video_retention_graph: afspelingen op punten door de Reel, als percentage van het totaal aan afspelingen.
Welke videometrics heeft Meta in 2026 uitgefaseerd?
De Graph API v25-aankondiging van Meta heeft in juni 2026 twee groepen uitgefaseerd voor alle API-versies. Voor het alternatief verwijst Meta naar de Media Views- en Media Viewers-metrics: post_total_media_view_unique en page_total_media_view_unique voor unieke kijkers, en post_media_view en page_media_view voor de betaalde en organische splitsing.
- Video-impressies:
total_video_impressionsmet zijn unieke, betaalde, organische, virale en fan-varianten, enpost_impressions_uniqueop een video. - Kijkers na 3 seconden:
total_video_views_uniqueen zijn organische en betaalde versies,post_video_views_uniqueen zijn organische en betaalde versies, enpage_video_views_unique.
Zijn post_video_views en page_video_views nog geldig?
Ja. Beide staan zonder uitfasemarkering in de insights-referentie van Meta. post_video_views telt de afspelingen van minstens 3 seconden van een videopost, per levensduur of per dag, en page_video_views telt die van de Page, per dag, week of days_28. Hun unieke versies, post_video_views_unique en page_video_views_unique, zijn in juni 2026 voor alle API-versies uitgefaseerd, en de 10-seconden-metrics, zoals post_video_views_10s, boven v18.
Hoe worden videoinsights opgevraagd?
Op drie objecten, elk met eigen metrics. GET /{video-id}/video_insights met metric als kommagescheiden lijst leest een video of een Reel, en zonder metric geeft het de totalen van de video terug. Videometrics op postniveau, zoals post_video_views, lees je met GET /{page-post-id}/insights, en die op Page-niveau, zoals page_video_views, met GET /{page-id}/insights en een period.
GET /{video-id}/video_insights?metric=total_video_views,total_video_avg_time_watched,total_video_retention_graphWelke machtigingen en taak zijn nodig?
Een Page-token van iemand die de ANALYZE-taak op de Page mag uitvoeren. De video_insights-referentie van Meta noemt read_insights en pages_manage_engagement, terwijl de videoinsights-gids pages_read_engagement noemt. De data loopt over de afgelopen 2 jaar. Insights voor video's op gebruikersaccounts of groepen zijn niet beschikbaar, en een video die naar meerdere Pages is gedeeld heeft op elke Page een eigen video-ID.
Bevatten Page-metrics ook Reels?
Nee. De insights-referentie van Meta vermeldt bij de beperkingen voor het lezen van Page-metrics dat interacties op Reels niet zijn opgenomen. De afspelingen, nieuwe volgers, reacties en gedeelde keren van een Reel lees je op de Reel zelf, via video_insights met zijn video-ID.
Hoe leest easyCoexistence ze uit?
get_social_insights leest de insights-edge van de Page of van één post: metrics, een period, en object_id voor een post, met extra parameters zoals since en until die worden doorgegeven. video_insights is een eigen edge, die geen enkele tool leest, dus de eigen metrics van een video of Reel lees je in Meta Business Suite. Een uitgefaseerde metric komt terug als fout van Meta, zodat je AI de naam kan wisselen.
Veelgemaakte fouten
- total_video_impressions opvragen. Meta heeft de video-impressiemetrics in juni 2026 uitgefaseerd; vraag in plaats daarvan de Media Views-metrics op, zoals post_media_view.
- Retentiegrafiekwaarden optellen. Het zijn percentages van de weergaven per interval, geen aantallen afspelingen.
- Reels zoeken in Page-totalen. De Page-insights van Meta laten interacties op Reels weg, dus lees de video_insights van elke Reel zelf.
- Kijktijd lezen als seconden. total_video_avg_time_watched, total_video_view_total_time en post_video_view_time staan in milliseconden.
Van 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
Wat verving total_video_views_unique?
Meta verwijst naar zijn Media Viewers-metrics: post_total_media_view_unique op de post, en page_total_media_view_unique voor de Page.
Hoe haal ik de afspelingen van een Reel op via de API?
Lees blue_reels_play_count, of fb_reels_total_plays om herhalingen mee te tellen, via GET /{video-id}/video_insights met het video-ID dat de startaanroep van de Reel teruggaf.
Werkt post_impressions_unique nog voor Reels?
Nee. De Reels-tabel van Meta vermeldt het nog, maar de v25-aankondiging heeft het in juni 2026 op video_insights uitgefaseerd. post_total_media_view_unique telt unieke kijkers op de post.
Welke video's hebben geen insights?
Video's die op gebruikersaccounts of in groepen zijn gepubliceerd. De video-insights van Meta dekken video's op Pages, met data van de afgelopen 2 jaar.
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