Dieses Dokument wurde aktualisiert.
Die Übersetzung ins Deutsche ist noch nicht fertig.

Englisch aktualisiert: 17.06.2021

Nutzer

Stellt einen Instagram-Nutzerprofil dar

App-spezifische Nutzer-IDs (ASIDs) würden mit Version 11.0 der API eingeführt. Du kannst weiterhin Nutzer anhand ihrer reinen Nutzer-IDs oder den entsprechenden ASIDs abfragen. Ab Version 11.0 werden jedoch ASIDs als Antwort auf Aufrufe zurückgegeben.

In voraussichtlich zwei Jahren, wenn Version 10.0 veraltet ist, werden die reinen Nutzer-IDs durch ASIDs ersetzt. Du solltest daher bereits jetzt beginnen, deine App-Nutzer mit ihren entsprechenden ASIDs zu verknüpfen.

Erstellen

Dieser Vorgang wird nicht unterstützt.

Lesen

GET /{user-id}

Felder und Edges zu einem Nutzer abrufen

Einschränkungen

Nutzer-IDs der Instagram Legacy API werden nicht unterstützt.

Anforderungen

Typ	Anforderung
Zugriffsschlüssel	Instagram-Nutzer
Berechtigungen	`instagram_graph_user_profile`. Das `media_count`-Feld erfordert außerdem `instagram_graph_user_media`.

Anfragesyntax

GET https://graph.instagram.com/{api-version}/{user-id}
  ?fields={fields}
  &access_token={access-token}

Pfadparameter

Platzhalter	Wert
`{api-version}` String	API-Version.
`{user-id}` Erforderlicher String	Die App-spezifische Nutzer-ID des App-Nutzers (Version 11.0 und neuer) oder die reine Nutzer-ID (alle Versionen).

Abfrage-String-Parameter

Schließe die folgenden Abfrage-String-Parameter ein, um die Anfrage zu erweitern.

Schlüssel	Wert
`access_token` Erforderlich String	Der Instagram-Nutzer-Zugriffsschlüssel des App-Nutzers.
`fields` Kommagetrennte Liste	Eine durch Komma getrennte Liste der Felder und Edges, die zurückgegeben werden sollen. Wird keine Angabe gemacht, werden Standardfelder zurückgegeben.

Felder

Du kannst den fields-Abfrage-String-Parameter verwenden, um die folgenden Felder zu einem Nutzer anzufordern.

Name des Feldes	Beschreibung
`account_type`	Der Kontotyp des Nutzers Kann `BUSINESS`, `MEDIA_CREATOR` oder `PERSONAL` sein.
`id`	Die App-spezifische ID des App-Nutzers (Version 11.0 und neuer) oder die reine Nutzer-ID (Version 10.0 und älter).
`media_count`	Die Anzahl an Medien zum Nutzer. Für dieses Feld ist die Berechtigung `instagram_graph_user_media` erforderlich.
`username`	Der Benutzername des Nutzers

Edges

Du kannst die folgenden Edges als Pfadparameter anfordern oder den fields-Abfrage-String-Parameter verwenden.

Edge	Beschreibung
`media`	Eine Liste von Medien zum Nutzer abrufen

Antwort

Ein JSON-formatiertes Objekt mit standardmäßigen und angeforderten Feldern und Edges.

{
  "{field}":"{value}",
  ...
}

cURL-Beispiel

Anfrage

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

Antwort

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

Aktualisieren

Dieser Vorgang wird nicht unterstützt.

Löschen

Dieser Vorgang wird nicht unterstützt.