AnmeldenKostenlose Testphase starten
easyCoexistence Offizielle APIs

Instagram Story Insights über die API

Der Endpoint für Medien-Insights von Instagram liefert diese Metriken für eine Story, solange sie aktiv ist: Reichweite, Aufrufe, Antworten, Shares, Navigation, Follows, Profilbesuche, Profilaktivität, Reposts und total_interactions. Navigation wird nach story_navigation_action_type aufgeschlüsselt in TAP_FORWARD, TAP_BACK, TAP_EXIT und SWIPE_FORWARD. Story-Metriken sind 24 Stunden verfügbar, Werte unter 5 liefern Fehler 10, und Instagram Login hat keinen story_insights-Webhook.

easyCoexistence liest die Insights einer Story mit get_social_insights, solange sie aktiv ist, sodass Claude, ChatGPT oder Ihr eigener Code abfragen können, wie die Stories von heute gelaufen sind.

24 hours

Wie lange Story-Medienmetriken über die API verfügbar sind.

Error 10

Wird statt eines Werts zurückgegeben, wenn eine Story-Metrik unter 5 liegt: Zu wenige Aufrufe, damit das Medium Insights anzeigen kann.

Facebook Login

Der einzige Einrichtungsschritt, den Metas Insights-Leitfaden für den story_insights-Webhook nennt; mit Instagram Login wird er nicht unterstützt.

0

Der Wert replies für eine Story, die von einem Konto in Europa oder Japan erstellt wurde.

22 Jun 2026

Als Meta link_clicks für Stories hinzufügte, das Tippen auf Links wie Link-Sticker zählt, nur für Facebook Login.

Welche Metriken liefert eine Story?

Jene, die Metas Referenz für Medienmetriken für media_product_type STORY auflistet, abgerufen mit GET /<STORY_MEDIA_ID>/insights, solange die Story aktiv ist. Bei Instagram Login geht der Aufruf an graph.instagram.com mit einem Token, das instagram_business_basic und instagram_business_manage_insights enthält, und period ist immer lifetime:

reachUnique accounts that saw the Story. Estimated.
viewsTimes the Story was played on Instagram. In development.
repliesReplies to the Story, with regional exceptions.
sharesTimes the Story was shared.
navigationActions taken from the Story: forward, back, exit and next Story.
followsFollows of the account, counted for the Story.
profile_visitsTimes the profile was visited.
profile_activityActions on the profile after engaging, by action_type.
repostsReposts, minus reposts later deleted.
total_interactionsInteractions on the Story, net of removals. In development.
facebook_viewsPlays where the Story was crossposted. Throws if it was not.

Wie liest man Navigation nach Aktion aus?

Fragen Sie navigation allein mit breakdown=story_navigation_action_type ab. Die Summe kommt in total_value.value zurück, jede Aktion in total_value.breakdowns[].results; zusammen ergeben diese die Summe: TAP_FORWARD (Vorwärts), TAP_BACK (Zurück), TAP_EXIT (Beenden) und SWIPE_FORWARD (Nächste Story). Metas Beispielantwort schreibt die Werte in Kleinbuchstaben:

Navigation broken down by action, after Meta's sample
GET https://graph.instagram.com/<STORY_MEDIA_ID>/insights
  ?metric=navigation
  &breakdown=story_navigation_action_type
  &access_token=<INSTAGRAM_USER_ACCESS_TOKEN>

{
  "data": [
    {
      "name": "navigation",
      "period": "lifetime",
      "values": [{ "value": 25 }],
      "total_value": {
        "value": 25,
        "breakdowns": [
          {
            "dimension_keys": ["story_navigation_action_type"],
            "results": [
              { "dimension_values": ["tap_forward"], "value": 19 },
              { "dimension_values": ["tap_back"], "value": 4 },
              { "dimension_values": ["tap_exit"], "value": 1 },
              { "dimension_values": ["swipe_forward"], "value": 1 }
            ]
          }
        ]
      },
      "id": "<STORY_MEDIA_ID>/insights/navigation/lifetime"
    }
  ]
}

Wie lange sind Story-Metriken verfügbar?

24 Stunden. Meta stellt Story-Medienmetriken nur 24 Stunden lang bereit, also für die eigene Lebensdauer der Story, während die zugrunde liegenden Daten bis zu 48 Stunden nachhinken können. Lesen Sie sie nach einem Zeitplan aus, solange die Story aktiv ist, und behalten Sie die letzten Werte, die Sie erhalten haben. Meta weist darauf hin, dass Daten nach Ablauf einer Story noch eintreffen können, wenn sie einem Highlight hinzugefügt wird, und dass API-Aufrufe, Webhooks und die App dann unterschiedliche Ergebnisse zeigen können.

Warum liefert eine Story-Metrik Fehler 10?

