Instagram-Plattform

Nutzer*in

Stellt ein Instagram-Nutzer*innen-Profil 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*einer Nutzer*in abrufen

Einschränkungen

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

Anforderungen

TypAnforderung

Zugriffsschlüssel

Instagram-Nutzer*in

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

PlatzhalterWert

{api-version}
String

API-Version.

{user-id}
Erforderlicher
String

Die App-spezifische Nutzer*innen-ID des*der App-Nutzer*in (Version 11.0 und neuer) oder die reine Nutzer*innen-ID (alle Versionen).

Abfrage-String-Parameter

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

SchlüsselWert

access_token
Erforderlich
String

Der Instagram-Nutzer*innen-Zugriffsschlüssel des*der App-Nutzer*in.

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*einer Nutzer*in anzufordern.

Name des FeldesBeschreibung

account_type

Der Kontotyp des*der Nutzer*in Kann BUSINESS, MEDIA_CREATOR oder PERSONAL sein.

id

Die App-spezifische ID des*der App-Nutzer*in (Version 11.0 und neuer) oder die reine Nutzer*innen-ID (Version 10.0 und älter).

media_count

Die Anzahl an Medien zu dem*der Nutzer*in. Für dieses Feld ist die Berechtigung instagram_graph_user_media erforderlich.

username

Der Benutzungsname des*der Nutzer*in

Edges

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

EdgeBeschreibung

media

Eine Liste von Medien zu dem*der Nutzer*in 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/v21.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.