IG-Nutzer*in

Steht für ein Instagram Business-Konto oder ein Instagram Creator-Konto.

In unserer Dokumentation verwenden wir „Instagram-Nutzer*in“ und „Instagram-Konto“ gleichbedeutend. Beide stehen für das professionelle Instagram-Konto deiner App-Nutzer*innen.

Requirements

	Instagram API with Instagram Login	Instagram API with Facebook Login
Access Tokens	Instagram User user access token	Facebook User access token
Host URL	`graph.instagram.com`	`graph.facebook.com`
Login Type	Business Login for Instagram	Facebook Login for Business
Permissions	`instagram_business_basic`	`instagram_basic` `pages_read_engagement` If the app user was granted a role via the Business Manager on the Page connected to the targeted IG User, you will also need one of: `ads_management` `ads_read` If you are requesting the `shopping_product_tag_eligibility` field for product tagging, you will also need: `catalog_management` `instagram_shopping_tag_products`
Business Roles	Not applicable.	If you are requesting the `shopping_product_tag_eligibility` field for product tagging, the app user must have an admin role on the Business Manager that owns the IG User's Instagram Shop.
Instagram Shop	Not applicable.	If you are requesting the `shopping_product_tag_eligibility` field for product tagging, the IG User must have an approved Instagram Shop with a product catalog containing products.

Erstellen

Dieser Vorgang wird nicht unterstützt.

Lesen

GET /<IG_USER_ID>

Felder und Edges für ein Instagram Business- oder Creator*innen-Konto abrufen.

If you are migrating from Marketing API Instagram Ads endpoints to Instagram Platform endpoints, be aware that some field names are different.

Anfragesyntax

GET https://graph.facebook.com/<API_VERSION>/<IG_USER_ID>
  ?fields=<LIST_OF_FIELDS>
  &access_token=<ACCESS_TOKEN>

Pfadparameter

Platzhalter	Wert
`<API_VERSION>`	API-Version.
`<IG_USER_ID>`	Erforderlich. IG-Nutzer*innen-ID

Abfrage-String-Parameter

Schlüssel	Platzhalter	Wert
`access_token`	`<ACCESS_TOKEN>`	Erforderlich. Der Nutzer-Zugriffsschlüssel von App-Nutzer*innen.
`fields`	`<LIST_OF_FIELDS>`	Kommagetrennte Liste von IG-Medien-Feldern, die für die einzelnen IG-Live-Medien im Ergebnissatz zurückgegeben werden sollen.

Felder

Öffentliche Felder können von einer Edge mit Felderweiterung zurückgegeben werden. Für den Zugriff auf von einer Seite gestützte Instagram-Konten sind nur einige wenige Felder verfügbar.

Name des Feldes	Beschreibung
`alt_text` Öffentlich	Beschreibender Text für Bilder, zur Verbesserung der Barrierefreiheit.
`biography` Öffentlich	Profiltext
`followers_count` Öffentlich	Gesamtanzahl von Instagram-Nutzerinnen, die demder Nutzer*in folgen.
`follows_count`	Gesamtanzahl von Instagram-Nutzerinnen, denen derdie Nutzer*in folgt.
`has_profile_pic`	Gibt an, ob das professionelle Instagram-Konto deinesdeiner App-Nutzerin über ein Profilbild verfügt.
`id` Öffentlich	App-spezifische Nutzer*innen-ID. Für von einer Seite gestützte Instagram-Konten verfügbar.
`is_published`	Gibt an, ob das Instagram-Konto deinesdeiner App-Nutzerin veröffentlicht ist. Für von einer Seite gestützte Instagram-Konten verfügbar.
`legacy_instagram_user_id`	Die Instagram-ID deiner App-Nutzer*innen, die für Marketing API-Endpunkte mit v21.0 und älter erstellt wurde. Für von einer Seite gestützte Instagram-Konten verfügbar.
`media_count` Öffentlich	Gesamtzahl der IG-Medien, die im Konto deinesdeiner App-Nutzerin veröffentlicht wurden.
`name`	Name des Instagram-Profils desder App-Nutzerin.
`profile_picture_url`	URL des Instagram-Profilbilds desder App-Nutzerin.
`collaborative_media_search`	Sucht ein bestimmtes gemeinsames Medium anhand einer ID. Zugriff über die Felderweiterung. Nur für die Instagram API mit Facebook-Login verfügbar.
`shopping_product_tag_eligibility`	Gibt `true` zurück, wenn derdie App-Nutzerin einen Instagram Shop eingerichtet hat und daher Produktmarkierungen verwenden darf. Ansonsten wird `false` zurückgegeben.
`username` Öffentlich	Benutzername des Instagram-Profils desder App-Nutzerin.
`website` Öffentlich	Website-URL desder App-Nutzerin.