Weil ihr Wert unter 5 liegt. Meta gibt den Fehlercode 10 mit der Meldung (#10) Not enough viewers for the media to show insights zurück statt einer kleinen Zahl. Deshalb kann eine Story, die wenige Menschen gesehen haben, fehlschlagen, während eine stärker besuchte gelingt. Behandeln Sie das als niedrige Zahl statt als Ausfall und wiederholen Sie den Aufruf nicht in einer Schleife.

Warum sind die Antworten einer Story 0?

Regionale Regeln. Antworten von Personen in Europa seit dem 1. Dezember 2020 und in Japan seit dem 14. April 2021 werden aus der Metrik replies ausgeschlossen. Eine Story, die von einem Konto in einer dieser Regionen erstellt wurde, liefert daher 0. Metas Referenz definiert replies als IG-Kommentare zum Story-Medienobjekt.

Gibt es einen story_insights-Webhook?

Nicht mit Instagram Login. In Metas Feldtabelle ist story_insights dort als nicht verfügbar markiert, die Medienreferenz sagt, der Insights-Webhook werde mit Instagram Login nicht unterstützt, und der Insights-Leitfaden führt story_insights nur für Facebook Login auf. Mit Facebook Login wird das Feld ausgelöst, wenn eine Story abläuft, enthält nur die ersten 24 Stunden an Metriken und gibt Zählwerte unter 5 als -1 zurück.

Welche Story-Metriken sind eingestellt oder eingeschränkt?

Einige Namen tauchen noch in altem Code oder im Changelog von Meta auf:

  • impressions: veraltet für Medien, die nach dem 2. Juli 2024 erstellt wurden, daher meldet eine aktuelle Story stattdessen views.
  • taps_forward, taps_back und exits: am 11. Dezember 2023 eingestellt; navigation, aufgeschlüsselt nach story_navigation_action_type, meldet dieselben Aktionen.
  • link_clicks: Tippen auf Links wie Link-Sticker, am 22. Juni 2026 hinzugefügt, nur für Facebook Login.
  • total_views: Aufrufe in allen Bereichen, beworbene Medien eingeschlossen, nur mit Facebook Login angeboten.

Wie liest get_social_insights eine Story?

Mit der Medien-ID der Story als object_id, die publish_instagram_post beim Veröffentlichen der Story als media_id zurückgibt, und den Metriken als Liste. Fragen Sie navigation in einem eigenen Aufruf mit params auf breakdown story_navigation_action_type ab, denn ein Breakdown, den eine einzelne angeforderte Metrik nicht unterstützt, lässt den gesamten Aufruf fehlschlagen. Metas Fehler, einschließlich Fehler 10, werden so zurückgegeben, wie Meta sie formuliert hat.

get_social_insights arguments for one Story
{
  "account_id": "<ACCOUNT_ID>",
  "object_id": "<STORY_MEDIA_ID>",
  "metrics": ["reach", "views", "replies", "shares", "follows", "profile_visits"]
}

Häufige Fehler

  • Die Metriken einer Story am nächsten Tag abfragen. Meta stellt sie nur 24 Stunden lang bereit, also erfassen Sie sie, solange die Story aktiv ist.
  • Fehler 10 in einer Schleife wiederholen. Er bedeutet einen Wert unter 5, also zu wenige Zuschauer, und ändert sich erst, wenn mehr Menschen die Story sehen.
  • navigation mit einem Breakdown zusammen mit anderen Metriken anfordern. story_navigation_action_type funktioniert nur bei navigation, und ein nicht unterstützter Breakdown lässt den gesamten Aufruf fehlschlagen.
  • Auf story_insights mit Instagram Login warten. Meta bietet diesen Webhook dort nicht an, also fragen Sie den Insights-Endpoint ab, bevor die Story abläuft.
Mit EasyCoexistence

Sie erhalten Reichweite, Aufrufe, Antworten, Shares und Navigation direkt von Meta für das verbundene Konto. Stories werden mit publish_instagram_post veröffentlicht. US$ 9 bis US$ 0.75 pro Verbindung und Monat, sinkend mit jeder weiteren Verbindung, mit der kostenlosen Testphase für die ersten 3 Tage.

Häufig gestellte Fragen

Ändern sich Story-Insights, nachdem eine Story einem Highlight hinzugefügt wurde?

Ja, das können sie. Meta sagt, eine Story, die einem Highlight hinzugefügt wird, kann nach dem Ablauf weiterhin Daten erhalten, daher können API, Webhooks und die App eine Zeit lang voneinander abweichen.

Funktioniert total_views bei Stories mit Instagram Login?

Nein. total_views, das Aufrufe in allen Bereichen zählt und beworbene Medien einschließt, wird nur mit Facebook Login angeboten. Mit Instagram Login fragen Sie views ab.

Kann die API Klicks auf Link-Sticker in einer Instagram-Story lesen?

Nur mit Facebook Login. Meta hat link_clicks für Stories am 22. Juni 2026 hinzugefügt. Es zählt das Tippen auf Links wie Link-Sticker und wird nicht mit Instagram Login angeboten.

Was hat taps_forward, taps_back und exits ersetzt?

navigation, aufgeschlüsselt nach story_navigation_action_type in TAP_FORWARD, TAP_BACK, TAP_EXIT und SWIPE_FORWARD. Die alten Metriken wurden am 11. Dezember 2023 eingestellt.

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