AnmeldenKostenlose Testphase starten
easyCoexistence Offizielle APIs

Facebook-Reels und Video-Insights über die API

Facebook-Video- und Reels-Insights stammen von GET /{video-id}/video_insights: total_video_views zählt Wiedergaben von mindestens 3 Sekunden, total_video_avg_time_watched und total_video_view_total_time geben die Sehdauer in Millisekunden an, und Reels liefern zusätzlich blue_reels_play_count, fb_reels_total_plays und fb_reels_replay_count. Meta hat die Metriken für Video-Impressions und eindeutige Zuschauer, etwa total_video_impressions, im Juni 2026 für alle API-Versionen abgekündigt.

easyCoexistence liest Facebook-Page- und Beitrags-Insights mit get_social_insights aus Claude, ChatGPT oder Ihrem eigenen Code, damit Ihre KI Ihnen sagen kann, wie die Page und ihre Beiträge laufen; die eigenen video_insights eines Videos oder Reels werden in Meta Business Suite gelesen.

3 seconds

Die kürzeste Wiedergabe, ab der total_video_views zählt, bzw. nahezu die volle Länge bei Videos, die kürzer sind.

June 2026

Wann Meta total_video_impressions, total_video_views_unique und post_video_views_unique für alle API-Versionen abgekündigt hat.

2 years

Wie weit die Daten zu Video-Insights zurückreichen.

40 intervals

Wie total_video_retention_graph ein Video aufteilt und an jedem Punkt die Wiedergaben als Prozentsatz aller Aufrufe ausweist.

1 ms

Welche Wiedergabe in blue_reels_play_count als Reels-Wiedergabe zählt; Wiederholungen bleiben außen vor.

Reels left out

Interaktionen mit Reels sind nicht in den Page-Metriken enthalten, zu den Einschränkungen in Metas Insights-Referenz.

Welche Metriken liefert video_insights für ein Video?

Diese Video-Metriken stehen in Metas Referenz und sind laut Stand November 2026 nicht in den Abkündigungslisten enthalten; alle sind Lebenszeit-Summen, abgerufen über die ID des Videos. Aufrufe berücksichtigen Zeit für Wiederholungen innerhalb einer Wiedergabe nicht, und mehrere haben organische und bezahlte Varianten, etwa total_video_views_organic und total_video_views_paid:

total_video_viewsPlays of at least 3 seconds, or nearly the full length if shorter
total_video_complete_viewsPlays of 97% or more of the length
total_video_15s_viewsPlays of 15 seconds or more
total_video_60s_excludes_shorter_viewsPlays of 60 seconds or more
total_video_avg_time_watchedAverage viewing time, in milliseconds
total_video_view_total_timeTotal viewing time, in milliseconds
total_video_retention_graphPlays at each of 40 intervals, as a percentage of views
total_video_reactions_by_type_totalReactions to the video, by type

Welche Metriken betreffen Reels?

Metas Referenz hat einen Reels-Abschnitt, der über die Video-ID des Reels mit Lebenszeitwerten abgerufen wird:

  • blue_reels_play_count: Wiedergaben von 1 Millisekunde oder mehr, nachdem eine Impression gezählt wurde; Wiederholungen bleiben außen vor.
  • fb_reels_total_plays: dieselben Wiedergaben mit Wiederholungen; fb_reels_replay_count: nur Wiederholungen in derselben Sitzung.
  • post_video_avg_time_watched und post_video_view_time: durchschnittliche und gesamte Wiedergabedauer in Millisekunden, inklusive Wiederholungen.
  • post_video_followers: neue Follower durch das Reel.
  • post_video_likes_by_reaction_type: Likes auf das Reel.
  • post_video_social_actions: dessen Kommentare und Shares.
  • post_video_retention_graph: Wiedergaben an Punkten im Reel als Prozentsatz aller Wiedergaben.

Welche Video-Metriken hat Meta 2026 abgekündigt?

Metas Ankündigung zu Graph API v25 hat im Juni 2026 zwei Gruppen für alle API-Versionen abgekündigt und verweist stattdessen auf die Media-Views- und Media-Viewers-Metriken: post_total_media_view_unique und page_total_media_view_unique für eindeutige Zuschauer sowie post_media_view und page_media_view für die Aufteilung nach bezahlt und organisch:

  • Video-Impressions: total_video_impressions mit seinen Varianten unique, paid, organic, viral und fan sowie post_impressions_unique bei einem Video.
  • 3-Sekunden-Zuschauer: total_video_views_unique und seine organischen und bezahlten Versionen, post_video_views_unique und seine organischen und bezahlten Versionen sowie page_video_views_unique.

Sind post_video_views und page_video_views noch gültig?

