Saltar al contenido principal
POST
Obtén analíticas en tiempo real, como me gusta, impresiones, vistas y reacciones, para una publicación enviada mediante Ayrshare usando el ID de publicación de Ayrshare. Para analíticas de publicaciones originadas fuera de Ayrshare, consulta Analíticas por ID de publicación social.
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 de 3 segundos en todas las versiones de Graph API, por lo que el objeto analytics de Facebook ya no devuelve impressionsUnique, impressionsFanUnique, impressionsOrganicUnique, impressionsPaidUnique ni videoViewsUnique. Usa mediaView para el alcance (se planea un sucesor de Total Unique Media Views). Otros campos de uso común, como reactionsByType y videoViews, no se ven afectados. Referencia: Próximos cambios en la API — 15 de junio de 2026.

Información adicional

  • Actualmente se admiten las siguientes plataformas: Bluesky, Facebook Pages, Instagram, X/Twitter, LinkedIn, Pinterest, Reddit, Snapchat, Threads, TikTok y YouTube.
  • Los conteos de comentarios de Facebook e Instagram mostrados en la API pueden diferir de los que aparecen en las aplicaciones sociales. Esto ocurre por dos razones: - Algunos usuarios tienen configuraciones de privacidad que ocultan sus comentarios a no amigos o a usuarios sin conexiones mutuas. Estos comentarios privados siguen incluyéndose en el recuento total de comentarios. - Puede haber inconsistencias en los datos reportados por Meta.
  • Los valores de Instagram igReelsAggregatedAllPlaysCount y playsCount mostrados en la API pueden diferir de los conteos mostrados en las aplicaciones sociales. Esto puede ocurrir por varias razones:
    • La publicación fue promocionada. Solo se incluyen las reproducciones orgánicas en la respuesta de la API.
    • Puede haber inconsistencias en los datos reportados por Meta.
  • Los hilos (Threads) de X/Twitter se devuelven como un arreglo de objetos, con cada objeto correspondiente a un tuit del hilo.
  • YouTube puede tardar de 24 a 48 horas en procesar las analíticas de videos con pocas visualizaciones o pocos seguidores del canal.
  • Analíticas de TikTok:
    • TikTok puede tardar de 24 a 48 horas en actualizar sus datos analíticos, como visualizaciones de video, demografía, me gusta, compartidos y comentarios.
    • Para acceder a las analíticas de TikTok, los propietarios de la cuenta deben: 1. Publicar al menos un video. 2. Tocar el botón “Turn On” en la página de Analíticas de su aplicación móvil de TikTok. 3. Tener 100 seguidores para recibir información adicional sobre los espectadores y la interacción con el contenido.
    • TikTok no devuelve analíticas de la publicación si el contenido incluye material con derechos de autor o si ha sido marcado por una infracción de derechos de autor. Ejemplos de material con derechos de autor pueden incluir audio en reels (TikTok silenciará estos videos). Puedes verificarlo en la aplicación de TikTok en Actividad -> Notificaciones del sistema.
    • Algunos campos de analíticas de TikTok pueden no estar disponibles si el video ha estado inactivo por más de 7 días. Para recuperar estos datos, genera nueva actividad en el video (visualización, me gusta, comentario o compartido) y vuelve a intentarlo después de 24 a 48 horas. Si un video no se devuelve en la respuesta, la razón probable es que el video haya sido filtrado por infracciones, como una infracción de derechos de autor de música. Estos campos incluyen:
      • reach
      • fullVideoWatchedRate
      • totalTimeWatched
      • averageTimeWatched
      • impressionSources
      • audienceCountries
  • Los perfiles personales (miembros) de LinkedIn ahora devuelven una matriz ampliada de analíticas de publicación. Las métricas disponibles para miembros son:
    • impressionCount — Impresiones en la publicación
    • uniqueImpressionsCount — Miembros únicos alcanzados (LinkedIn MEMBERS_REACHED)
    • likeCount — Recuento de reacciones
    • commentCount — Recuento de comentarios
    • shareCount — Recompartidos de la publicación
    • engagement — Clics orgánicos, me gusta, comentarios y compartidos sobre impresiones
    • reactions — Desglose de reacciones por tipo (cuando hay reacciones)
    • Para publicaciones de video: videoViews, videoViewers y videoWatchTimeMs
    Las métricas de video solo se devuelven para publicaciones de video y no están disponibles más de un año después de que se creó la publicación.
  • Las estadísticas de Historias de Instagram solo están disponibles durante 24 horas, sin importar si las historias están archivadas o destacadas. Nota:
    • Las métricas de contenido de Historias con valores inferiores a 5 se devuelven como 0.
    • Para las Historias creadas por usuarios en Europa y Japón, la métrica replies devuelve un valor de 0.
  • Las analíticas de Historias de Facebook no están disponibles.
  • Los datos de analíticas de Pinterest (impresiones, seguidores del usuario y clics) están disponibles después de 24 a 72 horas.
  • Para YouTube Shorts, las visualizaciones devolverán el número de veces que un Short comienza a reproducirse o se reproduce nuevamente, sin requisito mínimo de tiempo de visualización.

Parámetros de encabezado

Parámetros del cuerpo

id
string
requerido
ID de publicación de Ayrshare devuelto por el endpoint /post. Este es el id de nivel superior devuelto por Ayrshare y no los IDs de publicación social en postIds.
platforms
array
Arreglo de cadenas con las plataformas de las que se quieren obtener analíticas. Acepta un arreglo de cadenas con los valores:
Si no se incluye platforms, se devolverán las analíticas de todas las redes sociales a las que se envió la publicación.
Cuando las métricas acumulativas (por ejemplo, me gusta, comentarios, visualizaciones) 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.
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 publicaciones de miembros no cuentan con los permisos de analíticas requeridos. Las solicitudes de analíticas 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.Los recuentos de publicaciones de miembros de LinkedIn son de mejor esfuerzo: los totales agregados de shareCount (RESHARE), likeCount (REACTION) y commentCount (COMMENT) pueden diferir ligeramente de los números mostrados en la interfaz de LinkedIn.