Saltar al contenido principal
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

title
string
Devuelve solo el perfil asociado al título codificado en URL.
refId
string
Devuelve solo el perfil asociado al refId indicado. El refId se devolvió durante la creación del perfil o desde el endpoint /user.
hasActiveSocialAccounts
boolean
predeterminado:false
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).
includesActiveSocialAccounts
array
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.
isByokLinked
boolean
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.
actionLog
boolean
predeterminado:false
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.
Puedes especificar un periodo de tiempo diferente estableciendo actionLog a un número de días. Por ejemplo, el parámetro de consulta 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.
limit
number
predeterminado:5000
Limita el número de perfiles devueltos. El valor predeterminado y máximo es 5000.
cursor
string
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.
include
string | array
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, suspensionCount
  • socialHealth - por plataforma: linked, linkedAt, relinkRecommended, messagingEnabled, tokenExpiresAt
  • linkingErrors - por plataforma: code, message, details, createdAt
  • activity - timestamps de lastApiCall y lastPost
  • quota - used, limit
  • unlinkHistory - última desvinculación: platform, source (user/system), details, createdAt
  • actionLog - historial de acciones del perfil (create/update/delete)