Sincronização de estatísticas

Permissão: analytics.read. Veja Papéis e permissões.

GET /api/v1/analytics/sync-status exige analytics.read; POST /api/v1/analytics/sync exige analytics.sync (Administrador e Editor).

As estatísticas são lidas de cada plataforma em um cronograma, a cada poucas horas dependendo dos limites de taxa da plataforma. Dois endpoints permitem ver como está essa situação e pedir uma atualização quando você não pode 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	Verdadeiro enquanto qualquer conta estiver na fila ou sincronizando
historyHorizonAt	Data mais antiga para a qual alguma conta tem dados. Datas anteriores não têm dados, e não atividade zero
connectionId	O `id` da conta em Contas de redes sociais
status	`IDLE`, `QUEUED`, `SYNCING` ou `FAILED`
lastErrorMessage	Por que a última sincronização falhou, quando falhou
needsAnalyticsReconnect	Verdadeiro quando a conta foi conectada antes de existirem as permissões de estatísticas

Contas em plataformas sem estatísticas (Mastodon, Telegram e Tumblr) não são listadas.

Reconectando para estatísticas

As plataformas sociais não permitem que um aplicativo adicione permissões a uma autorização já concedida. Uma conta conectada antes de o AdaptlyPost pedir acesso às estatísticas fica parada, sem sincronizações e sem erros, até que o dono dela reconecte e aprove as permissões extras. É isso que needsAnalyticsReconnect sinaliza. Um link de conexão resolve isso, permitindo que um agente ou um cliente reconecte sem compartilhar uma senha.

POST /api/v1/analytics/sync

POST /api/v1/analytics/sync

Sem corpo. Enfileira uma sincronização para cada conta com estatísticas e relê os últimos 7 dias. Use logo após publicar, quando a atualização programada está longe demais.

{
  "queued": true,
  "message": "Analytics sync queued. Fresh numbers will appear within a few minutes",
  "cooldownSecondsRemaining": null
}

Uma execução por espaço de trabalho a cada 10 minutos. Dentro do período de espera, a resposta ainda é 200:

{
  "queued": false,
  "message": "Analytics were synced recently. Please try again in 412 seconds",
  "cooldownSecondsRemaining": 412
}

A execução é assíncrona. Consulte GET /api/v1/analytics/sync-status até que syncInProgress seja false, depois leia as métricas novamente. Não tente novamente dentro do período de espera; a resposta não vai mudar.