Instagram-Plattform

On September 4, 2024, we announced the deprecation of the Instagram Basic Display API.

Starting December 4, 2024, all requests to the Instagram Basic Display API will return an error message. We recommend that you migrate your app to the Instagram API to avoid any disruption to your services.

Visit our News for Developers blog post to learn more.

Abrufen von Nutzer*innen-Profilen und Nutzer*innen-Medien

In diesem Leitfaden wird erläutert, wie du das Profil und die Medien eines*einer Instagram-Nutzer*in abrufen kannst.

Abrufen eines Nutzer*innen-Profils

Führe die folgenden Schritte aus, um die Profildaten (Felder) eines*einer Instagram-Nutzer*in für den*die Nutzer*in abzurufen.

Schritt 1: Zugriffsschlüssel und Berechtigungen abrufen

Befolge unseren Leitfaden zum Abrufen von Zugriffsschlüsseln und Berechtigungen, um den Instagram-Nutzer*innen-Zugriffsschlüssel des*der Nutzer*in abzurufen. Du brauchst die Berechtigung instagram_graph_user_profile. Fordere daher den Bereich user_profile an, wenn du die Autorisierung von dem*der Nutzer*in abrufst.

Schritt 2: Nutzer*innen-Node abfragen

Sende eine Anfrage an den folgenden Endpunkt:

GET /me?fields={fields}&access_token={access-token}

Ersetze {fields} durch eine durch Komma getrennte Liste von Nutzer*innen-Feldern, die zurückgegeben werden soll, und ersetze {access-token} durch den Zugriffsschlüssel des*der Nutzer*in. Der Endpunkt GET /me ermittelt die ID des*der Nutzer*in aus dem Schlüssel und leitet die Anfrage an den Nutzer*innen-Node weiter.

Beispielanfrage

curl -X GET \
  'https://graph.instagram.com/me?fields=id,username&access_token=IGQVJ...'

Beispielantwort

{
  "id": "17841405793187218",
  "username": "jayposiris"
}

Medien eines*einer Nutzer*in abrufen

Führe die folgenden Schritte aus, um eine Sammlung der Medien eines*einer Nutzer*in von Instagram abzurufen.

Schritt 1: Zugriffsschlüssel und Berechtigungen abrufen

Befolge unseren Leitfaden zum Abrufen von Zugriffsschlüsseln und Berechtigungen, um den Instagram-Nutzer*innen-Zugriffsschlüssel des*der Nutzer*in abzurufen. Du brauchst die Berechtigungen instagram_graph_user_profile und instagram_graph_user_media permissions. Fordere daher die Bereiche user_profile und user_media an, wenn du die Autorisierung von dem*der Nutzer*in abrufst.

Schritt 2: Nutzer*innen-Medien-Edge abfragen

Sende eine Anfrage an den folgenden Endpunkt:

GET /me/media?fields={fields}&access_token={access-token}

Ersetze {fields} durch eine durch Komma getrennte Liste von Medien-Feldern, die für jedes Medium zurückgegeben werden sollen, das in der Antwort enthalten ist (oder lasse den Parameter fields komplett aus, wenn du nur IDs erhalten möchtest), und ersetze {access-token} durch den Zugriffsschlüssel des*der Nutzer*in. Der Endpunkt GET /me ermittelt die ID des*der Nutzer*in aus dem Schlüssel und leitet die Anfrage an den Nutzer*innen-Node weiter.

Beispielanfrage

curl -X GET \
  'https://graph.instagram.com/me/media?fields=id,caption&access_token=IGQVJ...'

Beispielantwort

{
  "data": [
    {
      "id": "17895695668004550",
      "caption": ""
    },
    {
      "id": "17899305451014820",
      "caption": ""
    },
    {
      "id": "17896450804038745",
      "caption": ""
    },
    {
      "id": "17881042411086627",
      "caption": ""
    }
  ],
  "paging": {
    "cursors": {
      "after": "MTAxN...",
      "before": "NDMyN..."
      },
    "next": "https://graph.faceb..."
  }
}

Mediendaten abrufen

Führe die folgenden Schritte aus, um die Daten (Felder) zu einem Bild, Video oder Album abzurufen.

Schritt 1: Zugriffsschlüssel und Berechtigungen abrufen

