Skip to main content
GET
Este endpoint recupera información detallada sobre el usuario autenticado o el user profile, incluyendo:
  • Una lista completa de todas las cuentas de redes sociales vinculadas
  • Nombres de usuario e información de perfil de las redes sociales
  • Estado de la cuenta y métricas de uso
Los datos devueltos reflejan el estado de las redes sociales conectadas en el momento de la última actualización, y se actualizan cada vez que los usuarios conectan o desconectan sus cuentas de redes sociales.
Caché de respuestas. Las respuestas se almacenan en caché hasta 60 segundos. Los campos lastUpdated y nextUpdate describen esa ventana de caché: lastUpdated es el momento en que se generó la instantánea, nextUpdate es cuando expira.nextUpdate es un marcador de expiración de caché, no una señal de disponibilidad. Se incluye en cada respuesta, incluso en aquellas cuyo displayNames aún no lista una cuenta sobre la que acabas de recibir una notificación, por lo que no puede indicarte cuándo una cuenta recién vinculada ha terminado de propagarse.Si estás reconciliando un webhook de social para un vínculo recién creado, sondea hasta que la cuenta que esperas realmente aparezca en displayNames — no trates una única respuesta, ni la llegada de nextUpdate, como confirmación de que el vínculo está ausente o completo.
username frente a displayName en Threads. En una entrada de Threads de displayNames, username es el identificador (handle) de la cuenta (por ejemplo, ayrshare). displayName es el nombre que se muestra en el perfil (por ejemplo, Ayrshare). Pueden ser distintos, así que usa username o profileUrl para encontrar la cuenta de Threads.
Si no hay cuentas sociales vinculadas, no se devolverá activeSocialAccounts. Obtén los datos de un User Profile concreto añadiendo el Profile-Key en la cabecera.
  • Si tu negocio necesita obtener todos los datos de user profile de una sola vez, utiliza el endpoint /user/batch.
  • Si necesitas una notificación cuando un usuario vincule o desvincule una cuenta social, consulta el endpoint /webhooks.

Parámetros de cabecera

Parámetros de consulta

boolean
predeterminado:false
Devuelve detalles adicionales de Instagram como el tipo de cuenta (business o creator) y la quota usada. No se recomienda a menos que necesites los datos adicionales, ya que ralentizará el tiempo de respuesta.

Cuota mensual de publicaciones

La respuesta muestra cuánto se ha usado de la cuota mensual de publicaciones del perfil:
  • monthlyPostCount: publicaciones contadas en la cuota este mes.
  • monthlyPostQuota: el límite mensual. Se omite cuando la cuota es de 10.000 o más, por ejemplo en los planes Business. El límite sigue aplicándose.
El contador se reinicia el día 1 de cada mes a las 00:07 UTC, no en tu fecha de facturación. Los intentos de publicación fallidos también cuentan. monthlyApiCalls es un contador distinto y no es la cuota de publicaciones. Consulta ¿Cuántas publicaciones y llamadas a la API puedo hacer? para saber qué cuenta y qué ocurre cuando se agota la cuota.