Änderungsprotokoll

Dieses Änderungsprotokoll bezieht sich auf Änderungen an der Instagram Graph API.

Ähnliche Änderungsprotokolle

12. September 2023

Deprecation of Media and User Insights

Applies to v18.0+. Will apply to all versions on December 11, 2023.

Duplicative and legacy Instagram insight metrics are being deprecated. Please see documentation for the endpoints and Instagram Insights for more information on which metrics to use in their place.

The following endpoints and metrics are affected:

  • GET /{ig-user-id}/insights
    • AUDIENCE_GENDER_AGE
    • AUDIENCE_LOCALE
    • AUDIENCE_COUNTRY
    • AUDIENCE_CITY
  • GET /{ig-media-id}/insights
    • CAROUSEL_ALBUM_IMPRESSIONS
    • CAROUSEL_ALBUM_REACH
    • CAROUSEL_ALBUM_ENGAGEMENT
    • CAROUSEL_ALBUM_SAVED
    • CAROUSEL_ALBUM_VIDEO_VIEWS
    • TAPS_FORWARD
    • TAPS_BACK
    • EXITS
    • ENGAGEMENT

Note: total_interactions, which is listed as an alternative for some of the deprecated metrics, is currently only available using version 18.0 and does not work with older versions. When querying older versions before Dec 11, 2023, please use the engagement metric.total_interactions, which is listed as an alternative for some of the deprecated metrics, is currently only available using version 18.0 and does not work with older versions. When querying older versions before Dec 11, 2023, please use the engagement metric.

9. November 2022

Instagram-Webhooks

Gilt für alle Versionen.

ad_id und ad_title werden im media-Objekt des value-Objekts des Feldes comments zurückgegeben, wenn eine Person einen beworbenen Instagram-Post oder Instagram-Werbeanzeigen-Post kommentiert.

31. Oktober

Reels – Produktmarkierungen

Gilt für alle Versionen.

Die Instagram Produktmarkierungs-API ist für Reels verfügbar. Du kannst bis zu 30 Produkte markieren, wenn du ein Reel veröffentlichst.

28. Juni 2022

Reels

Gilt für alle Versionen.

Reels werden jetzt unterstützt. Um ein Video als Reel zu veröffentlichen, lege den media_type-Parameter auf REELS fest, wenn du einen Container für einen einzelnen Medienbeitrag erstellst. In der Referenz POST /ig-user/media endpoint erfährst du, welche Parameter du für Reels verwenden kannst und welche Anforderungen an Reels gelten.

27. Juni 2022

Dokumentation zur alten Instagram-API

Gilt für alle Versionen.

Die Entwicklungsdokumentation zur alten Instagram-API wurde entfernt. Du wirst jetzt zur Entwicklungsdokumentation zur Instagram-Platform weitergeleitet.

20. Juni 2022

Produktmarkierung

Gilt für alle Versionen.

Du kannst jetzt Instagram Shopping-Produkt-Tags für veröffentlichte Medien auf Instagram Business erstellen und verwalten. Informationen zur Vorgehensweise findest du im Leitfaden für Produktmarkierungen.

27. Mai 2022

Produktvarianten

Gilt für alle Versionen.

Für Partner mit der Beta-Version für Produktmarkierungen werden jetzt alle Produktvarianten, die die Suchkriterien einer Anfrage erfüllen, zurückgegeben, wenn ein Katalog nach Produkten durchsucht wird.

15. März 2022

Carousel-Posts

Gilt für alle Versionen.

Du kannst jetzt die Instagram API verwenden, um Posts zu veröffentlichen, die mehrere Bilder und Videos enthalten (Carousel-Posts). Die vollständigen Schritte zur Veröffentlichung findest du im Leitfaden zur Content-Veröffentlichung.

Wenn deine App bereits die Genehmigung für die erforderlichen Berechtigungen zur Veröffentlichung von Inhalten hat, muss sie nicht erneut die App Review durchlaufen, um diese Funktion zu verwenden.

9. November 2021

Live-Videos

Gilt für alle Versionen.