Edges

Edge	Beschreibung
`agencies`	Eine Liste der Unternehmen, die für dieses professionelle Instagram-Konto werben können.
`authorized_adaccounts`	Werbekonten, die für dieses professionelle Instagram-Konto werben können.
`business_discovery`	Rufe Daten zu anderen Instagram Business- oder Instagram Creatorinnen-IG-Nutzerinnen ab.
`connected_threads_user`	Stellt ein Threads-Konto dar, das mit einem Instagram-Konto verbunden ist.
`content_publishing_limit`	Stellt die aktuelle Verwendung der Content-Veröffentlichung eineseiner IG-Nutzerin dar.
`insights`	Stellt Kennzahlen zu sozialer Interaktion für eineneine IG-Nutzerin dar.
`instagram_backed_threads_user`	Stellt ein Threads-Konto dar, das auf einem Instagram-Konto basiert.
`live_media`	Stellt eine Collection von Live-Video-IG-Medien-Objekten für einen IG-Nutzerin dar.
`media`	Stellt eine Collection von IG-Medien für einen IG-Nutzerin dar.
`media_publish`	Veröffentlicht einen IG-Container für einen Instagram Business-IG-Nutzerin.
`mentions`	Erstellt einen IG-Kommentar zu einem IG-Kommentar oder zu mit Bildunterschriften versehenen IG-Medien, in dem eine IG-Nutzerin von einemeiner anderen Instagram-Nutzerin @erwähnt wurde.
`mentioned_comment`	Ruft Daten zu einem IG-Kommentar ab, in dem eine IG-Nutzerin von einemeiner anderen Instagram-Nutzerin @erwähnt wurde.
`mentioned_media`	Ruft Daten zu IG-Medien ab, in denen eine IG-Nutzerin in einem Bildtext von einemeiner anderen Instagram-Nutzerin @erwähnt wurde.
`recently_searched_hashtags`	Ruft die IG-Hashtags ab, nach denen eine IG-Nutzerin in den letzten 7 Tagen gesucht hat.
`stories`	Stellt eine Collection von Story-IG-Medien-Objekten für einen IG-Nutzerin dar.
`tags`	Stellt eine Collection von IG-Medien dar, in denen eine IG-Nutzerin von einemeiner anderen Instagram-Nutzerin markiert wurde.
`upcoming_events`	Eine Liste der Veranstaltungen, die dieses professionelle Instagram-Konto hostet.
`collaboration_invites`	Stellt eine Collection von `IG Media`-Objektattributen (media_id, media_owner_username, caption, media_url) dar, für die derdie IG-Nutzerin zur Zusammenarbeit eingeladen wurde.
`collaborative_media`	Stellt eine Collection von IG-Medien dar, bei denen derdie IG-Nutzerin eine akzeptierter Collab-Partnerin ist. Enthält keine Medien, die demder Nutzer*in direkt gehören. Nur für die Instagram API mit Facebook-Login verfügbar.

Antwort

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

{
  "<FIELD>":"<VALUE>",
  ...
}

cURL-Beispiel

Anfrage

curl -X GET \
  'https://graph.facebook.com/v25.0/17841405822304914?fields=biography%2Cid%2Cusername%2Cwebsite&access_token=EAACwX...'

Antwort

{
  "biography": "Dino data crunching app",
  "id": "17841405822304914",
  "username": "metricsaurus",
  "website": "http://www.metricsaurus.com/"
}

Aktualisieren

Dieser Vorgang wird nicht unterstützt.

Löschen

Dieser Vorgang wird nicht unterstützt.