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.
Threads: username vs. displayName. In einem Threads-Eintrag in displayNames ist username der Handle des Kontos (zum Beispiel ayrshare). displayName ist der im Profil angezeigte Name (zum Beispiel Ayrshare). Beide können sich unterscheiden. Verwenden Sie daher username oder profileUrl, um das Threads-Konto zu finden.
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.

Monatliches Post-Kontingent

Die Antwort zeigt, wie viel vom monatlichen Post-Kontingent des Profils verbraucht ist:
  • monthlyPostCount: in diesem Monat auf das Kontingent angerechnete Posts.
  • monthlyPostQuota: das monatliche Limit. Es wird weggelassen, wenn das Kontingent 10.000 oder mehr beträgt, zum Beispiel bei Business-Plänen. Das Limit gilt trotzdem.
Der Zähler wird am 1. jedes Monats um 00:07 UTC zurückgesetzt, nicht an Ihrem Abrechnungsdatum. Fehlgeschlagene Post-Versuche zählen ebenfalls. monthlyApiCalls ist ein anderer Zähler und nicht das Post-Kontingent. Unter Wie viele Posts und API-Aufrufe sind möglich? erfahren Sie, was zählt und was passiert, wenn das Kontingent aufgebraucht ist.