Estatísticas por publicação

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

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
connectionIds	Restringe a estas contas, pelo `id` em Contas de redes sociais. 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",
      "connectionId": "conn_ig_001",
      "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
connectionId	A conta a que a publicação pertence: o seu `id` em Contas de redes sociais
accountName	Nome de exibição dessa conta, em todas as plataformas
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

Publicações do Perfil da Empresa no Google aparecem com métricas null: o Perfil da Empresa no Google informa impressões só do local, não por publicação.

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": [...] }. Aceita os mesmos filtros platforms e connectionIds.

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",
      "connectionId": "conn_tt_001",
      "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. Filtre-o com platforms e connectionIds da mesma forma.

Até quando o histórico vai

Ao conectar uma conta, as publicações dela dos últimos 180 dias são importadas, e as estatísticas são mantidas a partir daí enquanto a conta continuar conectada. Uma publicação continua sendo atualizada por 180 dias depois de publicada e depois mantém os últimos números. Algumas plataformas expõem menos histórico para uma determinada conta; Sincronização de estatísticas informa o horizonte exato por conta.