Iniciar sessãoIniciar teste gratuito
easyCoexistence APIs oficiais

Contagem de seguidores de uma Página do Facebook através da API: followers_count ou fan_count

A contagem de seguidores de uma Página do Facebook é o campo followers_count: GET /{page-id}?fields=followers_count devolve-o. fan_count conta gostos, e nas Páginas na New Pages Experience a Meta devolve lá também followers_count. Para alterações ao longo do tempo, a métrica de Insights page_follows dá o total de seguidores por dia, substituindo page_fans, que a Meta descontinuou a 15 de novembro de 2025.

O easyCoexistence lê os seguidores de uma Página do Facebook para o Claude, o ChatGPT ou o seu próprio código: get_social_insights devolve page_follows e os cancelamentos de seguimento por dia.

followers_count

Campo da Página que a referência da Meta descreve como o número de seguidores da Página.

fan_count

O número de utilizadores que gostam da Página; nas Páginas na New Pages Experience, a Meta devolve lá followers_count.

15 Nov 2025

Quando page_fans, page_fan_adds e page_fan_removes deixaram de funcionar em todas as versões; a Meta indica page_follows como alternativa a page_fans.

page_follows

Seguidores contados como seguimentos menos os cancelamentos de seguimento durante a vida da Página, lidos com period day.

page_daily_unfollows_unique

Contas que deixaram de seguir a Página no período, por dia, semana ou days_28; a Meta marca como estimado.

New Pages Experience

Quando a Meta diz que todas as Páginas clássicas serão migradas; has_transitioned_to_new_page_experience indica se uma Página já foi migrada.

Que campo guarda o número de seguidores de uma Página?

followers_count, um campo do nó da Página que a referência da Meta descreve como o número de seguidores da Página. GET /{page-id}?fields=followers_count, feito com um token de acesso da Página, devolve o total atual. Não guarda histórico, por isso leia a métrica page_follows para ver a evolução, ou guarde o valor do campo periodicamente.

Both counts on one Page
GET /{page-id}?fields=followers_count,fan_count

{
  "followers_count": <FOLLOWERS>,
  "fan_count": <LIKES, OR FOLLOWERS ON A NEW PAGES EXPERIENCE PAGE>,
  "id": "<PAGE_ID>"
}

Qual é a diferença entre followers_count e fan_count?

Seguimentos em vez de gostos. A referência de Páginas da Meta descreve followers_count como o número de seguidores da Página e fan_count como o número de utilizadores que gostam da Página, acrescentando que nas Páginas na New Pages Experience, fan_count devolve followers_count, e que numa Página Global abrange todas as Páginas da marca. A Meta diz que todas as Páginas clássicas serão migradas para a New Pages Experience, e has_transitioned_to_new_page_experience indica se uma Página já foi migrada.

Que métricas de seguidores a Meta descontinuou, e quando?

A Meta passou as métricas da Página, de gostos (que chamava fans) para seguimentos, em várias fases. Cada fase aplicou-se a todas as versões da API de uma vez, e um nome retirado devolve agora um erro de métrica inválida. As fases que afetam os seguidores:

DeprecatedUse instead
Nov 15, 2025page_fanspage_follows
Nov 15, 2025page_fan_adds, page_fan_adds_uniqueNo alternative listed
Nov 15, 2025page_fan_removes, page_fan_removes_uniqueNo alternative listed
By Sep 16, 2024page_fans_by_like_source, page_fans_by_unlike_sourceNo alternative listed
By Sep 16, 2024page_daily_follows_by_source, page_daily_unfollows_by_sourceNo alternative listed
By Sep 16, 2024page_fans_online, page_fans_online_per_dayNo alternative listed

Como se lê a evolução dos seguidores ao longo do tempo?

Com page_follows e period definido como day. Cada valor diário é o total de seguidores da Página, contado como seguimentos menos cancelamentos ao longo da sua vida, por isso comparar dois dias dá a variação líquida entre eles. page_daily_unfollows_unique acrescenta as contas que deixaram de seguir, por dia, semana ou days_28. since e until selecionam até 90 dias por pedido, e o primeiro end_time devolvido é a data de since mais um dia, por isso inclui os dados dessa data de since.

Followers and unfollows by day for October 2026
GET /{page-id}/insights?metric=page_follows,page_daily_unfollows_unique&period=day&since=2026-10-01&until=2026-10-31

{
  "data": [
    {
      "name": "page_follows",
      "period": "day",
      "values": [
        { "value": <FOLLOWERS>, "end_time": "2026-10-02T07:00:00+0000" },
        { "value": <FOLLOWERS>, "end_time": "2026-10-03T07:00:00+0000" }
      ]
    }
  ]
}

E page_daily_follows?

A Meta continua a listar page_daily_follows e page_daily_follows_unique na sua referência de Insights, mas descreve ambas como não definidas, e marca a segunda como estimada. page_follows e page_daily_unfollows_unique são as métricas de seguidores com um significado documentado, por isso os relatórios que têm de ser explicados são melhor construídos sobre essas duas.

Que permissões e tarefas são necessárias para ler seguidores?

Para uma Página que gere, a referência de Páginas da Meta indica pages_read_engagement, pages_read_user_content e pages_show_list para os dados da própria Página, lidos com um token de acesso da Página. Insights como page_follows acrescentam read_insights e um token de alguém com a tarefa ANALYZE. Para Páginas que não gere, só os dados públicos estão abertos, através das funcionalidades Page Public Content Access ou Page Public Metadata Access.

Que limiares se aplicam?

Os dados de Insights da Página só estão disponíveis em Páginas com 100 ou mais gostos, e a Meta guarda-os durante dois anos nas Páginas públicas e 5 dias nas não publicadas. As métricas que terminam em _unique, como page_daily_unfollows_unique, são aproximadas, e as desagregações demográficas só voltam com dados de 100 ou mais pessoas.

Como é que o easyCoexistence lê os seguidores?

Através dos insights, a partir do Claude, do ChatGPT ou do seu próprio código. get_social_insights lê page_follows e page_daily_unfollows_unique com um period, mais since e until através de params. O campo followers_count da própria Página não tem ferramenta.

Erros comuns

  • Pedir page_fans. A Meta descontinuou-o a 15 de novembro de 2025; peça page_follows para o total de seguidores.
  • Ler fan_count como número de gostos. Nas Páginas na New Pages Experience a Meta devolve followers_count nesse campo, por isso não separa gostos de seguimentos nessas Páginas.
  • Somar os valores diários de page_follows. Cada um é um total acumulado, por isso subtraia o valor de um dia ao do dia seguinte para obter a variação.
  • Esperar que page_fan_adds volte com um novo nome. A Meta não indicou alternativa para ele nem para page_fan_removes; page_daily_unfollows_unique cobre apenas os cancelamentos.
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

O fan_count está descontinuado?

A referência de Páginas da Meta não o marca como descontinuado, mas nas Páginas na New Pages Experience devolve followers_count, por isso peça followers_count diretamente.

O que substituiu o page_fans?

page_follows, que conta os seguidores da Página como seguimentos menos cancelamentos, depois de o page_fans deixar de funcionar a 15 de novembro de 2025.

Até quando posso ler o histórico de seguidores de uma Página?

Dois anos para uma Página pública, em pedidos de até 90 dias cada, com since e until.

Quanto custa o easyCoexistence para uma Página do Facebook?

De US$ 9 a US$ 0.75 por ligação por mês, conforme o seu total de ligações, e os primeiros 3 dias são gratuitos.

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