Skip to main content
GET
Dieser Endpunkt ruft detaillierte Informationen zum authentifizierten Nutzer oder User Profile ab, einschließlich:
  • Einer umfassenden Liste aller verknüpften Social-Media-Konten
  • Social-Media-Benutzernamen und Profilinformationen
  • Kontostatus und Nutzungsmetriken
Die zurückgegebenen Daten spiegeln den Zustand der verbundenen sozialen Netzwerke zum Zeitpunkt der letzten Aktualisierung wider und werden aktualisiert, wenn Nutzer ihre Social-Media-Konten verbinden oder trennen.
Antwort-Caching. Antworten werden bis zu 60 Sekunden zwischengespeichert. Die Felder lastUpdated und nextUpdate beschreiben dieses Cache-Fenster: lastUpdated gibt an, wann der Snapshot erstellt wurde, nextUpdate gibt an, wann er abläuft.nextUpdate ist eine Markierung für den Cache-Ablauf, kein Signal für die Bereitschaft. Sie wird bei jeder Antwort gesetzt, auch bei einer, deren displayNames ein Konto noch nicht aufführt, über das Sie gerade benachrichtigt wurden. Sie kann daher nicht anzeigen, wann ein neu verknüpftes Konto vollständig übernommen wurde.Wenn Sie einen social-Webhook für eine brandneue Verknüpfung abgleichen, fragen Sie so lange ab, bis das erwartete Konto tatsächlich in displayNames erscheint — betrachten Sie weder eine einzelne Antwort noch das Eintreten von nextUpdate als Bestätigung dafür, dass die Verknüpfung fehlt oder abgeschlossen ist.
Wenn keine Social-Media-Konten verknüpft sind, wird activeSocialAccounts nicht zurückgegeben. Rufen Sie Daten für ein bestimmtes User Profile ab, indem Sie den Profile-Key im Header hinzufügen.
  • Wenn Ihr Unternehmen alle User-Profile-Daten auf einmal erfassen muss, verwenden Sie bitte den /user/batch-Endpunkt.
  • Wenn Sie eine Benachrichtigung benötigen, wenn ein Nutzer ein Social-Media-Konto verknüpft oder trennt, lesen Sie den /webhooks-Endpunkt.

Header-Parameter

Query-Parameter

boolean
Standard:false
Gibt zusätzliche Instagram-Details wie Kontotyp (Business oder Creator) und genutztes Kontingent zurück. Nicht empfohlen, es sei denn, Sie benötigen die zusätzlichen Daten, da dies die Antwortzeit verlangsamt.