Insights de publicações do Facebook pela API: visualizações, alcance e engajamento
Os insights de publicações do Facebook vêm de GET /{page-post-id}/insights com métricas como post_media_view, as vezes em que a publicação foi reproduzida ou exibida, post_total_media_view_unique, seus visualizadores únicos, post_clicks e post_reactions_by_type_total. A Meta descontinuou post_impressions em novembro de 2025 e post_impressions_unique em junho de 2026, então visualizações e visualizadores únicos agora substituem impressões e alcance.
O easyCoexistence lê os insights de publicações do Facebook com get_social_insights, para que Claude, ChatGPT ou seu próprio código possam perguntar como uma publicação foi e receber de volta as visualizações, os visualizadores únicos, os cliques e as reações atuais da Meta, com list_social_posts para encontrar a publicação.
Substituto recomendado pela Meta para post_impressions_unique, cuja descontinuação em todas as versões da API ela marcou para junho de 2026.
Quando post_impressions deixou de retornar dados em todas as versões; a Meta indica post_media_view como alternativa.
O período que a Meta lista para métricas de publicação como post_media_view, post_clicks e os totais de reações.
O que as contagens de curtidas da Meta incluem: tanto a reação curtir quanto a reação cuidado.
O que a Meta retorna, em vez de erro, quando o app não tem a permissão read_insights.
Quais métricas de publicação funcionam em 2026?
Estão na referência de insights da Meta e fora das suas listas de descontinuação a partir de 1º de novembro de 2026. Cada uma é lida pelo ID da publicação, com período lifetime, salvo indicação em contrário:
post_media_view: vezes em que a publicação foi reproduzida ou exibida, com detalhamentosis_from_adseis_from_followers.post_total_media_view_unique: os visualizadores únicos da publicação, substituto da Meta para o alcance.post_clicks: cliques em qualquer parte da publicação que não geraram uma história;post_clicks_by_typeos separa por tipo de consumo.post_reactions_by_type_total: reações por tipo, mais um total por tipo, comopost_reactions_love_totaloupost_reactions_anger_total.post_video_views: reproduções de um vídeo por pelo menos 3 segundos, com período lifetime ou day.
O que substituiu impressões e alcance das publicações?
A Meta migrou a medição de publicações de impressões para visualizações de mídia em duas etapas, cada uma para todas as versões da API de uma vez, e um nome aposentado agora retorna um erro de métrica inválida. Seu changelog, sua página de métricas descontinuadas e suas notas da Graph API v25 apresentam estas alternativas:
| Deprecated | Use instead | |
|---|---|---|
| Nov 15, 2025 | post_impressions | post_media_view |
| Nov 15, 2025 | post_impressions_paid | post_media_view with is_from_ads |
| Nov 15, 2025 | post_impressions_fan | post_media_view with is_from_followers |
| June 2026 | post_impressions_unique | post_total_media_view_unique |
| June 2026 | post_impressions_paid_unique, post_impressions_organic_unique | post_media_view breakdowns, which count views rather than people |
Qual a diferença entre visualizações e visualizadores únicos?
Visualizações contam exibições, visualizadores únicos contam pessoas. post_media_view soma cada vez que a publicação foi reproduzida ou exibida, então uma pessoa que a vê duas vezes conta duas, enquanto post_total_media_view_unique conta cada visualizador único da publicação uma vez. A Meta marca as métricas que terminam em _unique como aproximadas e calcula os valores únicos de forma independente, então um total pode não ser igual à soma das partes.
Como solicitar os insights de uma publicação?
Com GET /{page-post-id}/insights e metric definido como uma lista separada por vírgulas, ou GET /{page-post-id}/insights/{metric} para uma só. O token precisa vir de alguém que possa executar a tarefa ANALYZE na Página, com read_insights e pages_read_engagement concedidos, e cada resultado traz name, period, values, title e description. O exemplo próprio da Meta pede os totais de reações:
GET /{page-post-id}/insights?metric=post_reactions_like_total,post_reactions_love_total
{
"data": [
{
"name": "post_reactions_like_total",
"period": "lifetime",
"values": [{ "value": 226 }],
"title": "Lifetime Total Like Reactions of a post.",
"id": "{page-post-id}/insights/post_reactions_like_total/lifetime"
},
{
"name": "post_reactions_love_total",
"period": "lifetime",
"values": [{ "value": 17 }],
"title": "Lifetime Total Love Reactions of a post.",
"id": "{page-post-id}/insights/post_reactions_love_total/lifetime"
}
]
}Como contar reações, comentários e compartilhamentos?
A partir dos próprios campos da publicação, ao lado dos seus insights. fields=reactions.summary(total_count) retorna o total de reações, e reactions.type(LOVE).limit(0).summary(total_count) a contagem de um tipo, entre LIKE, LOVE, WOW, HAHA, SORRY e ANGRY. O campo shares traz a contagem de compartilhamentos, que a Meta diz poder incluir publicações excluídas e publicações que o token não consegue ver, e a edge comments com summary=true acrescenta um total_count.
Como as métricas da publicação se relacionam às métricas da Página?
As métricas da Página somam o conteúdo da Página em um período, enquanto as métricas de publicação dão os totais acumulados de uma publicação. page_post_engagements conta o engajamento com as publicações da Página por meio de reações, comentários, compartilhamentos e outros, por período day, week ou days_28, e page_media_view e page_total_media_view_unique fazem o mesmo para visualizações e visualizadores. A Meta removeu post_engaged_users em 2024, então o engajamento por publicação é montado a partir de cliques, reações, comentários e compartilhamentos.
Quão atualizados estão os dados e até quando voltam?
A maioria das métricas é atualizada uma vez por dia, e as que a Meta marca com asterisco, como post_clicks, várias vezes por dia. A Meta mantém dois anos de insights para Páginas públicas, mas só 5 dias para as não publicadas. lifetime significa o período para o qual há dados disponíveis, dois anos ou menos por padrão. Os dados de Insights da Página exigem uma Página com 100 ou mais curtidas, e várias métricas de vídeo leem 0 em um vídeo recompartilhado de outra Página.
Como o easyCoexistence lê os insights de publicação?
get_social_insights recebe as métricas e, para uma publicação, seu object_id, o ID da publicação que list_social_posts retorna; sem object_id, lê a Página. period e parâmetros extras como since e until passam para a Meta sem alteração, e uma métrica aposentada volta como o erro de métrica inválida da Meta, para que a IA possa trocar por um nome atual.
Erros comuns
- Pedir post_impressions_unique. A Meta a descontinuou em todas as versões da API em junho de 2026; peça post_total_media_view_unique para contar visualizadores únicos.
- Somar visualizadores únicos entre publicações. Cada publicação conta os próprios visualizadores, de forma aproximada, então uma pessoa que viu duas publicações é contada duas vezes.
- Ler insights de um vídeo recompartilhado de outra Página. Várias métricas de vídeo retornam 0 para recompartilhamentos; só a Página que criou o vídeo recebe valores precisos.
- Confiar em um zero de uma resposta vazia. Sem read_insights, a Meta retorna um conjunto de dados vazio em vez de erro, então verifique a permissão primeiro.
De US$ 9 a US$ 0.75 por conexão por mês, com a faixa caindo à medida que você adiciona conexões, e os primeiros 3 dias grátis.
O easyCoexistence é uma API e um servidor MCP multicanal que conecta agentes de IA, como o Claude e o ChatGPT, ao WhatsApp, Instagram, TikTok, Facebook e mais. No WhatsApp, ele usa o Coexistence: a empresa continua usando o número no app WhatsApp Business enquanto a IA trabalha pela API oficial da Meta.
Perguntas frequentes
Qual substituiu o alcance de publicações no Facebook?
post_total_media_view_unique, a contagem dos visualizadores únicos de uma publicação, depois que a Meta descontinuou post_impressions_unique em junho de 2026.
Posso ver quem reagiu a uma publicação da Página?
Não. A Meta retorna as contagens de reação por tipo, mas uma Página ou pessoa só pode consultar a própria reação; as demais permanecem privadas.
As contagens de curtidas incluem reações de cuidado?
Sim. Os totais de curtidas da Meta contam tanto curtir quanto cuidado, tanto nos insights quanto na edge reactions.
Posso ler insights de uma publicação em outra Página?
Não pelos insights da Página: eles exigem um token de alguém que possa executar a tarefa ANALYZE na Página que fez a publicação.
Continue lendo
Conecte seu primeiro canal em dois minutos.
Sem esperar aprovação das plataformas. Conecte o WhatsApp, o Instagram, o TikTok ou outro canal, peça para a sua IA publicar, responder ou trazer os números, e veja funcionando.
- 3 dias grátis
- Cancele quando quiser
- Só APIs oficiais
- Monitorado 24/7
Verificado em