Du kannst jetzt die Instagram API verwenden, um von deinen App-Nutzern übertragene Live-Video-IG-Medien sowie Kommentare zu diesen Videos anzurufen. Mit der Instagram Messaging API kannst du außerdem private Nachrichten (Direktnachrichten) an die Verfasser von Kommentaren senden. Für die Unterstützung dieser Funktion wurden folgende Änderungen vorgenommen:

  • Eine neue GET /ig-user/live_media-Edge kann Live-Video-IG-Medien zurückgeben, die zum Zeitpunkt deiner Abfrage von deinem App-Nutzer übertragen werden.
  • Das media-Feld für einen IG-Kommentar gibt jetzt ein Objekt zurück, das sowohl die ID (id) als auch den Veröffentlichungsort (media_product_type) des Mediums enthält, zu dem der Kommentar erstellt wurde.
  • Ein neues live_comments-Instagram-Webhooks-Feld kann Benachrichtigungen senden, die Live-Kommentare zu Live-Videos deiner App-Nutzer enthalten.

In der Dokumentation zur Instagram Messaging API zum Thema private Antworten erfährst du, wie du private Antworten an Nutzer sendest, die einen Kommentar zu Live-Video-IG-Medien deiner App-Nutzer erstellt haben.

20. Oktober 2021

IG-Kommentare

Gilt für alle Versionen.

Wir haben zwei neue Felder zu IG-Kommentaren hinzugefügt:

  • from – gibt ein Objekt zurück, dass die IGSID (id) und den Benutzernamen (username) des Kommentarverfassers enthält.
  • parent_id – gibt die ID des übergeordneten IG-Kommentars zurück, wenn dieser Kommentar als Antwort auf einen anderen IG-Kommentar erstellt wurde.

Instagram-Webhooks

Gilt für alle Versionen.

Das Instagram-Webhooks-Feldcomments enthält jetzt die folgenden Eigenschaften im Feldobjekt value:

  • from.idIGSID des Instagram-Benutzers, der den Kommentar erstellt hat.
  • from.username – Benutzername des Instagram-Benutzers, der den Kommentar erstellt hat.
  • media.id – ID des IG-Mediums, zu dem der Kommentar erstellt wurde.
  • media.media_product_type – Surface (veröffentlichter Ort) des IG-Mediums, zu dem der Kommentar erstellt wurde.
  • parent_id – ID des übergeordneten IG-Kommentars, wenn dieser Kommentar in einem anderen IG-Kommentar erstellt wurde (d. h., wenn es sich um eine Antwort auf einen anderen Kommentar handelt).

5. Oktober 2021

Folgende Änderungen gelten für Instagram TV-Videos, die am oder nach dem 5. Oktober 2021 erstellt wurden. Instagram TV-Videos, die vor diesem Datum erstellt wurden, sind von diesen Änderungen nicht betroffen.

  • Das media_product_type-Feld gibt FEED statt IGTV zurück.
  • Das video_title-Feld wird nicht zurückgegeben.
  • Die Felder comments und mentions werden jetzt für Instagram Webhooks unterstützt.

Ab dem 3. Januar 2022 gelten die oben genannten Änderungen für alle API-Versionen und alle Instagram TV-Videos unabhängig von deren Erstellungsdatum. Das bedeutet, ab dem 3. Januar 2022 können Apps, die ältere API-Versionen verwenden, Instagram TV-Videos abfragen (Lesen wird seit Version 10.0 unterstützt und ist auf Version 10.0 und neuere Versionen beschränkt).

Ab Version 14.0 wird das Feld video_title nicht mehr unterstützt und die API löst einen Fehler aus, wenn das Feld angefragt wird.

8. Juni 2021

Anzahl der „Gefällt mir“-Angaben

Gilt ab Version 11.0 aufwärts. Gilt ab dem 7. September 2021 für alle Versionen.

Bei der indirekten Abfrage eines IG-Medien-Objekts über einen anderen Endpunkt oder eine Felderweiterung wird das Feld like_count bei API-Antworten ausgelassen, wenn der*die Medien-Eigentümer*in die Anzahl der „Gefällt mir“-Angaben dafür verborgen hat. Die direkte Abfrage des IG-Medien-Objekts (die nur durch den*die Eigentümer*in des IG-Medien-Objekts ausgeführt werden kann) gibt die tatsächliche Anzahl der „Gefällt mir“-Angaben zurück, auch wenn „Gefällt mir“-Angaben verborgen sind.


