Contagem de seguidores de Página do Facebook pela API: followers_count vs fan_count
O número de seguidores de uma Página do Facebook está no campo followers_count: GET /{page-id}?fields=followers_count o retorna. fan_count conta curtidas, e nas Páginas da New Pages Experience a Meta também retorna followers_count ali. Para mudanças 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 em 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 retorna page_follows e quem deixou de seguir por dia.
Campo da Página que a referência da Meta descreve como o número de seguidores da Página.
Número de usuários que curtem a Página; nas Páginas da New Pages Experience, a Meta retorna followers_count nele.
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.
Seguidores contados como novos seguidores menos quem deixou de seguir durante a vida da Página, lidos com period day.
Contas que deixaram de seguir a Página no período, por dia, semana ou days_28; a Meta marca como estimado.
Data em que a Meta diz que todas as Páginas clássicas serão migradas; has_transitioned_to_new_page_experience mostra se uma Página já foi migrada.
Qual 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 Page access token, retorna o total atual. Ele não guarda histórico, então leia a métrica page_follows para ver a variação no tempo, ou salve o valor do campo em um agendamento.
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?
Seguidores contra curtidas. 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 usuários que curtem a Página, acrescentando que, nas Páginas da New Pages Experience, fan_count retorna followers_count, e que em uma Página Global ele cobre 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.
Quais métricas de seguidores a Meta descontinuou, e quando?
A Meta migrou os insights de Página das curtidas, que suas métricas chamavam de fans, para seguidores, em várias etapas. Cada etapa valeu para todas as versões da API ao mesmo tempo, e um nome aposentado agora retorna um erro de métrica inválida. As etapas que afetam seguidores:
| Deprecated | Use instead | |
|---|---|---|
| Nov 15, 2025 | page_fans | page_follows |
| Nov 15, 2025 | page_fan_adds, page_fan_adds_unique | No alternative listed |
| Nov 15, 2025 | page_fan_removes, page_fan_removes_unique | No alternative listed |
| By Sep 16, 2024 | page_fans_by_like_source, page_fans_by_unlike_source | No alternative listed |
| By Sep 16, 2024 | page_daily_follows_by_source, page_daily_unfollows_by_source | No alternative listed |
| By Sep 16, 2024 | page_fans_online, page_fans_online_per_day | No alternative listed |
Como ler a variação de 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 novos seguidores menos quem deixou de seguir ao longo da sua vida, então comparar dois dias dá a variação líquida entre eles. page_daily_unfollows_unique soma as contas que deixaram de seguir, por dia, semana ou days_28. since e until selecionam até 90 dias por requisição, e o primeiro end_time retornado é a data de since mais um dia, por isso inclui os dados da data de since.
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 o page_daily_follows?
A Meta ainda lista page_daily_follows e page_daily_follows_unique na sua referência de insights, mas descreve ambos como Not defined, e marca o segundo como estimado. page_follows e page_daily_unfollows_unique são as métricas de seguidores com significado documentado, então relatórios que precisam ser explicados são melhores construídos sobre essas duas.
Quais permissões e tarefas a leitura de seguidores exige?
Para uma Página que você gerencia, a referência de Páginas da Meta lista pages_read_engagement, pages_read_user_content e pages_show_list para os dados da própria Página, lidos com um Page access token. Insights como page_follows acrescentam read_insights e um token de alguém com a tarefa ANALYZE. Para Páginas que você não gerencia, só dados públicos estão abertos, pelos recursos Page Public Content Access ou Page Public Metadata Access.
Quais limites se aplicam?
Os dados de Insights de Página só estão disponíveis em Páginas com 100 curtidas ou mais, e a Meta os mantém por dois anos em Páginas públicas e 5 dias em Páginas não publicadas. Métricas que terminam em _unique, como page_daily_unfollows_unique, são aproximadas, e os recortes demográficos só voltam com dados de 100 pessoas ou mais.
Como o easyCoexistence lê seguidores?
Pelos 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, além de since e until pelos seus params. O campo followers_count da própria Página não tem ferramenta.
Erros comuns
- Pedir page_fans. A Meta o descontinuou em 15 de novembro de 2025; peça page_follows para o total de seguidores.
- Ler fan_count como contagem de curtidas. Nas Páginas da New Pages Experience, a Meta retorna followers_count nele, então ele não separa curtidas de seguidores nessas Páginas.
- Somar os valores diários de page_follows. Cada um é um total acumulado, então subtraia o valor de um dia do seguinte para obter a variação.
- Esperar que page_fan_adds volte com outro nome. A Meta não indicou alternativa para ele nem para page_fan_removes; page_daily_unfollows_unique cobre apenas quem deixou de seguir.
De US$ 9 a US$ 0.75 por conexão por mês, caindo conforme você adiciona conexões, com os 3 primeiros 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
fan_count foi descontinuado?
A referência de Páginas da Meta não marca como descontinuado, mas nas Páginas da New Pages Experience ele retorna followers_count, então peça followers_count diretamente.
O que substituiu o page_fans?
page_follows, que conta os seguidores da Página como novos seguidores menos quem deixou de seguir, desde que o page_fans parou de funcionar em 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 requisições de até 90 dias cada, com since e until.
Quanto custa o easyCoexistence para uma Página do Facebook?
Cada Página é uma conexão, de US$ 9 a US$ 0.75 por conexão por mês conforme o total de conexões, e os primeiros 3 dias são grátis.
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