Iniciar sessãoIniciar teste gratuito
easyCoexistence APIs oficiais

Estatísticas de publicações do Facebook através da API: visualizações, alcance e envolvimento

As estatísticas de publicações do Facebook provêm de GET /{page-post-id}/insights com métricas como post_media_view, o número de vezes que a publicação foi reproduzida ou apresentada, post_total_media_view_unique, o número de 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, pelo que as visualizações e os visualizadores únicos passam a substituir as impressões e o alcance.

A easyCoexistence lê as estatísticas das publicações do Facebook com get_social_insights, para que o Claude, o ChatGPT ou o seu próprio código possam perguntar como correu uma publicação e obter 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.

post_total_media_view_unique

Substituto recomendado pela Meta para post_impressions_unique, cuja descontinuação para todas as versões da API fixou em junho de 2026.

15 Nov 2025

Quando post_impressions deixou de devolver dados em todas as versões; a Meta indica post_media_view como alternativa.

lifetime

O período indicado pela Meta para métricas de publicações como post_media_view, post_clicks e os totais de reações.

Like + care

O que incluem as contagens de reações de gosto da Meta: tanto as reações de gosto como as de carinho.

Empty dataset

O que a Meta devolve, em vez de um erro, quando a aplicação não tem a permissão read_insights.

Quais as métricas de publicações que funcionam em 2026?

Estas constam da referência de estatísticas da Meta e não estão nas 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: número de vezes que a publicação foi reproduzida ou apresentada, com as discriminações is_from_ads e is_from_followers.
  • post_total_media_view_unique: os visualizadores únicos da publicação, o substituto do alcance indicado pela Meta.
  • post_clicks: cliques em qualquer ponto da publicação que não geraram uma story; post_clicks_by_type separa-os por tipo de consumo.
  • post_reactions_by_type_total: reações por tipo, com um total por cada tipo, como post_reactions_love_total ou post_reactions_anger_total.
  • post_video_views: reproduções de um vídeo com pelo menos 3 segundos, com período lifetime ou day.

O que substituiu as impressões e o alcance das publicações?

A Meta passou a medir as publicações por visualizações de multimédia em duas etapas, cada uma para todas as versões da API ao mesmo tempo, e um nome retirado passa a devolver um erro de métrica inválida. O seu changelog, a sua página de métricas descontinuadas e as notas da versão 25 da Graph API indicam estas alternativas:

DeprecatedUse instead
Nov 15, 2025post_impressionspost_media_view
Nov 15, 2025post_impressions_paidpost_media_view with is_from_ads
Nov 15, 2025post_impressions_fanpost_media_view with is_from_followers
June 2026post_impressions_uniquepost_total_media_view_unique
June 2026post_impressions_paid_unique, post_impressions_organic_uniquepost_media_view breakdowns, which count views rather than people

Qual é a diferença entre visualizações e visualizadores únicos?

As visualizações contam apresentações, e os visualizadores únicos contam pessoas. O post_media_view soma cada vez que a publicação foi reproduzida ou apresentada, pelo que uma pessoa que a veja duas vezes conta duas vezes, enquanto post_total_media_view_unique conta uma vez cada visualizador único da publicação. A Meta marca as métricas que terminam em _unique como aproximadas e calcula os valores únicos de forma independente, pelo que um total pode não ser igual à soma das suas partes.

Como se pedem as estatísticas de uma publicação?

Com GET /{page-post-id}/insights e metric com uma lista de valores separados por vírgulas, ou GET /{page-post-id}/insights/{metric} para uma só. O token tem de provir de alguém que possa executar a tarefa ANALYZE na Página, com read_insights e pages_read_engagement concedidas, e cada resultado inclui name, period, values, title e description. O exemplo da própria Meta pede os totais de reações:

Meta's example request and response for one post, trimmed
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 se contam reações, comentários e partilhas?