Zeitbasierte Paginierung

Gilt ab Version 11.0.

Die Parameter since und until wurden zum GET /{ig-user-id}/media-Endpunkt hinzugefügt, um die zeitbasierte Paginierung zu unterstützen.

26. Mai 2021

Bei der indirekten Abfrage eines IG-Medienobjekts über einen anderen Endpunkt gibt das Feld like_count jetzt 0 zurück, wenn der App-Nutzer nicht Eigentümerdes Medienobjekts ist und der Medieneigentümer „Gefällt mir“-Angaben dafür verborgen hat. Die direkte Abfrage des IG-Medienobjekts kann nur durch den Eigentümer des IG-Medienobjekts ausgeführt werden. Sie gibt dann die tatsächlich Anzahl der „Gefällt mir“-Angaben zurück, auch wenn der Eigentümer „Gefällt mir“-Angaben für das Medienobjekt verborgen hat.

4. Mai 2021

Kleinere Änderung an der Berechnung der Kennzahl online_followers für IG-Nutzer vorgenommen.

14. April 2021

Story-IG-Medien-Interaktionen von Nutzern in Japan werden in einigen replies-Kennzahlenberechnungen nicht mehr berücksichtigt.

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

12. April 2021

Kleinerer Fehler im Zusammenhang mit Kennzahlen für Story-IG-Medien behoben.

9. April 2021

  • Das Feld status für einen IG-Container gibt jetzt einen Fehler-Untercode zurück, wenn das Feld error_code des Containers den Wert ERROR hat.
  • Die Kennzahl video_views von IG-Medien-Insights unterstützt jetzt Alben und gibt die Summe von video_views für alle Videos im Album anstelle von 0 zurück.

16. März 2021

IGTV-Medien werden nun in v10.0+ unterstützt. Das gilt für alle Endpunkte außer denjenigen, die für Content-Veröffentlichung und Webhooks verwendet werden. Um diese Änderung zu unterstützen, haben wir neue media_product_type- und video_title-Felder zum IG Media-Node hinzugefügt. IGTV-Medien müssen bei Veröffentlichung auf Instagram geteilt werden (während Vorschau posten oder Vorschau im Feed teilen aktiviert ist), damit über die API darauf zugegriffen werden kann.

26. Januar 2021

Die Betaversion der Content-Veröffentlichung wurde beendet. Alle Entwickler*innen können jetzt Medien über professionelle Instagram-Konten veröffentlichen. Details zur Verwendung findest du im Leitfaden zur Content-Veröffentlichung.

2. Dezember 2020

Gemäß der Datenschutzrichtlinie für elektronische Kommunikation der Europäischen Union werden Messaging-bezogene Story-IG Medien-Interaktionen von Nutzer*innen im Europäischen Wirtschaftsraum (EWR) ab dem 1. Dezember 2020 in einigen Kennzahlenberechnungen nicht mehr berücksichtigt:

  • Für Stories, die von Nutzer*innen im EWR erstellt werden, gibt die replies-Kennzahl nun den Wert 0 zurück.
  • Für Stories, die von Nutzer*innen außerhalb des EWR erstellt werden, gibt die replies-Kennzahl die Anzahl der Antworten zurück. Antworten von Nutzer*innen im EWR werden jedoch bei dieser Berechnung nicht berücksichtigt.

Diese Änderung gilt für alle Versionen.

10. November 2020

  • IG-Nutzer*innen-Insights: Die follower_count-Werte orientieren sich jetzt enger an den entsprechenden Werten, die in der Instagram-App angezeigt werden. Außerdem gibt follower_count jetzt Daten für maximal 30 Tage anstatt für 2 Jahre zurück. Diese Änderung gilt für v9.0+ und wird am 9. Mai 2021 auf alle Versionen angewendet.

5. Mai 2020

