Profiles
User Profiles abrufen
Rufen Sie alle Profile ab, die mit dem Primary Profile verknüpft sind.
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
Gibt nur das Profil zurück, das mit dem URL-kodierten Titel verknüpft ist.
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.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).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.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.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.
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.Begrenzt die Anzahl der zurückgegebenen Profile. Der Standard und das Maximum sind 5000.
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.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, suspensionCountsocialHealth– Pro Plattform: linked, linkedAt, relinkRecommended, messagingEnabled, tokenExpiresAtlinkingErrors– Pro Plattform: code, message, details, createdAtactivity– Zeitstempel lastApiCall, lastPostquota– used, limitunlinkHistory– Letzte Trennung: platform, source (user/system), details, createdAtactionLog– Profilaktionshistorie (create/update/delete)
