Zum Hauptinhalt springen
GET
Rufen Sie alle Profile ab, die mit dem Primary Profile verknüpft sind. Das Primary Profile wird in den Ergebnissen nicht zurückgegeben. Aus Sicherheitsgründen werden die Profile Keys über diesen GET-Aufruf nicht zurückgegeben. Weitere Informationen finden Sie hier.

Header-Parameter

Query-Parameter

title
string
Gibt nur das Profil zurück, das mit dem URL-kodierten Titel verknüpft ist.
refId
string
Gibt nur das Profil zurück, das mit der angegebenen refId verknüpft ist. Die refId wurde bei der Profilerstellung oder vom /user-Endpunkt zurückgegeben.
hasActiveSocialAccounts
boolean
Standard:false
Wenn true, werden nur Profile mit mindestens einem verbundenen Social-Media-Konto zurückgegeben (Länge von activeSocialAccounts größer als null). Wenn false, werden nur Profile mit null verbundenen Social-Media-Konten zurückgegeben (Länge von activeSocialAccounts ist null).
includesActiveSocialAccounts
array
Filtert Profile so, dass diejenigen einbezogen werden, deren activeSocialAccounts alle in der Liste includesActiveSocialAccounts angegebenen Social-Media-Plattformen enthalten. Profile können zusätzlich zu den in includesActiveSocialAccounts aufgeführten weitere Plattformen in ihren activeSocialAccounts haben und dennoch in den gefilterten Ergebnissen enthalten sein.Werte: bluesky, facebook, gmb, instagram, linkedin, pinterest, reddit, snapchat, telegram, threads, tiktok, twitter, youtube.
isByokLinked
boolean
Filtert Profile nach dem BYOK-Migrationsstatus (Bring Your Own Key). Wenn true, werden nur Profile zurückgegeben, die die BYOK-Migration abgeschlossen haben. Wenn false, werden nur Profile zurückgegeben, die eine BYOK-fähige Plattform verbunden, aber noch nicht migriert haben. Profile ohne BYOK-fähige Plattform werden bei gesetztem Filter ausgeschlossen. Wenn weggelassen, werden alle Profile unabhängig vom BYOK-Status zurückgegeben. Aktuell gilt dies für X/Twitter BYOK.
actionLog
boolean
Standard:false
Gibt das User-Profile-Aktionsprotokoll (Create und Delete) der letzten 60 Tage sowie die für die Abrechnung verwendete Anzahl aktiver Nutzer der letzten 60 Tage zurück. Hinweis:
  • Aktionsprotokoll: Titel und Tags werden für Einträge des Aktionsprotokolls vor März 2025 nicht zurückgegeben.
  • User-Profile-Bericht: Der Zeitraum entspricht möglicherweise nicht Ihrem Abrechnungszeitraum. Beispielsweise kann Ihr Abrechnungszeitraum am 10. des Monats beginnen und enden. Details zum Abrechnungszeitraum und weitere Informationen finden Sie in Ihren Rechnungen.
Sie können einen abweichenden Zeitraum angeben, indem Sie actionLog auf eine Anzahl von Tagen setzen. Beispielsweise gibt der Query-Parameter actionLog=10 das Aktionsprotokoll der letzten 10 Tage sowie die gemeldete Anzahl aktiver Nutzer der letzten 10 Tage zurück. Der zulässige Zeitraum reicht von 1 Tag bis 365 Tage.
limit
number
Standard:5000
Begrenzt die Anzahl der zurückgegebenen Profile. Der Standard und das Maximum sind 5000.
cursor
string
Wenn weitere Profile zurückgegeben werden können und das Flag hasMore true ist, wird nextCursor in der Antwort zurückgegeben. Übergeben Sie diesen Cursor an den Query-Parameter cursor, um die nächste Menge an Profilen zurückzugeben.
include
string | array
Gibt erweiterte Profildaten zur Fehlersuche zurück. Erfordert den Parameter refId (Abruf eines einzelnen Profils).Werte (kommagetrennter String oder Array): suspension, socialHealth, linkingErrors, activity, quota, unlinkHistory, actionLog.
  • suspension – isSuspended, reason, suspendedAt, unsuspendAt, suspensionCount
  • socialHealth – Pro Plattform: linked, linkedAt, relinkRecommended, messagingEnabled, tokenExpiresAt
  • linkingErrors – Pro Plattform: code, message, details, createdAt
  • activity – Zeitstempel lastApiCall, lastPost
  • quota – used, limit
  • unlinkHistory – Letzte Trennung: platform, source (user/system), details, createdAt
  • actionLog – Profilaktionshistorie (create/update/delete)