AnmeldenKostenlose Testphase starten
easyCoexistence Offizielle APIs

Instagram-Reels-Insights über die API

Der Endpoint für Medien-Insights von Instagram, GET /<IG_MEDIA_ID>/insights, liefert für ein Reel diese Kennzahlen: views, reach, likes, comments, shares, saved, reposts, total_interactions, ig_reels_avg_watch_time, ig_reels_video_view_total_time und reels_skip_rate, dazu crossposted_views und facebook_views für ein per Crosspost geteiltes Reel. plays, clips_replays_count und ig_reels_aggregated_all_plays_count wurden im April 2025 abgekündigt; an ihre Stelle tritt views.

easyCoexistence liest die Insights eines Reels mit get_social_insights aus, sodass Claude, ChatGPT oder Ihr eigener Code direkt bei Meta für das verbundene Konto abfragen können, wie ein Reel gelaufen ist, und Aufrufe, Reichweite, Sehdauer und Skip-Rate erhalten, mit Metas eigener Fehlermeldung, wenn ein Kennzahlenname abgekündigt ist.

3 seconds

Zeitfenster, das reels_skip_rate misst: der Anteil der Aufrufe, bei denen das Reel in den ersten 3 Sekunden übersprungen wurde.

21 Apr 2025

Wann plays, clips_replays_count und ig_reels_aggregated_all_plays_count in allen API-Versionen abgekündigt wurden.

3 Dec 2025

Wann reels_skip_rate, reposts, crossposted_views und facebook_views zu den Media-Insights hinzugefügt wurden.

48 hours

Wie lange die Daten hinter den Medienkennzahlen verzögert sein können.

2 years

Wie lange Meta die Medienkennzahlen speichert.

Welche Kennzahlen liefert ein Reel?

Die Kennzahlen aus Metas Referenz für Medien-Insights mit media_product_type REELS, abgefragt mit GET /<IG_MEDIA_ID>/insights und einem kommagetrennten Parameter metric. Meta kennzeichnet einige davon als geschätzt oder in Entwicklung, wie jeweils neben der Kennzahl vermerkt; likes und comments zählt Meta nur als organische Aktivität:

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.

Was liefert eine Reels-Insights-Anfrage zurück?

Ein Objekt je Kennzahl in data, jeweils mit name, period, values, title, description und id. period lautet immer lifetime: Meta setzt diesen Wert für Medienkennzahlen fest, er lässt sich nicht ändern, deshalb braucht die Anfrage keinen. Metas Referenz beschreibt die beiden Kennzahlen zur Sehdauer als Zeitbeträge, ohne eine Einheit zu nennen; prüfen Sie sie also an einem Reel, das Sie kennen, bevor Sie sie grafisch darstellen.

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"
    }
  ]
}

Welche Reels-Kennzahlen wurden abgekündigt, und was ersetzt sie?

Meta kündigte die ersten drei ab Graph API v22.0 am 21. Januar 2025 ab, dem Tag, an dem Meta views einführte, und in allen Versionen am 21. April 2025; video_views ab v21.0 und in allen Versionen am 8. Januar 2025. Eine Anfrage, die eine abgekündigte Kennzahl nennt, schlägt fehl; eine Kennzahlenliste, die vor 2025 geschrieben wurde, muss daher aktualisiert werden:

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

Was zählen views und reach bei einem Reel?

views ist die Anzahl der Male, die das Reel auf Instagram abgespielt wurde, eine Kennzahl, die Meta als in Entwicklung kennzeichnet; reach ist die Anzahl eindeutiger Konten, die es mindestens einmal gesehen haben, was Meta als geschätzt kennzeichnet. likes, comments, views und total_interactions zählen nur organische Aktivität und lassen Interaktionen mit Anzeigen aus, die aus dem Reel entstanden sind. total_likes, total_comments und total_views, die beworbene Medien einschließen, gibt es nur mit Facebook Login.

Welche Grenzen und Verzögerungen gelten?

Metas Referenz für Medien-Insights legt für die Zahlen eines Reels diese Regeln fest:

  • Die Daten hinter den Kennzahlen können um bis zu 48 Stunden verzögert sein.
  • Medienkennzahlen werden bis zu 2 Jahre gespeichert.
  • Fehlen Daten oder sind sie nicht verfügbar, gibt die Antwort einen leeren Datensatz zurück, nicht 0.
  • crossposted_views und facebook_views werfen einen Fehler für ein Reel, das nicht per Crosspost geteilt wurde; fragen Sie sie daher in einem eigenen Aufruf ab.
  • Eine Aufschlüsselung, die eine angefragte Kennzahl nicht unterstützt, lässt die gesamte Anfrage mit An unknown error has occurred fehlschlagen.
  • Mit Instagram Login braucht der Token instagram_business_basic und instagram_business_manage_insights auf graph.instagram.com.

Wie liest get_social_insights ein Reel aus?

Mit der account_id der Verbindung, der Medien-ID des Reels als object_id und einer Liste von Kennzahlen. easyCoexistence ruft GET /<IG_MEDIA_ID>/insights auf graph.instagram.com mit dem Token des Kontos auf, übergibt die Kennzahlennamen unverändert an Meta und gibt die Daten von Meta zurück bzw. Metas eigene Fehlermeldung, wenn ein Name abgekündigt ist. list_social_posts liefert die Medien-IDs der letzten Beiträge und Reels des Kontos.

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"
  ]
}

Häufige Fehler

  • plays oder clips_replays_count anfragen. Beide wurden am 21. April 2025 in allen API-Versionen abgekündigt; fragen Sie stattdessen views ab.
  • crossposted_views oder facebook_views in eine allgemeine Anfrage mischen. Sie werfen einen Fehler für ein Reel, das nicht per Crosspost geteilt wurde, und der Fehler lässt den Aufruf scheitern.
  • Eine Einheit für die Sehdauer annehmen. Meta nennt für ig_reels_avg_watch_time und ig_reels_video_view_total_time keine, prüfen Sie also an einem bekannten Reel.
  • Ein leeres Ergebnis als Null werten. Meta gibt einen leeren Datensatz zurück, wenn die Daten nicht existieren oder derzeit nicht verfügbar sind.
Mit EasyCoexistence

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

Häufig gestellte Fragen

Warum liefert eine Reels-Insights-Anfrage ein leeres Ergebnis?

Meta gibt einen leeren Datensatz zurück, nicht 0, wenn die Daten nicht existieren oder derzeit nicht verfügbar sind, und die Daten hinter den Kennzahlen können um bis zu 48 Stunden hinterherhinken.

Wie bekomme ich die Sehdauer von Reels über die API?

Fragen Sie ig_reels_avg_watch_time für den Durchschnitt und ig_reels_video_view_total_time für die Gesamtdauer ab, einschließlich Wiederholungen, über GET /<IG_MEDIA_ID>/insights.

Was ist reels_skip_rate?

Der Prozentsatz der anfänglichen Aufrufe, bei denen das Reel in den ersten 3 Sekunden übersprungen wurde. Meta hat sie am 3. Dezember 2025 hinzugefügt und kennzeichnet sie als geschätzt und in Entwicklung.

Enthalten Reels-Insights Anzeigenaufrufe?

Nein. likes, comments, views und total_interactions zählen nur organische Aktivität; total_views, das beworbene Medien einschließt, gibt es nur mit Facebook Login.

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