Instagram-Plattform

Insights

Mit der Instagram Graph API kannst du Kennzahlen für soziale Interaktion für IG-Nutzer und ihre IG-Medien-Objekte abrufen. Bei entsprechender API-Anforderung werden Werte für jede Kennzahl berechnet.

Aufgrund der Datenschutzregeln werden Messaging-bezogene Story-IG-Medien-Interaktionen von Nutzern in manchen Regionen in einigen Kennzahlenberechnungen nicht mehr berücksichtigt. Dazu gehören folgende Regionen: Europa seit dem 1. Dezember 2020 und Japan seit dem 14. April 2021.

  • Für Stories, die von Nutzern in den betroffenen Regionen erstellt werden, gibt die replies-Kennzahl nun den Wert 0 zurück.
  • Für Stories, die von Nutzern außerhalb der betroffenen Regionen erstellt werden, gibt die replies-Kennzahl die Anzahl der Antworten zurück. Antworten von Nutzern in den betroffenen Regionen werden jedoch bei dieser Berechnung nicht berücksichtigt.

Einschränkungen

  • Einige Kennzahlen sind für IG-Nutzer mit weniger als 100 Followernnicht verfügbar.
  • Die API meldet lediglich Kennzahlen zu organischer Interaktion. Interaktionen zu Werbeanzeigen mit einem Medien-Objekt werden nicht berücksichtigt.
  • Kennzahlen zu Medien werden bis zu zwei Jahre lang gespeichert. Kennzahlen zu Nutzer*innen werden bis zu 90 Tage lang gespeichert.
  • Du kannst jeweils nur Insights für eine*n Nutzer*in abrufen.
  • Für Facebook-Seiten werden keine Insights bereitgestellt.
  • Stories-Insights sind nur 24 Stunden verfügbar. Das gilt auch für archivierte oder hervorgehobene Stories. Wenn du die aktuellsten Insights für eine Story abrufen möchtest, bevor sie abläuft, richte einen Webhook für das Instagram-Thema ein und abonniere das story_insights-Feld.
  • Insights zu untergeordneten Album-IG-Medien-Elementen werden nicht unterstützt.
  • Wenn von dir angeforderte Insights-Daten nicht existieren oder aktuell nicht verfügbar sind, gibt die API anstatt 0 für einzelne Kennzahlen einen leeren Datensatz zurück.

UTC

Zeitstempel für API-Antworten verwenden die UTC-Zeitzone ohne Zeitversatz und sind gemäß ISO-8601 formatiert. Beispiel: 2019-04-05T07:56:32+0000

Endpunkte

Die API besteht aus den folgenden Endpunkten:

Informationen zu Anforderungen an Kennzahlen, Parameter und Berechtigungen findest du in der Referenzdokumentation zu den einzelnen Endpunkten.

Beispiele

Abrufen von Kontokennzahlen

Zum Abrufen von Kennzahlen für ein Instagram Business- oder Creator-Konto kannst du die GET /{ig-user-id}/insights-Edge abfragen und die gewünschten Kennzahlen angeben.

Beispielanfrage

GET graph.facebook.com/17841405822304914/insights
    ?metric=impressions,reach,profile_views
    &period=day

Beispielantwort

{
  "data": [
    {
      "name": "impressions",
      "period": "day",
      "values": [
        {
          "value": 32,
          "end_time": "2018-01-11T08:00:00+0000"
        },
        {
          "value": 32,
          "end_time": "2018-01-12T08:00:00+0000"
        }
      ],
      "title": "Impressions",
      "description": "Total number of times the Business Account's media objects have been viewed",
      "id": "instagram_business_account_id/insights/impressions/day"
    },
    {
      "name": "reach",
      "period": "day",
      "values": [
        {
          "value": 12,
          "end_time": "2018-01-11T08:00:00+0000"
        },
        {
          "value": 12,
          "end_time": "2018-01-12T08:00:00+0000"
        }
      ],
      "title": "Reach",
      "description": "Total number of times the Business Account's media objects have been uniquely viewed",
      "id": "instagram_business_account_id/insights/reach/day"
    },
    {
      "name": "profile_views",
      "period": "day",
      "values": [
        {
          "value": 15,
          "end_time": "2018-01-11T08:00:00+0000"
        },
        {
          "value": 15,
          "end_time": "2018-01-12T08:00:00+0000"
        }
      ],
      "title": "Profile Views",
      "description": "Total number of users who have viewed the Business Account's profile within the specified period",
      "id": "instagram_business_account_id/insights/profile_views/day"
    }
  ]
}

Abrufen von Medienkennzahlen

Zum Abrufen von Medienkennzahlen kannst du die GET /{ig-media-id}/insights-Edge abfragen und die gewünschten Kennzahlen angeben.

Beispielanfrage

GET graph.facebook.com/{media-id}/insights
    ?metric=engagement,impressions,reach

Beispielantwort

{
  "data": [
    {
      "name": "engagement",
      "period": "lifetime",
      "values": [
        {
          "value": 8
        }
      ],
      "title": "Engagement",
      "description": "Total number of likes and comments on the media object",
      "id": "media_id/insights/engagement/lifetime"
    },
    {
      "name": "impressions",
      "period": "lifetime",
      "values": [
        {
          "value": 13
        }
      ],
      "title": "Impressions",
      "description": "Total number of times the media object has been seen",
      "id": "media_id/insights/impressions/lifetime"
    },
    {
      "name": "reach",
      "period": "lifetime",
      "values": [
        {
          "value": 13
        }
      ],
      "title": "Reach",
      "description": "Total number of unique accounts that have seen the media object",
      "id": "media_id/insights/reach/lifetime"
    }
  ]
}