API de análisesAPI

Leia as métricas de todas as redes em um único endpoint

O FoPost coleta dados de desempenho de cada conta conectada e os devolve em um formato consistente. Obtenha uma visão geral do espaço de trabalho, aprofunde em um post ou acompanhe uma conta ao longo do tempo e envie tudo para a ferramenta que você usa nos relatórios.

Obtenha sua chave de API Ler a documentação

GET /v1/analytics/overview

curl "https://api.fopost.com/v1/analytics/overview?workspace_id=9b2f6c1e-...&days=30" \
  -H "X-API-Key: $API_KEY"

{
  "total_accounts": 6,
  "total_followers": 42810,
  "total_posts": 86,
  "total_engagement": 9127,
  "total_impressions": 184320,
  "total_reach": 121904,
  "engagement_rate": 0.0749,
  "deltas": { "followers": 2.89, "posts": 12.5 },
  "today_stats": { "posts": 3, "follower_change": 41, "engagement": 312 },
  "platforms": [{ "platform": "linkedin", "accounts": 2, "followers": 18402 }]
}

Métricas normalizadas

Impressões, engajamento e seguidores usam os mesmos nomes de campos em todas as redes.

Três níveis

Visão geral do espaço de trabalho, um post ou uma conta.

Escopo somente leitura

Uma chave apenas com o escopo analytics pode ler números e nada mais.

Visão geral

Uma chamada para o relatório mensal

O endpoint de visão geral soma um espaço de trabalho em um intervalo de datas. Totais de impressões, engajamentos, variação de seguidores e posts publicados, para que um resumo semanal ou um relatório de cliente seja uma requisição e um modelo.

Ler a referência de análises

Contas conectadas em todas as redes em um único espaço de trabalho

Intervalos de datas

Envie days para uma janela móvel de até 365. As variações comparam com a janela anterior.

Filtre por conta

Restrinja a visão geral a uma conta quando um cliente perguntar sobre um canal.

Por espaço de trabalho

As chaves de agências são por espaço de trabalho do cliente, então os relatórios nunca se misturam.

Por post

Descubra qual post fez a diferença

Todo post que você cria pela API mantém seu id, e esse id retorna as métricas de cada rede em que ele foi publicado. Combine com seus próprios dados de campanha ou faça um ranking dos posts do mês e veja o que repetir.

Ver métricas por post

GET /v1/posts/:id/analytics

curl "https://api.fopost.com/v1/posts/7d3e0a52-.../analytics" \
  -H "X-API-Key: $API_KEY"

{
  "post_id": "7d3e0a52-...",
  "totals": { "impressions": 21050, "reach": 15230, "engagements": 1374, "likes": 501, "comments": 60, "shares": 71, "reposts": 0, "clicks": 721, "saves": 21, "video_views": 0, "follows": 12 },
  "platforms": [
    { "platform": "linkedin", "username": "yourbrand", "external_post_id": "urn:li:share:7301...", "permalink": "https://linkedin.com/feed/update/...", "metrics": { "impressions": 12840, "likes": 311, "comments": 42, "shares": 27, "clicks": 508 } },
    { "platform": "twitter", "username": "yourbrand", "external_post_id": "1830...", "permalink": "https://x.com/...", "metrics": { "impressions": 8210, "likes": 190, "comments": 18, "shares": 44, "clicks": 213 } }
  ],
  "last_fetched_at": "2026-09-02T09:00:00Z"
}

Detalhamento por conta

Um post, uma linha por rede, para você ver qual canal gerou o resultado.

Cliques e permalinks

Os cliques em links e o permalink ativo vêm junto com as contagens.

Agrupe por etiqueta

Liste os posts por etiqueta primeiro e depois leia as métricas do conjunto.

Por conta

Acompanhe o crescimento de cada canal ao longo do tempo

O endpoint de conta retorna uma série de snapshots de seguidores, alcance e visualizações do perfil. Use nos seus próprios gráficos, crie alertas para quedas ou mostre a um cliente a linha subindo ao lado dos posts que a fizeram subir.

Comece a construir

GET /v1/accounts/:id/analytics

curl "https://api.fopost.com/v1/accounts/4a71d80b-.../analytics?limit=7" \
  -H "X-API-Key: $API_KEY"

{
  "account_id": "4a71d80b-...",
  "platform": "linkedin",
  "username": "yourbrand",
  "history": [
    { "followers": 41651, "following": 210, "total_posts": 412, "reach": 6034, "profile_views": 341, "fetched_at": "2026-08-02T06:00:00Z" },
    { "followers": 41606, "following": 210, "total_posts": 411, "reach": 5120, "profile_views": 288, "fetched_at": "2026-08-01T06:00:00Z" }
  ]
}

Série de snapshots

Um ponto por coleta para seguidores, alcance e visualizações do perfil.

Crie seus próprios alertas

Consulte periodicamente e receba um aviso quando um canal sair da faixa normal.

O histórico é seu

Guarde a série no seu data warehouse pelo tempo que quiser.

Perguntas sobre API de análises, respondidas

De onde vêm os números?

FoPost lê as análises de cada rede usando as credenciais da conta conectada e depois normaliza os nomes dos campos. Os números correspondem ao que a rede informa no próprio painel.

Quão atualizados são os dados?

As métricas são atualizadas periodicamente para cada conta conectada. Um post publicado hoje mostra os primeiros números em poucas horas, e eles se estabilizam quando a rede finaliza as contagens.

Todas as redes informam as mesmas métricas?

O conjunto principal de impressões, engajamentos e seguidores é compartilhado. Métricas que uma rede não expõe retornam como null em vez de zero, para você distinguir ausente de vazio.

Posso obter métricas de posts publicados fora da API?

Sim. Qualquer post publicado pela conta conectada é acompanhado no nível da conta, e os posts criados no painel têm ids como qualquer outro.

De qual escopo eu preciso?

O escopo analytics. Uma chave só com esse escopo é somente leitura e não pode publicar, editar nem gerenciar contas.

Existe limite de requisições?

Sim, 100 solicitações por minuto por chave. Agrupe as leituras com intervalos de datas em vez de fazer uma chamada por dia.

Comece a construir com API de análises hoje

Começar é grátis e a API completa está incluída. Crie uma chave e faça sua primeira chamada em minutos.

Obtenha sua chave de API