Saltar al contenido principal
POST
Obtén analíticas y datos demográficos del perfil social de un usuario, como impresiones, vistas y seguidores. Actualmente disponible para Bluesky, Facebook Pages, Google My Business, Instagram, LinkedIn, Pinterest, Reddit, Snapchat, Threads, TikTok, X/Twitter y YouTube.
Facebook: Meta retiró algunas métricas de alcance y video (15 de junio de 2026). Meta eliminó las métricas de Insights de impresiones únicas y vistas de video (únicas) de 3 segundos en todas las versiones de Graph API, por lo que el objeto analytics de Facebook ya no devuelve la familia pagePostsImpressions* (pagePostsImpressions, pagePostsImpressionsPaid, pagePostsImpressionsUnique, pagePostsImpressionsOrganicUnique, pagePostsImpressionsViral*, pagePostsImpressionsNonviral*, pagePostsServedImpressionsOrganicUnique) ni pageVideoViewsUnique. Usa pageMediaView para el alcance (se planea un sucesor de Total Unique Media Views). pagePostEngagements, pageVideoViews y pageVideoViewsPaid no se ven afectados. Referencia: Próximos cambios en la API — 15 de junio de 2026.
  • Las analíticas de páginas de Facebook, como los datos demográficos, solo están disponibles en páginas con 100 o más me gusta. Facebook normalmente actualiza sus métricas una vez cada 24 horas.
  • Instagram puede tardar hasta 48 horas en calcular los datos analíticos. Las analíticas de recuento de seguidores no están disponibles con menos de 100 seguidores. Las métricas demográficas solo devuelven los 45 principales; únicamente se usan en los cálculos demográficos aquellos espectadores para los que tenemos datos demográficos, y los datos demográficos no se devuelven si el usuario de Instagram tiene menos de 100 interacciones en los últimos 30 días.
  • Al obtener analíticas sociales de Instagram, es posible que la información demográfica no aparezca en la respuesta para determinadas métricas. La información demográfica aparecerá cuando las métricas tengan más de 100 personas en cada segmentación. Consulta Advertencia sobre demografía en las analíticas de Instagram para más información.
  • LinkedIn admite tanto analíticas de páginas de empresa como analíticas de perfiles personales (miembros). Para los perfiles personales, el objeto analytics incluye un followersCount histórico, crecimiento diario de seguidores en followersDaily[] y métricas agregadas de publicación (impressionCount, uniqueImpressionsCount, likeCount, commentCount, shareCount). Los totales de count de LinkedIn son consistentes eventualmente, pero no de forma inmediata, y en algunos casos pueden tardar entre 24 y 48 horas. Los agregados shareCount, likeCount y commentCount para los perfiles personales son de mejor esfuerzo y pueden diferir ligeramente de los números mostrados en la interfaz de LinkedIn.
  • TikTok puede tardar entre 24 y 48 horas en actualizar sus datos analíticos, como visualizaciones de video, demografía, me gusta, compartidos y comentarios.
  • Consulta el endpoint de analíticas de publicación para obtener información adicional.

Parámetros de encabezado

Parámetros del cuerpo

platforms
array
requerido
Plataformas de redes sociales para obtener analíticas. Acepta un arreglo de cadenas con los valores:
quarters
integer
Especifica cuántos trimestres de datos históricos devolver. Un trimestre equivale a:
  • 85 días para Facebook
  • 90 días para Instagram, TikTok y YouTube
  • 90 días para Snapchat (limitado a 1 trimestre / máximo 90 días debido a las limitaciones de la API de Snapchat)
Disponible para las plataformas Facebook, Instagram, Snapchat, TikTok y YouTube. Valores válidos: 1–4. Solo los valores mayores que 0 activan el filtrado por fecha.Filtrado por fecha (Instagram y TikTok): El filtrado por fecha está activo cuando daily=true O quarters > 0. Si no se proporciona ni daily ni quarters, se devuelven los datos de todo el tiempo sin aplicar filtro de fecha.Nota: quarters: 0 ahora se trata como sin rango de fecha (datos de todo el tiempo). Anteriormente, quarters: 0 se trataba como quarters: 1.
daily
boolean
predeterminado:false
Cuando se establece en true, devuelve los datos analíticos como valores de series temporales diarias en lugar de totales agregados. Esta opción solo está disponible para las plataformas Facebook, Instagram, Snapchat, TikTok y YouTube. Debido al mayor tamaño de los datos, se recomienda usar compresión.Para Instagram y TikTok, establecer daily=true también activa el filtrado por fecha usando una ventana de trimestres más corta por defecto.Alcance en Instagram: Con daily=true, la respuesta de Instagram devuelve un objeto reach anidado (que contiene period y una serie temporal values) en lugar del campo escalar reachCount que se devuelve en modo no diario.
period60Days
boolean
predeterminado:false
Para las analíticas de TikTok, cuando se establece en true, devuelve solo los totales agregados de 60 días para comentarios, compartidos y visualizaciones (commentCountTotal, shareCountTotal, viewCountTotal). Esto ofrece tiempos de respuesta más rápidos en comparación con obtener el historial completo de analíticas. Nota: No uses este parámetro junto con daily=true, ya que son incompatibles.Importante: A partir del 1 de marzo de 2025, TikTok cambió a totales de 60 días. A partir de abril de 2026, TikTok usa un filtrado por fecha basado en trimestres — usa el parámetro quarters para controlar la ventana de fechas (por ejemplo, quarters: 1 = 90 días, quarters: 2 = 180 días). Consulta próximos cambios para más detalles.
youtube
object
Opciones específicas de la plataforma para las analíticas de YouTube.lifetime (booleano, predeterminado: false): cuando se establece en true, incluye lifetimeLikes en la respuesta: la suma de los me gusta de todos los videos públicos del canal. Se calcula obteniendo todos los videos y sumando sus conteos de me gusta, por lo que puede tardar más para canales con muchos videos.Umbral: los canales con más de 1000 videos devolverán lifetimeLikes: null y una advertencia en el arreglo de nivel superior warnings. Esto evita un uso excesivo de la API.Caché: por canal, con TTLs más cortos para los resultados sin éxito de modo que los reintentos capten los cambios de estado con prontitud:
  • Valor exitoso de lifetimeLikes: 24 horas.
  • Interrupción por 1000 videos (advertencia code: 445): 1 hora — lo suficientemente corta como para que un canal que elimine videos para bajar del umbral no tenga que esperar un día completo para obtener un valor real.
  • Fallos transitorios de la YouTube Data API (advertencia code: 446): no se almacena en caché — la siguiente solicitud reintenta.
