Visão geral de estatísticas
Veja visualizações, curtidas, comentários, compartilhamentos, seguidores e taxa de engajamento de uma janela de datas, como total, por dia e por plataforma, cada um comparado com a janela anterior.
Três endpoints respondem "como fomos": um total, uma tendência, uma comparação entre plataformas. Os três leem os mesmos números. As estatísticas cobrem Facebook, Instagram, Threads, TikTok, Pinterest, Bluesky e YouTube nos últimos 180 dias. O X não tem estatísticas aqui, e as estatísticas do LinkedIn aguardam aprovação do LinkedIn, então os dois não retornam nada.
Parâmetros da janela
| Parameter | Description |
|---|---|
| from | Início da janela, ISO 8601. Obrigatório |
| to | Fim da janela, ISO 8601, não anterior a from. Obrigatório |
| platforms | Restringe a essas plataformas. Repita a chave para cada valor. Omita para cobrir todas as plataformas |
As métricas contam publicações feitas dentro da janela. Cada valor vem acompanhado da mesma métrica para a janela de mesma duração imediatamente anterior a from, então uma janela de 30 dias é comparada com os 30 dias anteriores a ela.
GET /api/v1/analytics/overview
GET /api/v1/analytics/overview?from=2026-08-01&to=2026-08-31&platforms=INSTAGRAM&platforms=TIKTOK
{
"views": { "value": 48210, "previousValue": 39100, "deltaPercent": 23.3 },
"likes": { "value": 2210, "previousValue": 1980, "deltaPercent": 11.6 },
"comments": { "value": 340, "previousValue": 410, "deltaPercent": -17.1 },
"shares": { "value": 128, "previousValue": null, "deltaPercent": null },
"followers": { "value": 12980, "previousValue": 12410, "deltaPercent": 4.6 },
"postsCount": { "value": 42, "previousValue": 37, "deltaPercent": 13.5 },
"avgViewsPerPost": { "value": 1147.9, "previousValue": 1056.8, "deltaPercent": 8.6 },
"engagementRate": { "value": 5.55, "previousValue": 6.11, "deltaPercent": -9.2 },
"partialMetrics": ["shares"],
"lastSyncedAt": "2026-09-08T06:12:41.000Z"
}| Field | Description |
|---|---|
| value | A métrica para a janela solicitada |
| previousValue | A mesma métrica para a janela anterior de mesma duração |
| deltaPercent | Variação de previousValue para value. Nulo quando o valor anterior é 0 ou desconhecido |
| followers | Contagem de seguidores mais recente em to, comparada com a contagem ao final da janela anterior |
| engagementRate | Curtidas, comentários e compartilhamentos divididos por visualizações, como porcentagem |
| partialMetrics | Métricas que pelo menos uma plataforma selecionada não consegue reportar. Seus totais cobrem apenas as plataformas que conseguem |
| lastSyncedAt | Sincronização bem-sucedida mais recente entre as plataformas selecionadas |
Uma métrica que nenhuma plataforma selecionada reporta é null. Isso significa "não medido", não zero.
GET /api/v1/analytics/timeseries
GET /api/v1/analytics/timeseries?from=2026-08-01&to=2026-08-31&granularity=WEEKLY
Adiciona granularity: DAILY (padrão), WEEKLY ou MONTHLY.
{
"points": [
{
"date": "2026-08-03T00:00:00.000Z",
"views": 11820,
"likes": 590,
"comments": 82,
"shares": 31,
"followers": 12520,
"postsCount": 10,
"engagementRate": 5.9
}
]
}date é o início do intervalo em UTC. followers é a contagem mais recente conhecida ao final do intervalo. Os outros contadores somam as publicações feitas dentro dele.
GET /api/v1/analytics/platform-breakdown
GET /api/v1/analytics/platform-breakdown?from=2026-08-01&to=2026-08-31
Recebe apenas from e to. Retorna { "platforms": [...] } com uma linha por plataforma que tem dados no espaço de trabalho. Cada linha traz as métricas da visão geral daquela plataforma, além de supportedMetrics, a lista de métricas que a plataforma reporta. Compare duas plataformas apenas nas métricas que ambas listam ali: uma linha do Pinterest com shares igual a null não está perdendo para o Instagram em compartilhamentos, ela simplesmente não os reporta.
Atualização
Os números são atualizados sozinhos a cada poucas horas. Se você acabou de publicar e quer os números agora, veja Sincronização de estatísticas.