Übersicht
Die Instagram Graph API ist eine Collection von Facebook Graph API-Endpunkten, über die Apps auf Daten in professionellen Instagram-Konten (sowohl Business- als auch Creator-Konten) zugreifen können. Wenn du dich noch nicht gut mit der Facebook Graph API auskennst, lies bitte die Graph API-Dokumentation, bevor du weitermachst.
Basis-URL
Alle Endpunkte können über den graph.facebook.com-Host aufgerufen werden.
App-Nutzer*innen
Professionelle Instagram-Konten werden indirekt über Facebook-Konten aufgerufen. Daher müssen App-Nutzer ein Facebook-Konto besitzen und sich mit diesem bei deiner App anmelden. Darüber hinaus muss das Facebook-Konto Admin-Aufgaben auf einer Facebook-Seite ausführen können, die mit dem gewünschten Instagram-Konto verbunden wurde.
Diese Anforderungen gelten für alle App-Nutzer, auch solche, die eine Rolle in deiner App oder in einem Unternehmen innehaben, das deine App beansprucht hat.
Authentifizierung
Die App-Nutzungsauthentifizierung erfolgt über Zugriffsschlüssel. Professionelle Instagram-Konten werden indirekt über Facebook-Konten aufgerufen. Daher müssen alle API-Anfragen den Facebook-Nutzer*innen-Zugriffsschlüssel deines*deiner App-Nutzer*innen enthalten. Du kannst Schlüssel von App-Nutzer*innen erhalten, indem du Facebook Login implementierst. Beachte, dass Facebook Login keine Instagram-Anmeldedaten unterstützt. App-Nutzer*innen müssen sich also mit einem Facebook-Konto anmelden.
Autorisierung
Die Endpunktautorisierung wird über Berechtigungen und Features abgewickelt. Bevor deine App über einen Endpunkt auf die Instagram-Daten von App-Nutzer*innen zugreifen kann, musst du alle für diese Endpunkte erforderlichen Berechtigungen bei den App-Nutzer*innen anfragen. Die App-Nutzer*innen müssen diese Berechtigungen dann deiner App erteilen. Anschließend kannst du die Endpunkte abfragen und die Nutzer*innendaten abrufen.
Beachte, dass eine Berechtigung nur Zugriff auf die Daten ermöglicht, die von dem*der Nutzer*in, der*die die Berechtigung erteilt hat, erstellt wurden. Einige Endpunkte ermöglichen Apps den Zugriff auf Daten, die nicht von App-Nutzer*innen erstellt wurden. Die zugänglichen Daten sind aber begrenzt und öffentlich.
Du kannst Berechtigungen von App-Nutzer*innen anfragen, indem du Facebook Login implementierst. App-Nutzer*innen mit einer Rolle in deiner App können alle angefragten Berechtigungen erteilen. App-Nutzer*innen, die keine Rolle in deiner App innehaben, können nur Berechtigungen und Features gewähren, die im Rahmen des App Review genehmigt wurden.
Die API verwendet die folgenden Berechtigungen und Features:
In unserer Endpunktreferenz wird erläutert, welche Berechtigungen und Features deine App bei App-Nutzer*innen anfragen muss.
Instagram Messaging
Falls du planst, Instagram Messaging von der Messenger-Plattform zu implementieren, benötigst du die instagram_manage_messages-Berechtigung. Erfahre mehr über Instagram Messaging. 
Co-Autor*innen
Mit dem Feature Instagram-Collab können Nutzer*innen der Instagram-App gemeinsam mit anderen Konten (Co-Autor*innen) Inhalte erstellen (d. h. Medien veröffentlichen).
Bis auf wenige Ausnahmen können Daten zu oder über gemeinsam erstellte Medien nur von dem*der Nutzer*in, der*die die Medien veröffentlicht hat, über die API abgerufen werden. Co-Autor*innen können nicht über die API auf diese Daten zugreifen. Möglich ist dies nur bei der Suche nach besonders leistungsstarken Medien oder kürzlich veröffentlichten Medien, die mit einem bestimmten Hashtag versehen wurden. Siehe Hashtag-Suche.
Seiten
Professionelle Instagram-Konten müssen mit einer Facebook-Seite verbunden werden, bevor ihre Daten über die API aufgerufen werden können. Anschließend kann jede*r Facebook-Nutzer*in, der*die Aufgaben auf dieser Seite ausführen kann, deiner App einen Zugriffsschlüssel erteilen. Dieser kann dann in API-Anfragen verwendet werden.
Im Hilfeartikel Eine Facebook-Seite zu deinem professionellen Instagram-Konto hinzufügen oder die verknüpfte Seite ändern erfährst du, wie du eine Facebook-Seite mit einem professionellen Instagram-Konto verbindest.
Aufgaben
Damit App-Nutzer*innen deiner App Berechtigungen erteilen können, müssen diese in der Lage sein, Aufgaben auf der mit dem gewünschten Instagram-Konto verbundenen Facebook-Seite auszuführen. App-Nutzer*innen können deiner App Berechtigungen basierend auf den für sie zulässigen Aufgaben erteilen:
| Berechtigung | MANAGE | CREATE_CONTENT | MODERATE | ADVERTISE | ANALYZE |
|---|---|---|---|---|---|
instagram_basic | ✔ | ✔ | ✔ | ✔ | ✔ |
instagram_content_publish | ✔ | ✔ | |||
instagram_manage_comments | ✔ | ✔ | ✔ | ||
instagram_manage_insights | ✔ | ✔ | ✔ | ✔ | ✔ |
Du kannst den GET /me/accounts-Endpunkt mit dem Zugriffsschlüssel der App-Nutzer*innen abfragen, um zu bestimmen, welche Aufgaben die Nutzer*innen auf einer Seite ausführen können. Der Endpunkt gibt eine Liste mit Seiten zurück, auf denen die App-Nutzer*innen Aufgaben ausführen können, und gibt außerdem Auskunft über die möglichen Aufgaben für die Nutzer*innen.
In der Referenzdokumentation findest du die erforderlichen Berechtigungen für jeden Endpunkt. Die API unterstützt keine Business Manager-Systemnutzer*innen oder App-Nutzer*innen mit der Rolle „Live-Mitwirkender“.
Auf Aufgaben verweisen
Manchmal musst du deine App-Nutzer*innen über Aufgaben (und welche davon für deine App erforderlich sind) informieren. Hier findest du heraus, wie in unseren verschiedenen UIs auf Aufgaben verwiesen wird.
Klassische Seiten
Auf klassischen Seiten werden Aufgaben als Rollen angegeben. App-Nutzer*innen mit einer Admin-Rolle auf einer Seite können deiner App jede Berechtigung erteilen. App-Nutzer*innen mit anderen Rollen können Berechtigungen wie folgt erteilen:
| Rolle | Erteilbare Berechtigungen |
|---|---|
Redakteur | instagram_basic |
Moderator | instagram_basic |
Werbetreibender | instagram_basic |
Analyst | instagram_basic |
Neue Seitenversion
Seiten der neuen Version geben Aufgaben als Facebook-Zugriff oder Task-Zugriff an. App-Nutzer*innen mit Facebook-Zugriff auf einer Seite können deiner App jede Berechtigung erteilen. App-Nutzer*innen mit aufgabenbasiertem Zugriff können Berechtigungen wie folgt erteilen:
| Aufgabenbasierter Zugriff | Erteilbare Berechtigungen |
|---|---|
Anzeigen | instagram_basic |
Inhalte | instagram_basic |
Statistiken | instagram_basic |
Nachrichten und Community-Aktivität | instagram_basic |
Zur Bestimmung, ob eine Seite die neue Version verwendet, fordere ihr has_transitioned_to_new_page_experience-Feld an. Dieser Wert gibt true zurück, wenn die Seite die neue Version verwendet.
App-Review
Deine App muss den App Review durchlaufen, bevor sie von App-Nutzer*innen verwendet werden kann, die keine Rolle in deiner App und keine Rolle in einem Unternehmen innehaben, das deine App beansprucht hat. Wenn deine App nur von Nutzer*innen verwendet wird, die eine Rolle in deiner App oder deinem Unternehmen haben, musst du den App Review nicht durchlaufen.
Deine Einreichung zum App Review muss keine Anmeldedaten für eine*n Facebook-Testnutzer*in enthalten, wenn du Facebook Login implementiert hast und deine App öffentlich verfügbar ist. Wenn unsere Prüfer*innen sich aber bei einem Facebook-externen Konto anmelden müssen, um deine Implementierung von Facebook Login auszulösen, muss du Anmeldedaten für dieses Konto in deiner Einreichung angeben.
Private Apps
Wenn unsere Prüfer*innen deine App nicht testen können, weil sie sich hinter einem privaten Intranet befindet, keine Benutzeroberfläche hat oder nicht Facebook Login nutzt, kannst du nur die Genehmigung für folgende Berechtigungen abfragen:
Unternehmensverifizierung
Deine App muss die Unternehmensverifizierung durchlaufen, wenn sie von App-Nutzer*innen verwendet werden wird, die keine Rolle in der App und keine Rolle in einem Unternehmen innehaben, das die App beansprucht hat.
Durchsatzratenbegrenzung
Alle Endpunkte unterliegen der Durchsatzratenbegrenzung für Instagram Business-Anwendungsfälle. Nur die Endpunkte Business Discovery und Hashtag Search unterliegen der Durchsatzratenbegrenzung der Plattform.
Webhooks
Du kannst über Webhooks Benachrichtigungen erhalten, wenn jemand die Medienobjekte deiner App-Nutzer*innen kommentiert oder wenn Stories ablaufen. Lies dazu unsere Webhooks-Dokumentation, um zu erfahren, wie du Webhooks verwendest. Richte dann einen Webhook für das Instagram-Thema ein und abonniere die Felder comments und story_insights.
Instagram Messaging
Es werden mehrere Instagram Graph API-Endpunkte in Verbindung mit den Endpunkten der Messenger-Plattform genutzt, damit deine App-Nutzer*innen mit Direktnachrichten interagieren können, die an ihre professionellen Instagram-Konten gesendet wurden. In der Dokumentation zu Instagram Messaging der Messenger-Plattform erfährst du, wie du auf Nachrichten in Instagram Business-Konten zugreifst.