Nota: los videos eliminados o privados se excluyen de la suma, por lo que el total puede diferir de los me gusta “reales” de por vida en canales que han eliminado videos.Ejemplo de solicitud:
userId
string
Solo X/Twitter. Este parámetro te permite obtener publicaciones de un usuario específico de X/Twitter por su ID numérico, en lugar de hacerlo desde tu cuenta vinculada.Por ejemplo, para obtener todas las publicaciones del handle @Google, usarías su userId numérico 20536157.Puedes encontrar el userId numérico de cualquier usuario de X/Twitter usando el endpoint Brands Get User.Nota: usa solo la API KEY en el encabezado para hacer esta solicitud. No incluyas la Profile Key.
userName
string
Solo X/Twitter. Este parámetro te permite obtener publicaciones de un usuario específico de X/Twitter por su handle, en lugar de hacerlo desde tu cuenta vinculada.Por ejemplo, para obtener todas las publicaciones del handle @Google.Nota: usa solo la API KEY en el encabezado para hacer esta solicitud. No incluyas la Profile Key.
Cuando las métricas acumulativas (por ejemplo, seguidores, me gusta) no están disponibles temporalmente en la red social, la API las completa automáticamente a partir de datos almacenados. Pueden aparecer dos campos opcionales en el objeto analytics por plataforma:
  • backfilledFrom (cadena, ISO 8601) — Presente cuando una o más métricas acumulativas fueron sustituidas por datos almacenados. La marca de tiempo indica cuándo se actualizaron por última vez los datos almacenados.
  • recoveredFrom (cadena, ISO 8601) — Presente cuando toda la respuesta de analíticas se recuperó de datos almacenados debido a una falla completa de la API. La marca de tiempo indica cuándo se actualizaron por última vez los datos almacenados.
Los datos almacenados con más de 4 días de antigüedad se consideran obsoletos y no se usarán para relleno ni recuperación.reactions de LinkedIn: la métrica acumulativa reactions a nivel de publicación (un objeto con conteos de reacciones por tipo) está sujeta a este relleno solo cuando está vacía. Cuando LinkedIn limita la tasa de la obtención de reacciones, el valor se mantiene desde la última instantánea exitosa — y backfilledFrom se establece con la marca de tiempo de esa instantánea — en lugar de regresar a vacío.
Analíticas personales (de miembro) de LinkedIn: se requiere volver a vincular. Los perfiles personales de LinkedIn vinculados antes del lanzamiento de las analíticas de miembros no cuentan con los permisos de analíticas requeridos. Las solicitudes de analíticas sociales para esos perfiles devuelven el código de error 475 (“vuelve a vincular tu perfil de LinkedIn para habilitar las analíticas”). El propietario de la cuenta debe volver a vincular su perfil de LinkedIn en la página de Cuentas sociales para otorgar los nuevos permisos. Espera unos minutos después de volver a vincular para que el código 475 desaparezca (tanto Ayrshare como LinkedIn almacenan brevemente el estado de los permisos, típicamente unos 5-10 minutos). La publicación no se ve afectada.
warnings (arreglo de objetos, campo opcional de nivel superior) — Presente solo cuando Ayrshare necesita informar al llamador de una condición no fatal (por ejemplo, se omitió un cálculo opcional). Está ausente de la respuesta cuando no hay nada de qué advertir.Cada entrada es un objeto estructurado, no una cadena libre:
CampoTipoDescripción
actioncadenaEl contexto de operación que produjo la advertencia (por ejemplo, "analytics").
statuscadenaSiempre "warning" para las entradas del arreglo warnings.
codenúmeroCódigo de advertencia estable de Ayrshare. Es seguro compararlo en el código del cliente.
messagecadenaDescripción legible por humanos.
detailscadenaContexto adicional opcional específico de esta instancia de advertencia.
Códigos de advertencia conocidos:
  • 445lifetimeLikes omitido porque el canal de YouTube supera el umbral de 1000 videos.
  • 446lifetimeLikes no disponible porque la YouTube Data API devolvió errores para la lista de reproducción de subidas o para cada lote de videos.list.