Befolge unseren Leitfaden zum Abrufen von Zugriffsschlüsseln und Berechtigungen, um den Instagram-Nutzer*innen-Zugriffsschlüssel des*der Nutzer*in abzurufen. Du brauchst die Berechtigung instagram_graph_user_media. Fordere daher den Bereich user_media an, wenn du die Autorisierung von dem*der Nutzer*in abrufst.

Schritt 2: Medien-Node abfragen

Sende eine Anfrage an den folgenden Endpunkt:

GET /{media-id}?fields={fields}&access_token={access-token}

Ersetze {media-id} durch die ID des Bilds, Videos oder Albums, das du abfragen willst, {fields} durch eine durch Komma getrennte Liste von Medien-Feldern, die zurückgegeben werden sollen, und {access-token} durch den Zugriffsschlüssel des*der Nutzer*in.

Beispielanfrage

curl -X GET \
  'https://graph.instagram.com/17895695668004550?fields=id,media_type,media_url,username,timestamp&access_token=IGQVJ...'

Beispielantwort

{
  "id": "17895695668004550",
  "media_type": "IMAGE",
  "media_url": "https://fb-s-b-a.akamaihd.net/...",
  "username": "jayposiris"
  "timestamp": "2017-08-31T18:10:00+0000"
}

Schritt 2 (Alternative): Nutzer*innen-Medien-Edge abfragen

Du kannst den Edge der Nutzer*innen-Medien abfragen, um eine Sammlung der Medien zu dem*der Nutzer*in zu erhalten, und Felderweiterung verwenden, um in die Antwort zu jedem Medium in der Sammlung Medienfelder einzuschließen. Sende dazu eine Anfrage an den folgenden Endpunkt:

GET /me/media?fields={fields}&access_token={access-token}

Ersetze {fields} durch eine durch Komma getrennte Liste von Medien-Feldern, die für jedes Medium in der Sammlung zurückgegeben werden sollen, und ersetze {access-token} durch den Zugriffsschlüssel des*der Nutzer*in. Der Endpunkt GET /me ermittelt die ID des*der Nutzer*in aus dem Schlüssel und leitet die Anfrage an den Nutzer*innen-Node weiter.

Beispielanfrage

curl -X GET \
  'https://graph.instagram.com/me/media?fields=id,caption&access_token=IGQVJ...'

Beispielantwort

{
  "data": [
    {
      "id": "17895695668004550",
      "caption": ""
    },
    {
      "id": "17899305451014820",
      "caption": ""
    },
    {
      "id": "17896450804038745",
      "caption": ""
    },
    {
      "id": "17881042411086627",
      "caption": ""
    }
  ],
  "paging": {
    "cursors": {
      "after": "MTAxN...",
      "before": "NDMyN..."
      },
    "next": "https://graph.faceb..."
  }
}

Albuminhalte abrufen

Führe die folgenden Schritte aus, um eine Sammlung der Bild- und Video-Medien zu einem Album-Medium abzurufen.

Schritt 1: Zugriffsschlüssel und Berechtigungen abrufen

Befolge unseren Leitfaden zum Abrufen von Zugriffsschlüsseln und Berechtigungen, um den Instagram-Nutzer*innen-Zugriffsschlüssel des*der Nutzer*in abzurufen. Du brauchst die Berechtigung instagram_graph_user_media. Fordere daher den Bereich user_media an, wenn du die Autorisierung von dem*der Nutzer*in abrufst.

Schritt 2: Edge der untergeordneten Medienelemente abrufen

Sende eine Anfrage an den folgenden Endpunkt:

GET /{media-id}/children?fields={fields}&access_token={access-token}

Ersetze {media-id} durch die ID des Albums, das du abfragen willst, {fields} durch eine durch Komma getrennte Liste von Medien-Feldern, die für jedes Bild- und Video-Medium in der Sammlung zurückgegeben werden soll (oder lasse den Parameter fields komplett aus, wenn du nur deren IDs erhalten möchtest), und ersetze {access-token} durch den Zugriffsschlüssel des*der Nutzer*in.

Beispielanfrage

curl -X GET \
  'https://graph.instagram.com/17896450804038745/children?access_token=IGQVJ...'

Beispielantwort

{
  "data": [
    {
      "id": "17880997618081620"
    },
    {
      "id": "17871527143187462"
    }
  ],
  "paging": {
    "cursors": {
      "after": "MTAxN...",
      "before": "NDMyN..."
      },
    "previous": "https://graph.faceb...",
    "next": "https://graph.faceb..."
  }
}