Sincronización de estadísticas
Comprueba qué tan actualizadas están tus estadísticas por cuenta conectada, ve qué cuentas necesitan reconectarse y solicita una actualización justo después de publicar.
Las estadísticas se leen de cada plataforma según un horario, cada pocas horas según los límites de tasa de la plataforma. Dos endpoints te permiten ver en qué punto está eso y solicitar una actualización cuando no puedes esperar.
GET /api/v1/analytics/sync-status
GET /api/v1/analytics/sync-status
{
"accountGroupId": "ag_01j9x",
"syncInProgress": false,
"lastSyncedAt": "2026-09-08T06:12:41.000Z",
"historyHorizonAt": "2026-03-12T00:00:00.000Z",
"platforms": [
{
"platform": "INSTAGRAM",
"connectionId": "cmlxmnxn20006hzpzvo291ckg",
"accountName": "adaptlypost",
"status": "IDLE",
"lastSyncedAt": "2026-09-08T06:12:41.000Z",
"lastErrorMessage": null,
"historyHorizonAt": "2026-03-12T00:00:00.000Z",
"lastDiscoveryAt": "2026-09-08T06:10:03.000Z",
"needsAnalyticsReconnect": false
}
]
}| Field | Description |
|---|---|
| syncInProgress | True mientras alguna cuenta está en cola o sincronizándose |
| historyHorizonAt | Fecha más antigua para la que alguna cuenta tiene datos. Las fechas anteriores no tienen datos, no actividad cero |
| connectionId | El id de la cuenta de Cuentas de redes sociales |
| status | IDLE, QUEUED, SYNCING o FAILED |
| lastErrorMessage | Por qué falló la última sincronización, cuando falló |
| needsAnalyticsReconnect | True cuando la cuenta se conectó antes de que existieran los permisos de estadísticas |
Las cuentas en plataformas sin estadísticas (X) no aparecen en la lista.
Reconexión para estadísticas
Las plataformas sociales no permiten que una app añada permisos a una autorización ya existente. Una cuenta conectada antes de que AdaptlyPost pidiera acceso a las estadísticas se queda parada, sin sincronizaciones y sin errores, hasta que la persona dueña de la cuenta la reconecta y aprueba los permisos adicionales. Eso es lo que marca needsAnalyticsReconnect. Un enlace de conexión sirve para esto, así un agente o un cliente puede reconectar sin compartir una contraseña.
POST /api/v1/analytics/sync
POST /api/v1/analytics/sync
Sin cuerpo. Encola una sincronización para cada cuenta con estadísticas y vuelve a leer los últimos 7 días. Úsalo justo después de publicar, cuando la actualización programada queda demasiado lejos.
{
"queued": true,
"message": "Analytics sync queued. Fresh numbers will appear within a few minutes",
"cooldownSecondsRemaining": null
}Una ejecución por espacio de trabajo cada 10 minutos. Dentro del periodo de espera, la respuesta sigue siendo 200:
{
"queued": false,
"message": "Analytics were synced recently. Please try again in 412 seconds",
"cooldownSecondsRemaining": 412
}La ejecución es asíncrona. Consulta GET /api/v1/analytics/sync-status hasta que syncInProgress sea false, y luego vuelve a leer las métricas. No reintentes dentro del periodo de espera; la respuesta no cambiará.