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.
Zeitfenster, das reels_skip_rate misst: der Anteil der Aufrufe, bei denen das Reel in den ersten 3 Sekunden übersprungen wurde.
Wann plays, clips_replays_count und ig_reels_aggregated_all_plays_count in allen API-Versionen abgekündigt wurden.
Wann reels_skip_rate, reposts, crossposted_views und facebook_views zu den Media-Insights hinzugefügt wurden.
Wie lange die Daten hinter den Medienkennzahlen verzögert sein können.
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:
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.
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:
| Retired | Request instead | |
|---|---|---|
| plays | Deprecated in every version on 21 Apr 2025 | views |
| clips_replays_count | Deprecated in every version on 21 Apr 2025 | views |
| ig_reels_aggregated_all_plays_count | Deprecated in every version on 21 Apr 2025 | views |
| video_views | Deprecated in every version on 8 Jan 2025 | views |
| impressions | Not in Meta's Reels list; returns an error for media created on or after 2 Jul 2024 | views |
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_viewsundfacebook_viewswerfen 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_basicundinstagram_business_manage_insightsauf 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.
{
"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.
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