Synupv1
Criar chave
v1Recursos/Posts/getObter análises de publicações

Obter análises de publicações

Retorna um resumo de análises de engajamento — totais agregados, uma divisão por plataforma, séries de tendência e as principais publicações — nas conexões de plataforma em nível de marca de um cliente.

get/api/v1/posts/analytics
posts:read
Parâmetros de consulta
clientIdstringobrigatório
O cliente a ser agregado. Obrigatório.
fromstringopcional
Início do período do relatório. O padrão é 30 dias atrás.
tostringopcional
Fim do período do relatório. O padrão é agora.
Resposta
dataobjectopcional
summaryobjectopcional
Totais de engajamento do período atual.
totalPostsnumberopcional
Número de publicações neste período.
totalViewsnumberopcional
Total de visualizações neste período.
totalReactionsnumberopcional
Total de reações neste período.
totalSharesnumberopcional
Total de compartilhamentos neste período.
totalCommentsnumberopcional
Total de comentários neste período.
periodDaysnumberopcional
Duração do período do relatório, em dias.
prevSummaryobjectopcional
Totais de engajamento do período comparável imediatamente anterior, para comparação de variação.
totalPostsnumberopcional
Número de publicações neste período.
totalViewsnumberopcional
Total de visualizações neste período.
totalReactionsnumberopcional
Total de reações neste período.
totalSharesnumberopcional
Total de compartilhamentos neste período.
totalCommentsnumberopcional
Total de comentários neste período.
byPlatformarray of objectopcional
Totais de engajamento detalhados por plataforma para este período.
platformstringopcional
A plataforma a que esta linha se refere.
labelstringopcional
Nome de exibição da plataforma.
totalPostsnumberopcional
Número de publicações neste período.
totalViewsnumberopcional
Total de visualizações neste período.
totalReactionsnumberopcional
Total de reações neste período.
totalSharesnumberopcional
Total de compartilhamentos neste período.
totalCommentsnumberopcional
Total de comentários neste período.
prevByPlatformarray of objectopcional
Totais de engajamento detalhados por plataforma para o período anterior.
platformstringopcional
A plataforma a que esta linha se refere.
labelstringopcional
Nome de exibição da plataforma.
totalPostsnumberopcional
Número de publicações neste período.
totalViewsnumberopcional
Total de visualizações neste período.
totalReactionsnumberopcional
Total de reações neste período.
totalSharesnumberopcional
Total de compartilhamentos neste período.
totalCommentsnumberopcional
Total de comentários neste período.
trendobjectopcional
Contagens diárias de visualizações por plataforma ao longo do período.
datesarray of stringopcional
As datas cobertas por esta tendência, como strings YYYY-MM-DD.
seriesarray of objectopcional
Uma entrada por plataforma.
platformstringopcional
A plataforma a que esta linha se refere.
labelstringopcional
Nome de exibição da plataforma.
valuesarray of numberopcional
Um valor por data em dates, na mesma ordem.
engagementTrendobjectopcional
Visualizações, reações, compartilhamentos, comentários e alcance diários por plataforma ao longo do período.
datesarray of stringopcional
As datas cobertas por esta tendência, como strings YYYY-MM-DD.
seriesarray of objectopcional
Uma entrada por plataforma.
platformstringopcional
A plataforma a que esta linha se refere.
labelstringopcional
Nome de exibição da plataforma.
viewsarray of numberopcional
reactionsarray of numberopcional
sharesarray of numberopcional
commentsarray of numberopcional
reacharray of numberopcional
Valores diários de alcance, na mesma ordem que dates.
postsTrendobjectopcional
Contagens diárias de envios de publicações por plataforma ao longo do período.
datesarray of stringopcional
As datas cobertas por esta tendência, como strings YYYY-MM-DD.
seriesarray of objectopcional
Uma entrada por plataforma.
platformstringopcional
A plataforma a que esta linha se refere.
labelstringopcional
Nome de exibição da plataforma.
valuesarray of numberopcional
Um valor por data em dates, na mesma ordem.
allPostsarray of objectopcional
Os envios individuais dos quais este resumo é construído, ordenados por visualizações.
submissionIdstringopcional
Identificador único do envio à plataforma.
platformstringopcional
A plataforma a que esta linha se refere.
platformPostIdstringopcional
O id próprio da plataforma para a publicação publicada, ou null.
postLinkstringopcional
URL pública da publicação publicada nesta plataforma, ou null.
publishedAtstringopcional
Quando este envio foi publicado, como timestamp ISO 8601, ou null.
contentPreviewstringopcional
O nome da publicação, para exibição.
totalViewsnumberopcional
Total de visualizações neste período.
totalReactionsnumberopcional
Total de reações neste período.
totalSharesnumberopcional
Total de compartilhamentos neste período.
totalCommentsnumberopcional
Total de comentários neste período.
totalReachnumberopcional
Alcance total deste envio.
engRatenumberopcional
Taxa de engajamento — reações mais compartilhamentos mais comentários, como percentual das visualizações — ou null se ainda não houver visualizações.
Erros
400Falta um parâmetro obrigatório na solicitação, ou ela é inválida de outra forma.
401Chave de API ausente, inválida, expirada ou revogada.
403A chave não tem a permissão exigida, ou não está autorizada para este cliente/local.
429Muitas solicitações. Tente novamente após o número de segundos indicado no cabeçalho Retry-After.
get/api/v1/posts/analytics
Sua chave de API
clientId *
from
to
{
  "data": {
    "summary": {
      "totalPosts": 18,
      "totalViews": 5400,
      "totalReactions": 320,
      "totalShares": 44,
      "totalComments": 61,
      "periodDays": 30
    },
    "prevSummary": {
      "totalPosts": 14,
      "totalViews": 4100,
      "totalReactions": 260,
      "totalShares": 30,
      "totalComments": 48
    },
    "byPlatform": [
      {
        "platform": "facebook",
        "label": "Facebook",
        "totalPosts": 10,
        "totalViews": 3200,
        "totalReactions": 210,
        "totalShares": 30,
        "totalComments": 40
      },
      {
        "platform": "instagram",
        "label": "Instagram",
        "totalPosts": 8,
        "totalViews": 2200,
        "totalReactions": 110,
        "totalShares": 14,
        "totalComments": 21
      }
    ],
    "prevByPlatform": [
      {
        "platform": "facebook",
        "label": "Facebook",
        "totalPosts": 8,
        "totalViews": 2500,
        "totalReactions": 170,
        "totalShares": 20,
        "totalComments": 32
      }
    ],
    "trend": {
      "dates": [
        "2026-01-15",
        "2026-01-16"
      ],
      "series": [
        {
          "platform": "facebook",
          "label": "Facebook",
          "values": [
            4,
            6
          ]
        }
      ]
    },
    "engagementTrend": {
      "dates": [
        "2026-01-15",
        "2026-01-16"
      ],
      "series": [
        {
          "platform": "facebook",
          "label": "Facebook",
          "views": [
            180,
            210
          ],
          "reactions": [
            12,
            15
          ],
          "shares": [
            2,
            3
          ],
          "comments": [
            4,
            5
          ],
          "reach": [
            900,
            1100
          ]
        }
      ]
    },
    "postsTrend": {
      "dates": [
        "2026-01-15",
        "2026-01-16"
      ],
      "series": [
        {
          "platform": "facebook",
          "label": "Facebook",
          "values": [
            1,
            2
          ]
        }
      ]
    },
    "allPosts": [
      {
        "submissionId": "cm_sub_xyz789",
        "platform": "facebook",
        "platformPostId": "1234567890",
        "postLink": "https://www.facebook.com/1234567890",
        "publishedAt": "2026-01-16T14:00:00.000Z",
        "contentPreview": "Join us this weekend for our fall special — 20% off all services!",
        "totalViews": 890,
        "totalReactions": 42,
        "totalShares": 6,
        "totalComments": 9,
        "totalReach": 1450,
        "engRate": 0.064
      }
    ]
  }
}