Profiles
Obtener User Profiles
Obtén todos los perfiles asociados al primary profile.
GET
Obtén todos los perfiles asociados al primary profile. El Primary Profile no se devuelve en los resultados.
Por motivos de seguridad, los Profile Keys no se devuelven mediante esta llamada GET. Consulta aquí para más información.
Parámetros de cabecera
Parámetros de consulta
Devuelve solo el perfil asociado al título codificado en URL.
Devuelve solo el perfil asociado al
refId indicado. El refId se devolvió durante la
creación del perfil o desde el endpoint /user.Si es
true, devuelve solo los perfiles que tienen al menos una cuenta social conectada
(longitud de activeSocialAccounts mayor que cero). Si es false, devuelve solo los perfiles con cero
cuentas sociales conectadas (longitud de activeSocialAccounts igual a cero).Filtra los perfiles para incluir aquellos cuyo
activeSocialAccounts contiene todas las plataformas de redes sociales especificadas en la lista includesActiveSocialAccounts. Los perfiles pueden tener plataformas adicionales en su activeSocialAccounts más allá de las incluidas en includesActiveSocialAccounts y aun así aparecer en los resultados filtrados.Valores: bluesky, facebook, gmb, instagram, linkedin, pinterest, reddit, snapchat, telegram, threads, tiktok, twitter, youtube.Filtra los perfiles por estado de migración a BYOK (Bring Your Own Key). Si es
true, devuelve solo los perfiles que han completado la migración BYOK. Si es false, devuelve solo los perfiles que tienen una plataforma elegible para BYOK conectada pero aún no han migrado. Los perfiles sin una plataforma elegible para BYOK se excluyen cuando este filtro está activo. Cuando se omite, se devuelven todos los perfiles independientemente del estado de BYOK. Actualmente se aplica a X/Twitter BYOK.Devuelve el historial del registro de acciones de creación y eliminación de User Profiles de los últimos 60 días y el recuento de usuarios activos utilizado para la facturación en los últimos 60 días. Nota:
- Action Log: no se devolverán el título ni las etiquetas para el historial del registro de acciones anterior a marzo de 2025.
- User Profile Report: el periodo de tiempo puede no corresponderse con tu periodo de facturación. Por ejemplo, tu periodo de facturación podría empezar y terminar el día 10 del mes. Consulta tus facturas para conocer el periodo de facturación y otros detalles.
actionLog=10 devolverá el registro de acciones de los últimos 10 días y el recuento de usuarios activos reportado
de los últimos 10 días. El periodo permitido es de 1 día a 365 días.Limita el número de perfiles devueltos. El valor predeterminado y máximo es 5000.
Si hay más perfiles por devolver y el flag
hasMore es true, se devolverá nextCursor en la respuesta.
Pasa este cursor al parámetro de consulta cursor para obtener el siguiente conjunto de perfiles.Devuelve datos ampliados del perfil para la resolución de problemas. Requiere el parámetro
refId (búsqueda de un único perfil).Valores (cadena separada por comas o array): suspension, socialHealth, linkingErrors, activity, quota, unlinkHistory, actionLog.suspension- isSuspended, reason, suspendedAt, unsuspendAt, suspensionCountsocialHealth- por plataforma: linked, linkedAt, relinkRecommended, messagingEnabled, tokenExpiresAtlinkingErrors- por plataforma: code, message, details, createdAtactivity- timestamps de lastApiCall y lastPostquota- used, limitunlinkHistory- última desvinculación: platform, source (user/system), details, createdAtactionLog- historial de acciones del perfil (create/update/delete)
