API de analytics de redes sociais: as métricas que você realmente consegue puxar

Cada plataforma expõe métricas diferentes, em janelas diferentes, com definições diferentes. O Instagram dá reach e views, o TikTok não dá reach, o YouTube devolve totais acumulados, o LinkedIn guarda 12 meses. Uma API de analytics de redes sociais é sobretudo o trabalho de reconciliar isso. Aqui está o que cada plataforma devolve de verdade, verificado em 21 de outubro de 2026.

O que uma API de analytics devolve, e o que nunca vai devolver

Três coisas valem para toda API de plataforma desta lista. Elas devolvem contagens, não motivos. Elas devolvem o seu próprio conteúdo, não o do seu concorrente. E elas devolvem o que a plataforma decidiu calcular, que raramente é o que você teria calculado.

O último ponto é o que custa semanas. Não existe uma definição compartilhada de view, impression ou reach entre essas APIs. O Instagram marca reach e accounts_engaged como estimadas. O YouTube não tem nenhuma métrica chamada impressions, só adImpressions para publicidade, mais as impressões de anotações e cards. O LinkedIn te dá impressionCount e uniqueImpressionsCount, que são duas ideias diferentes com nomes parecidos. Qualquer total multiplataforma que você montar é uma opinião, e você deveria registrar essa opinião em algum lugar onde o seu eu futuro vá encontrar.

API de analytics do Instagram: impressions acabou, views tomou o lugar

Se você está migrando uma integração antiga, esta é a mudança que quebra. Na referência de insights de usuário do Instagram, impressions está marcada como obsoleta, para a v22.0 e depois para todas as versões desde 21 de abril de 2025. A métrica que carrega a mesma intenção agora é views, descrito como o número de vezes que o seu conteúdo foi reproduzido ou exibido.

O que o endpoint no nível da conta te dá hoje: views, reach, accounts_engaged, total_interactions, likes, comments, shares, saves, replies, reposts, follows_and_unfollows, profile_links_taps, mais follower_demographics e engaged_audience_demographics por idade, cidade, país ou gênero.

Os limites importam mais do que a lista:

• Omita since e until e você recebe as últimas 24 horas, não tudo.
• As métricas demográficas usam timeframe, por exemplo last_90_days, que tem prioridade sobre since e until.
• online_followers cobre só os últimos 30 dias.
• Os dados podem atrasar até 48 horas, e os insights levam cerca de 24 horas para assentar, então um número lido uma hora depois de publicar vai mudar.
• Várias métricas simplesmente não estão disponíveis para contas com menos de 100 seguidores, e indisponível quer dizer um conjunto de dados vazio, não um zero.
• Os dados de métricas de conta ficam guardados por cerca de 90 dias.

Essa última dupla é a razão de os seus gráficos terem buracos em vez de linhas planas. Para o resto da superfície do Instagram, veja a Instagram Graph API em 2026.

O que cada plataforma expõe

As capacidades por plataforma abaixo são as que o coletor da PlugKit lê, verificadas em docs.plugkit.co em 21 de outubro de 2026 e cruzadas com a referência de cada plataforma onde ela é pública.

Quatro detalhes se esconderam atrás dessa tabela.

O YouTube devolve totais acumulados, não uma série diária. A lista de métricas do YouTube Analytics é longa, com estimatedMinutesWatched, averageViewDuration, audienceWatchRatio e métricas de receita, mas obter o detalhe diário exige uma auditoria separada do Google. Sem isso você recebe um número acumulado e precisa derivar por conta própria.

O TikTok precisa de scopes que não valem retroativamente. video.list e user.info.stats são obrigatórios, e uma conta conectada antes de você pedir esses scopes mostra gráficos vazios até a pessoa reconectar.

O LinkedIn guarda 12 meses móveis e só o orgânico. O endpoint de estatísticas de publicações de organização devolve dados dos últimos 12 meses, em granularidade DAY ou MONTH, e não conta atividade patrocinada. As estatísticas de todo o período vêm de omitir timeIntervals; consultas por publicação não suportam estatísticas com recorte de tempo de jeito nenhum. Uma nota de calendário: a versão Marketing 202511 está anunciada para desligar em 16 de novembro de 2026, então fixe uma versão atual.

O X cobra por leitura. É a única plataforma aqui em que puxar analytics tem linha na fatura. A PlugKit repassa as chamadas a custo, $0.005 para ler um post e $0.010 para ler um usuário, com um teto de gasto padrão de $20 por mês em cada conta até você definir o seu. A documentação deles coloca uma conta do X consultada a cada hora em até $360 por mês, que é a ordem de grandeza certa antes de montar um dashboard minuto a minuto. Os rate limits por trás disso estão reunidos em rate limits de APIs de redes sociais.