A partir dos próprios campos da publicação, ao lado das suas estatísticas. fields=reactions.summary(total_count) devolve 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 contém o número de partilhas, que a Meta diz poder incluir publicações eliminadas e publicações que o token não consegue ver, e o edge comments com summary=true acrescenta um total_count.

Como se relacionam as métricas da publicação com as métricas da Página?

As métricas da Página somam o conteúdo da Página num período, enquanto as da publicação dão os totais acumulados de uma só publicação. page_post_engagements conta o envolvimento com as publicações da Página através de reações, comentários, partilhas e outros, por dia, semana ou days_28, e page_media_view e page_total_media_view_unique fazem o mesmo para visualizações e visualizadores. A Meta retirou post_engaged_users em 2024, pelo que o envolvimento por publicação é construído a partir de cliques, reações, comentários e partilhas.

Quão atualizados estão os dados e até quando recuam?

A maioria das métricas atualiza-se uma vez por dia, e as que a Meta assinala com um asterisco, como post_clicks, várias vezes por dia. A Meta guarda dois anos de estatísticas para as Páginas públicas, mas apenas 5 dias para as não publicadas. lifetime significa o período para o qual existem dados, dois anos ou menos por omissão. Os dados de estatísticas da Página exigem uma Página com 100 ou mais gostos, e várias métricas de vídeo devolvem 0 num vídeo partilhado de outra Página.

Como é que a easyCoexistence lê as estatísticas das publicações?

get_social_insights recebe as métricas e, para uma só publicação, o seu object_id, isto é, o ID da publicação que devolve list_social_posts; sem object_id lê a Página. Os parâmetros period e extra, como since e until, seguem para a Meta sem alterações, e uma métrica retirada volta como o erro de métrica inválida da Meta, para que a IA possa mudar para um nome atual.

Erros comuns

  • Pedir post_impressions_unique. A Meta descontinuou-a para todas as versões da API em junho de 2026; peça post_total_media_view_unique para contar os visualizadores únicos.
  • Somar visualizadores únicos entre publicações. Cada publicação conta os seus próprios visualizadores, de forma aproximada, pelo que uma pessoa que viu duas publicações é contada duas vezes.
  • Ler estatísticas de um vídeo partilhado de outra Página. Várias métricas de vídeo devolvem 0 em partilhas; só a Página que criou o vídeo obtém valores exatos.
  • Confiar num zero de uma resposta vazia. Sem read_insights, a Meta devolve um conjunto de dados vazio em vez de um erro, pelo que deve verificar primeiro a permissão.
Fazer isto com a EasyCoexistence

De US$ 9 a US$ 0.75 por ligação por mês, descendo à medida que adiciona ligações, com os primeiros 3 dias gratuitos.

Perguntas frequentes

Que substituiu o alcance das publicações no Facebook?

post_total_media_view_unique, a contagem dos visualizadores únicos de uma publicação, depois de a Meta ter descontinuado post_impressions_unique em junho de 2026.

Posso ver quem reagiu a uma publicação da Página?

Não. A Meta devolve as contagens de reações por tipo, mas uma Página ou uma pessoa só pode consultar a sua própria reação; as restantes ficam privadas.

As contagens de gostos incluem as reações de carinho?

Sim. Os totais de gostos da Meta contam tanto gosto como carinho, tanto nas estatísticas como na edge de reações.

Posso ler as estatísticas de uma publicação de outra Página?

Não através das estatísticas da Página: é preciso um token de alguém que possa executar a tarefa ANALYZE na Página que criou a publicação.

Continue a ler

Ligue o seu primeiro canal em dois minutos.

Sem revisões de plataformas para esperar. Ligue o WhatsApp, o Instagram, o TikTok ou outro canal, peça depois à sua IA que publique, responda ou faça um relatório, e veja-a trabalhar.

  • 3 dias grátis
  • Cancele quando quiser
  • Só APIs oficiais
  • Monitorizado 24/7

Verificado em