Estatísticas por publicação
Visualizações, curtidas, comentários, compartilhamentos, salvamentos, alcance e engajamento por publicação de tudo que foi publicado em uma janela, ordenável por qualquer métrica, além das publicações que o AdaptlyPost encontrou nas suas contas mas não publicou.
As estatísticas por publicação respondem "como essa publicação se saiu" e "quais publicações se saíram melhor". Elas cobrem publicações feitas através do AdaptlyPost e publicações descobertas nas contas conectadas, então uma publicação feita no aplicativo nativo da rede ainda aparece com seus números.
Isso é desempenho, não entrega. Resultados da Publicação informa se uma publicação chegou a cada plataforma; este endpoint informa o que aconteceu depois disso.
GET /api/v1/analytics/posts
GET /api/v1/analytics/posts?from=2026-08-01&to=2026-08-31&sortBy=VIEWS&page=1&limit=20
| Parameter | Description |
|---|---|
| from, to | A janela, ISO 8601. As publicações são selecionadas pela data de publicação. Obrigatório |
| platforms | Restringe a essas plataformas. Repita a chave para cada valor |
| sortBy | VIEWS, LIKES, COMMENTS, SHARES, SAVES, CLICKS, IMPRESSIONS, ENGAGEMENT_RATE ou PUBLISHED_AT (padrão). Decrescente |
| page | Número da página, a partir de 1 |
| limit | Publicações por página, de 1 a 100, padrão 20 |
{
"posts": [
{
"id": "ap_01j9xk4",
"postId": "cmm0z0k3q0000i0r5mxn0hfhs",
"postPlatformId": "cmm0z0k3u0001i0r5dlbfa440",
"platform": "INSTAGRAM",
"publishedAt": "2026-08-14T10:00:12.000Z",
"title": "Plan a week of posts in one sitting",
"thumbnailUrl": "https://cdn.adaptlypost.com/...",
"permalink": "https://www.instagram.com/p/...",
"accountName": "adaptlypost",
"metrics": {
"views": 9120,
"likes": 410,
"comments": 38,
"shares": 22,
"saves": 61,
"clicks": null,
"impressions": 10230,
"reach": 8540,
"engagementRate": 5.15
}
}
],
"total": 42,
"page": 1,
"limit": 20,
"hasMore": true
}| Field | Description |
|---|---|
| id | ID do registro de estatísticas. O único id que toda publicação rastreada tem |
| postId | O id da publicação no AdaptlyPost, utilizável com Obter Publicação. Nulo para uma publicação descoberta na conta |
| postPlatformId | O platformId de Resultados da Publicação. Nulo para publicações descobertas |
| permalink | URL pública da publicação na plataforma, quando conhecida |
| metrics | Contadores mais recentes capturados. Uma métrica que a plataforma não reporta é nula |
GET /api/v1/analytics/top-posts
GET /api/v1/analytics/top-posts?from=2026-08-01&to=2026-08-31&sortBy=ENGAGEMENT_RATE&limit=5
As mesmas linhas sem paginação: as limit publicações principais (1 a 50, padrão 10) ordenadas por sortBy (padrão VIEWS). Retorna { "posts": [...] }.
GET /api/v1/analytics/discovered-posts
GET /api/v1/analytics/discovered-posts?from=2026-08-01&to=2026-08-31&limit=200
Publicações encontradas nas contas conectadas que o AdaptlyPost não publicou, para um calendário somente leitura. As métricas delas estão em /analytics/posts; este endpoint retorna a publicação em si.
{
"posts": [
{
"id": "ap_01j9xk9",
"platform": "TIKTOK",
"publishedAt": "2026-08-20T17:30:00.000Z",
"text": "Behind the scenes of our launch week",
"thumbnailUrl": "https://cdn.adaptlypost.com/...",
"permalink": "https://www.tiktok.com/@adaptlypost/video/...",
"accountName": "adaptlypost"
}
]
}limit aceita de 1 a 1000 e o padrão é 200.
Até quando o histórico vai
Nada publicado há mais de 180 dias é listado, em nenhuma plataforma. Algumas plataformas expõem menos histórico para uma determinada conta; Sincronização de estatísticas informa o horizonte exato por conta.