Por que duas ferramentas nunca mostram o mesmo número

• Momento da leitura. Métricas guardadas são leituras feitas em um instante. Duas ferramentas que consultam em momentos diferentes uma métrica que ainda assenta se contradizem honestamente.
• Assentamento. Os insights do Instagram levam cerca de 24 horas para fechar. Os números iniciais não estão errados, estão iniciais.
• Estimativa. reach e accounts_engaged são estimados pelo próprio Instagram. Estimativas são revisadas.
• Null não é zero. O TikTok não tem reach, o YouTube não tem impressions. Um pipeline que transforma o ausente em 0 inventa uma queda que nunca aconteceu. A PlugKit devolve null nesses casos e marca uma janela recortada com "clamped": true, e é o comportamento que você quer também no que construir.

API de analytics multiplataforma: construir ou comprar

Construir significa um fluxo OAuth e um vocabulário de métricas por plataforma, um poller por idade de conteúdo, um armazenamento, e uma história de backfill que você não consegue cumprir, porque o histórico de seguidores começa no dia em que a conta é conectada e ninguém consegue preencher depois.

Comprar significa aceitar a cadência de coleta de outra pessoa. A da PlugKit é publicada, e essa é a parte que vale copiar: novas publicações descobertas a cada 6 horas no Creator e a cada 90 minutos no Pro; publicações com menos de 48 horas atualizadas a cada hora no Creator e a cada 30 minutos no Pro; com menos de 30 dias a cada 6 horas ou a cada hora; as mais antigas uma vez por semana; contagem de seguidores todos os dias; tudo acima de 180 dias congelado na última leitura. O histórico legível é de 90 dias no Creator e 550 no Pro, e como os dados são registrados independentemente do plano, subir de plano revela um histórico que você já tinha.

Os endpoints de leitura são /v1/analytics/summary, /posts, /timeseries, /platforms, /best-times, /accumulation e /followers, e nenhum deles chama uma plataforma na hora da requisição. Cada resposta traz lastSyncAt e nextSyncAt, para você poder mostrar a idade dos dados em vez de fingir que está ao vivo. POST /v1/analytics/sync força uma atualização, e chamadas repetidas na mesma conta dentro de 15 segundos são ignoradas.

Analytics estão incluídos em todos os planos e nos 7 dias grátis sem cartão, com uma conta conectada durante o teste. As chamadas pagas do X seguem bloqueadas durante o teste, que é o padrão sensato. A PlugKit custa $49 por mês para 5 contas conectadas, cancela quando quiser. Se você só precisa publicar, sem números, o comparativo em o guia de APIs de redes sociais é o melhor ponto de partida, e se o que você quer de verdade são DMs e comentários em um só lugar, isso é uma caixa de entrada de redes sociais, não uma API de analytics.

Perguntas frequentes

Existe uma API única para todos os analytics de redes sociais?

Das plataformas, não. Cada uma mantém a própria API, nomes de métricas e janelas. Uma API de analytics unificada é sempre uma camada em cima que normaliza essas diferenças, e essa normalização é um critério que você deveria conseguir inspecionar.

A API de analytics do Instagram ainda devolve impressions?

Não. impressions está obsoleta, para a v22.0 e depois para todas as versões desde 21 de abril de 2025. Use views. Reach continua lá e vem marcado como estimado pelo próprio Instagram.

Até onde eu consigo puxar métricas de redes sociais?

Depende da plataforma e da ferramenta. As estatísticas de publicações do LinkedIn cobrem 12 meses móveis. Os insights de conta do Instagram ficam guardados por cerca de 90 dias. O histórico de seguidores só pode começar no dia em que a conta foi conectada, então conecte as contas antes de precisar do histórico.

Por que meus números da API diferem dos números no app?

Porque foram lidos em momentos diferentes, e porque algumas métricas assentam por cerca de 24 horas depois da publicação. Confira o timestamp de sincronização na resposta antes de tratar uma diferença como bug.

Um agente de IA pode ler essas métricas direto?

Sim, se você der as ferramentas. Por um servidor MCP as leituras de analytics viram ferramentas que o agente chama, então uma pergunta como o melhor horário para publicar por conta é respondida pelos mesmos endpoints. O compromisso entre dar a um agente ferramentas MCP ou uma API REST está em MCP ou API REST para o seu agente.

AB

Antoine BlancoFundador da PlugKit. Gerencia as próprias contas de Instagram, YouTube e X pela API e pelo servidor MCP descritos aqui.