3. Dezember 2019

  • Insights: Damit das API-Verhalten dem Verhalten der Instagram-App entspricht, sind Insights zu IG-Nutzer*innen jetzt nur für IG-Nutzer*innen mit mindestens 100 Follower*innen verfügbar.

13. August 2019

  • Business Discovery: Die Business Discovery API kann jetzt dazu genutzt werden, Daten zu anderen Instagram Creator-Konten abzurufen.

22. Mai 2019

9. Mai 2019

  • Webhooks: Das story_insights-Feld erfordert jetzt die Berechtigung instagram_manage_insights anstelle von instagram_manage_comments.

31. Oktober 2018

  • Hashtag Search API: Mit unserer neuen Hashtag Search API kannst du jetzt nach Medien suchen, die mit bestimmten Hashtags markiert sind. #spooky!

23. Oktober 2018

  • /{ig-media-id}/comments-Edge: GET-Anfragen, die mit API-Version 3.1 oder früher gesendet werden, geben Ergebnisse in chronologischer Reihenfolge zurück. Die Ergebnisse für mit Version 3.2+ erstellte Anfragen werden in umgekehrter chronologischer Reihenfolge zurückgegeben.

7. Juni 2018

  • /{ig-media-id}-Node: Du kannst das permalink-Feld für Medienobjekte jetzt mit Felderweiterung abrufen.

1. Mai 2018

  • Unternehmensverifizierung: Zur Nutzung der Instagram Graph API ist für alle Apps eine Unternehmensverifizierung erforderlich. Diese ist Teil des App Review-Vorgangs und wird nun für alle Instagram Graph API-Endpunkte benötigt. Vor dem 1. Mai 2018 überprüfte Apps müssen bis zum 1. August 2018 erneut überprüft werden. Andernfalls geht der Zugriff auf die API verloren.

24. April 2018

  • /{ig-comment-id}-Node:
    • Neues username-Feld hinzugefügt.
    • Bei GET-Anfragen wird das user-Feld nur in die Antworten aufgenommen, wenn der*die Nutzer*in, von dem*der die Anfrage stammt, Eigentümer*in des Kommentars ist. Stattdessen wird username für alle Kommentarersteller*innen zurückgegeben. Das gilt auch für Abfragen von Kommentaren, die über andere APIs wie die Mentions API erstellt wurden.
  • /{ig-media-id}-Node:
    • Neues username-Feld hinzugefügt.
    • Bei GET-Anfragen wird das owner-Feld nur in die Antworten aufgenommen, wenn der*die Nutzer*in, von dem*der die Anfrage stammt, Eigentümer*in des Medienobjekts ist. Stattdessen wird username für alle Kommentarersteller zurückgegeben. Das gilt auch für Abfragen von Medienobjekten, die über andere APIs wie die Mentions API erstellt wurden.

23. April 2018

  • Insights API: Insights enthalten jetzt Werbeaktivitäten, die über die API, Facebook-Werbeschnittstellen und das Feature „Hervorheben“ von Instagram generiert wurden. Das wirkt sich auf die folgenden Kennzahlen aus:

    • impressions
    • reach

13. März 2018

  • Content Publishing API: Betapartner können jetzt mit der /{ig-user-id}/media-Edge Standorte und öffentliche Instagram-Nutzer*innen beim Veröffentlichen von Fotos markieren.

8. März 2018

  • Öffentliche Felder: Das timestamp-Feld im /{ig-media-id}-Node ist jetzt ein öffentliches Feld und kann über die Felderweiterung zurückgegeben werden.

22. Februar 2018

  • Öffentliche Felder: Die Nodes /{ig-user-id}, /{ig-comment-id} und /{ig-media-id} geben jetzt alle öffentlichen Felder zurück, wenn über eine Edge mit Felderweiterung darauf zugegriffen wird. In den Referenzdokumenten der einzelnen Nodes findest du heraus, welche Felder öffentlich sind.

8. Februar 2018

  • Content Publishing API: Betapartner können jetzt Hashtags beim Veröffentlichen von Fotos über die /{ig-user-id}/media-Edge angeben. #crazywildebeest FTW!