Ja. Beide bleiben ohne Abkündigungsvermerk in Metas Insights-Referenz: post_video_views zählt die Wiedergaben eines Video-Beitrags von mindestens 3 Sekunden, nach Lebenszeit oder Tag, und page_video_views die der Page, nach Tag, Woche oder days_28. Ihre eindeutigen Versionen, post_video_views_unique und page_video_views_unique, wurden im Juni 2026 für alle API-Versionen abgekündigt, und die 10-Sekunden-Metriken, etwa post_video_views_10s, ab v18.

Wie werden Video-Insights abgefragt?

Über drei Objekte, jedes mit eigenen Metriken. GET /{video-id}/video_insights mit metric als kommagetrennter Liste liest ein Video oder ein Reel, und ohne metric liefert es die Summen des Videos. Metriken auf Beitragsebene wie post_video_views werden mit GET /{page-post-id}/insights gelesen, solche auf Page-Ebene wie page_video_views mit GET /{page-id}/insights und einem period.

Reading a video's views and watch time
GET /{video-id}/video_insights?metric=total_video_views,total_video_avg_time_watched,total_video_retention_graph

Welche Berechtigungen und Aufgabe werden benötigt?

Ein Page-Token eines Nutzers, der die Aufgabe ANALYZE auf der Page ausführen darf. Metas Referenz zu video_insights nennt read_insights und pages_manage_engagement, während der Leitfaden zu Video-Insights pages_read_engagement nennt. Die Daten decken die letzten 2 Jahre ab; Insights für Videos auf Nutzer- oder Gruppenkonten sind nicht verfügbar, und ein crossgepostetes Video hat auf jeder Page, auf der es veröffentlicht wurde, eine eigene Video-ID.

Enthalten Metriken auf Page-Ebene Reels?

Nein. Metas Insights-Referenz nennt unter ihren Einschränkungen für das Auslesen von Page-Metriken, dass Interaktionen mit Reels nicht enthalten sind. Wiedergaben, Follower, Kommentare und Shares eines Reels werden direkt am Reel gelesen, über video_insights mit seiner Video-ID.

Wie liest easyCoexistence sie aus?

get_social_insights liest den insights-Edge der Page oder eines einzelnen Beitrags: Metriken, einen Zeitraum und object_id für einen Beitrag, wobei zusätzliche Parameter wie since und until durchgereicht werden. video_insights ist ein eigener Edge, den kein Tool liest, daher werden die eigenen Metriken eines Videos oder Reels in Meta Business Suite gelesen. Eine ausgemusterte Metrik kommt als Metas Fehler zurück, sodass Ihre KI den Namen wechseln kann.

Häufige Fehler

  • total_video_impressions anfordern. Meta hat die Video-Impression-Metriken im Juni 2026 abgekündigt; fordern Sie stattdessen Media-Views-Metriken an, etwa post_media_view.
  • Werte des Retention-Graphen summieren. Sie sind Prozentsätze der Aufrufe je Intervall, keine Anzahl von Wiedergaben.
  • Reels in den Page-Summen suchen. Metas Page-Insights lassen Interaktionen mit Reels aus, daher lesen Sie das video_insights jedes Reels selbst.
  • Wiedergabedauer in Sekunden lesen. total_video_avg_time_watched, total_video_view_total_time und post_video_view_time sind in Millisekunden angegeben.
Mit EasyCoexistence

Von US$ 9 bis US$ 0.75 pro Verbindung und Monat, sinkend mit jeder weiteren Verbindung, mit einer kostenlosen Testphase von 3 Tagen.

Häufig gestellte Fragen

Was hat total_video_views_unique ersetzt?

Meta verweist auf seine Media-Viewers-Metriken: post_total_media_view_unique am Beitrag und page_total_media_view_unique für die Page.

Wie rufe ich die Wiedergaben eines Reels über die API ab?

Lesen Sie blue_reels_play_count oder fb_reels_total_plays, um Wiederholungen einzuschließen, aus GET /{video-id}/video_insights mit der Video-ID, die der Startaufruf des Reels zurückgegeben hat.

Funktioniert post_impressions_unique noch für Reels?

Nein. Metas Reels-Tabelle führt es noch auf, doch die v25-Ankündigung hat es im Juni 2026 für video_insights abgekündigt; post_total_media_view_unique zählt eindeutige Zuschauer am Beitrag.

Für welche Videos gibt es keine Insights?

Für Videos, die auf Nutzer- oder Gruppenkonten veröffentlicht wurden. Metas Video-Insights decken Videos auf Pages ab, mit Daten für die letzten 2 Jahre.

Weiterlesen

Verbinden Sie Ihren ersten Kanal in zwei Minuten.

Keine Plattform-Prüfungen, auf die Sie warten müssen. Verbinden Sie WhatsApp, Instagram, TikTok oder einen anderen Kanal, bitten Sie dann Ihre KI, zu posten, zu antworten oder Berichte zu erstellen, und sehen Sie ihr bei der Arbeit zu.

  • 3 Tage kostenlos
  • Jederzeit kündbar
  • Nur offizielle APIs
  • Überwacht rund um die Uhr (24/7)

Verifiziert am