Instagram-Insights über die API: Konto- und Beitragsmetriken
Die Instagram-API liefert Insights für ein professionelles Konto und für jeden seiner Beiträge, Reels und Stories. Konto-Metriken umfassen Reichweite, Views, engagierte Konten, neue Follows und Unfollows, Likes, Kommentare, Speicherungen und Shares; Beitragsmetriken umfassen Reichweite, Views, Likes, Kommentare, Speicherungen und Shares. Meta weist darauf hin, dass die Daten um bis zu 48 Stunden verzögert sein können.
easyCoexistence liest Instagram-Insights mit get_social_insights.
Wie lange die Daten hinter den Instagram-Metriken verzögert sein können.
Darunter werden für das Konto keine Follows und Unfollows sowie keine Follower-Demografien zurückgegeben.
Wie lange Meta Medienmetriken speichert.
Wie lange Story-Metriken über die API verfügbar bleiben.
Wann Impressions in allen API-Versionen aufgehört haben zu funktionieren, außer bei Medien vor dem 2. Juli 2024; Views hat sie ersetzt.
Welche Konto-Metriken sind verfügbar?
Abruf über GET /<IG_ID>/insights, meist mit period=day und metric_type=total_value:
- reach: eindeutige Konten, die den Inhalt gesehen haben, inklusive Anzeigen; geschätzt.
- views: wie oft der Inhalt abgespielt oder angezeigt wurde.
accounts_engaged: Konten, die mit dem Inhalt interagiert haben, inklusive Anzeigen; geschätzt.follows_and_unfollows: Follows und Unfollows im Zeitraum; benötigt mindestens 100 Follower.- likes, comments, saves, shares, replies und reposts sowie
total_interactions. profile_links_taps: Tippen auf die Schaltflächen für Geschäftsadresse, Anruf, E-Mail und Nachricht.follower_demographicsundengaged_audience_demographics: Alter, Stadt, Land und Geschlecht.
Welche Beitragsmetriken sind verfügbar?
Abruf über GET /<IG_MEDIA_ID>/insights; welche Metriken gelten, hängt vom Format ab. Bei einem Beitrag oder Reel zählen likes, comments, views und total_interactions nur organische Aktivität, nicht die Interaktionen mit Anzeigen, die daraus erstellt wurden.
- Beiträge und Reels: reach, views, likes, comments, saved, shares,
total_interactionsund reposts. - Nur Reels:
ig_reels_avg_watch_time,ig_reels_video_view_total_timeundreels_skip_rate. - Beiträge und Stories: follows,
profile_visitsundprofile_activity. - Stories: reach, views, shares, replies, navigation, reposts und
total_interactions.
Wie funktionieren period, metric_type und Aufschlüsselungen?
Konto-Metriken verwenden period=day. metric_type=total_value liefert einen Wert für den gesamten Zeitraum und wird für Aufschlüsselungen benötigt; time_series liefert einen Wert pro Tag und ist nur für reach verfügbar. Aufschlüsselungen teilen eine Summe nach media_product_type (Beiträge, Karussells, Reels, Stories und Anzeigen), nach follow_type (Follower oder nicht) oder nach contact_button_type auf.
Demografische Metriken verwenden einen Zeitraum wie this_week oder this_month statt since und until; ohne since und until beziehen sich die übrigen Metriken auf die letzten 24 Stunden. Wird eine Aufschlüsselung angefordert, die eine der angefragten Metriken nicht unterstützt, schlägt die gesamte Anfrage mit einem unbekannten Fehler fehl.
Welche Schwellenwerte und Verzögerungen gelten?
Metas Regeln, wann eine Zahl erscheint und wie lange sie verfügbar bleibt:
- Daten können um bis zu 48 Stunden verzögert sein.
- Konten mit weniger als 100 Followern erhalten keine
follows_and_unfollowsoderfollower_demographics;engaged_audience_demographicsbenötigt 100 Interaktionen im Zeitraum. - Fehlende oder nicht verfügbare Daten werden als leere Menge zurückgegeben, nicht als 0.
- Demografische Metriken liefern nur die 45 größten Werte.
- Konto-Metriken werden bis zu 90 Tage gespeichert, Medienmetriken bis zu 2 Jahre.
Was ist bei Stories und Karussells anders?
Story-Metriken sind nur 24 Stunden verfügbar; liegt ein Wert unter 5, gibt die API statt einer Zahl den Fehlercode 10 (nicht genügend Zuschauer) zurück. Antworten von Personen in Europa und Japan werden ausgeschlossen; eine Story, die dort von einem Konto erstellt wurde, meldet 0 Antworten. Bei Instagram Login gibt es keinen story_insights-Webhook, daher müssen Story-Zahlen abgerufen werden, solange die Story online ist.
Ein Karussell wird als ein einziger Beitrag gemeldet: Meta liefert keine Insights für die darin enthaltenen Fotos und Videos.
Warum ändern sich die Metriknamen?
Meta streicht und benennt Metriken zwischen API-Versionen um. impressions wurde für v22.0 als veraltet markiert und funktionierte ab dem 21. April 2025 in keiner Version mehr, außer bei Medien, die vor dem 2. Juli 2024 erstellt wurden; an ihre Stelle trat views. Zur gleichen Zeit entfielen plays, clips_replays_count und ig_reels_aggregated_all_plays_count. video_views und mehrere Profil-Zeitreihen, darunter profile_views, waren schon früher entfernt worden. Eine Anfrage mit einem entfallenen Namen schlägt fehl, daher kann eine Metrikliste, die für eine frühere API-Version geschrieben wurde, eine Aktualisierung brauchen.
Häufige Fehler
- impressions anfragen. Das funktioniert in keiner API-Version mehr; fragen Sie stattdessen views ab.
- Ein leeres Ergebnis als Null werten. Meta liefert eine leere Datenmenge, wenn eine Metrik nicht verfügbar ist; das ist nicht dasselbe wie keine Aktivität.
- Story-Metriken nach dem Ende der Story auslesen. Sie sind nur 24 Stunden verfügbar.
- Eine Aufschlüsselung zu einer Anfrage mit mehreren Metriken hinzufügen. Unterstützt eine davon sie nicht, schlägt der gesamte Aufruf fehl.
So können Sie Claude oder ChatGPT fragen, wie die Beiträge der letzten Woche gelaufen sind, und erhalten Reichweite, Views, Likes, Kommentare, Speicherungen und Shares direkt von Meta, für das Konto oder einen einzelnen Beitrag. US$ 9 bis US$ 0.75 pro Verbindung und Monat, sinkend mit jeder weiteren Verbindung, mit den ersten 3 Tagen als kostenlose Testphase.
Häufig gestellte Fragen
Was hat impressions in der Instagram-API ersetzt?
views. Die Metrik zählt, wie oft Inhalte abgespielt oder angezeigt wurden. Meta stellte impressions in jeder API-Version am 21. April 2025 ein, außer bei Medien, die vor dem 2. Juli 2024 erstellt wurden.
Warum liefert mein Konto keine Follower-Daten?
Meta gibt follows_and_unfollows und Follower-Demografien für Konten mit weniger als 100 Followern nicht zurück.
Wie weit zurück kann ich Instagram-Insights abrufen?
Bis zu 90 Tage Konto-Metriken und bis zu 2 Jahre Medienmetriken; online_followers umfasst nur die letzten 30 Tage.
Sind Anzeigen in den Zahlen enthalten?
Teilweise. Reichweite und engagierte Konten eines Kontos enthalten Anzeigen, während Likes, Kommentare und Views eines Beitrags nur organische Aktivität zählen.
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