IG-Nutzer*in

Repräsentiert ein Instagram Business-Konto oder ein Instagram Creator-Konto.

Erstellen

Dieser Vorgang wird nicht unterstützt.

Lesen

GET /{ig-user-id}

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

Anforderungen

TypBeschreibung

Zugriffsschlüssel

Nutzer

Unternehmensrollen

Wenn du das shopping_product_tag_eligibility Feld für Produkttags anforderst, müssen App-Nutzer*innen eine Adminrolle im Business Manager haben, dem der Instagram Shop der Instagram-Nutzer*innen gehört.

Instagram Shop

Wenn du das shopping_product_tag_eligibility-Feld für Produktmarkierungen anforderst, müssen Instagram-Nutzer*innen einen genehmigten Instagram Shop mit einem Produktkatalog mit Produkten haben.

Berechtigungen

instagram_basic
pages_read_engagement
pages_show_list


Wenn dem*der App-Nutzer*in auf der Seite über den Business Manager eine Rolle zugewiesen wurde, benötigst du außerdem eine der folgenden Berechtigungen:


ads_management
business_management


Wenn du das Feld shopping_product_tag_eligibility für die Produktmarkierung anfragst, benötigst du außerdem Folgendes:


catalog_management
instagram_shopping_tag_products

Anfragesyntax

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

Pfadparameter

PlatzhalterWert

{api-version}

API-Version.

{ig-user-id}

Erforderlich. IG-Nutzer*innen-ID

Abfrage-String-Parameter

SchlüsselPlatzhalterWert

access_token

{access-token}

Erforderlich. Der Nutzer-Zugriffsschlüssel von App-Nutzer*innen.

fields

{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.

Name des FeldesBeschreibung

biography
Öffentlich

Profiltext

id
Öffentlich

App-spezifische Nutzer-ID

ig_id

Instagram-Nutzer-ID. Wird mit der veralteten Instagram API verwendet – mittlerweile eingestellt. Verwende stattdessen id.

followers_count
Öffentlich

Gesamtanzahl von Instagram-Nutzern, die dem*der Nutzer*in folgen

follows_count

Gesamtanzahl von Instagram-Nutzern, denen der*die Nutzer*in folgen

media_count
Öffentlich

Gesamtanzahl von IG-Medien, die über den*der Nutzer*in veröffentlicht werden

name

Name des Profils

profile_picture_url

URL des Profilbilds

shopping_product_tag_eligibility

Gibt true zurück, wenn App-Nutzer*innen einen Instagram Shop eingerichtet haben und daher Produktmarkierungen verwenden dürfen. Ansonsten wird false zurückgegeben.

username
Öffentlich

Benutzername des Profils

website
Öffentlich

Website-URL mit einem einzigen Profil.

Edges

EdgeBeschreibung

business_discovery

Rufe Daten zu anderen Instagram Business- oder Instagram Creator-IG-Nutzern ab.

content_publishing_limit

Stellt die aktuelle Verwendung der Content-Veröffentlichung eines*einer IG-Nutzer*in dar.

insights

Stellt Kennzahlen zu sozialer Interaktion für eine*n IG-Nutzer*in dar.

live_media

Stellt eine Collection von Live-Video-IG-Medien-Objekten für eine*n IG-Nutzer*in dar.

media

Stellt eine Collection von IG-Medien für eine*n IG-Nutzer*in dar.

media_publish

Veröffentlicht einen IG-Container für eine*n Instagram Business-IG-Nutzer*in.

mentions

Erstellt einen IG-Kommentar zu einem IG-Kommentar oder zu mit Bildunterschriften versehenen IG-Medien, in dem ein*e IG-Nutzer*in von einem*einer anderen Instagram-Nutzer*in @erwähnt wurde.

mentioned_comment

Ruft Daten zu einem IG-Kommentar ab, in dem ein*e IG-Nutzer*in von einem*einer anderen Instagram-Nutzer*in @erwähnt wurde.

mentioned_media

Ruft Daten zu IG-Medien ab, in denen ein*e IG-Nutzer*in in einem Bildtext von einem*einer anderen Instagram-Nutzer*in @erwähnt wurde.

recently_searched_hashtags

Ruft die IG-Hashtags ab, nach denen ein*e IG-Nutzer*in in den letzten 7 Tagen gesucht hat.

stories

Stellt eine Collection von Story-IG-Medien-Objekten für eine*n IG-Nutzer*in dar.

tags

Stellt eine Collection von IG-Medien dar, in denen ein*e IG-Nutzer*in von einem*einer anderen Instagram-Nutzer*in markiert wurde.

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/v19.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.