Contagem de seguidores e campos de perfil do Instagram pela API
A API do Instagram retorna a contagem de seguidores de uma conta profissional no campo followers_count, junto com follows_count, media_count, username, name, profile_picture_url e account_type. Com o Instagram Login, GET /me com esses campos os lê em graph.instagram.com usando instagram_business_basic. A referência do IG User da Meta também lista biography e website, e as mudanças de seguidores ao longo do tempo vêm de insights.
O easyCoexistence conecta uma conta comercial ou de criador do Instagram com o Instagram Login, para que o Claude, o ChatGPT ou o seu próprio código leiam seu alcance, visualizações e novos seguidores por get_social_insights, pela API oficial da Meta; as contagens de seguidores e publicações do perfil não têm ferramenta.
Número total de contas do Instagram que seguem a conta, um campo que a referência IG User da Meta marca como público.
Os campos de User que o guia Instagram Login da Meta lista, de id e user_id até followers_count e media_count.
O valor de account_type para uma conta de criador; uma conta comercial lê Business.
Abaixo desse limite, a Meta não retorna os insights follows_and_unfollows nem follower_count para a conta.
Quais campos de perfil o Instagram Login retorna?
Os nove campos que o guia Instagram Login da Meta lista para o objeto User, lidos com GET /me e uma lista de fields. O token precisa de instagram_business_basic, e user_id, não id, é o IG_ID da conta nas chamadas seguintes:
Como você lê a contagem de seguidores?
Peça followers_count em /me, que a referência da Meta associa ao nó User da conta por trás do token. O valor é um total acumulado no momento da chamada, então um painel que o acompanha em gráfico precisa salvar uma leitura por dia por conta própria.
GET https://graph.instagram.com/me
?fields=user_id,username,followers_count,follows_count,media_count
&access_token=<ACCESS_TOKEN>
{
"user_id": "<IG_ID>",
"username": "<USERNAME>",
"followers_count": 1840,
"follows_count": 312,
"media_count": 97
}Quais outros campos a referência da Meta lista?
A referência IG User da Meta, escrita para as três configurações em conjunto, acrescenta campos além dos nove do guia Instagram Login. Ela marca alguns como disponíveis para contas vinculadas a uma Página e deixa os demais sem observação de login:
- biography: o texto da bio do perfil, marcado como público.
- website: a URL do site da conta, marcado como público.
has_profile_pic: se a conta tem foto de perfil.is_publishedelegacy_instagram_user_id: para contas vinculadas a uma Página, sendo o segundo o ID criado para os endpoints da Marketing API até a v21.0.shopping_product_tag_eligibility: se a conta configurou o Instagram Shop.
Como você acompanha o crescimento de seguidores?
Pelos insights da conta, não pelo perfil. GET /<IG_ID>/insights com metric=follows_and_unfollows, metric_type=total_value e o breakdown follow_type retorna as contas que seguiram e as que deixaram de seguir ou saíram do Instagram. Com o Instagram Login, o token também precisa de instagram_business_manage_insights. A Meta retorna esse insight, e também follower_count, apenas para contas com pelo menos 100 seguidores.
A API consegue listar quem são os seguidores?
Não. A referência IG User da Meta traz followers_count e follows_count como números e não lista nenhuma edge que devolva as contas por trás deles. O que ela oferece é follower_demographics nos insights da conta, detalhado por idade, cidade, país ou gênero, para contas com pelo menos 100 seguidores.
Você pode ler a contagem de seguidores de outra conta?
Sim, com o Business Discovery, que a Meta oferece com o Facebook Login e o Unified Login: GET /<IG_ID>?fields=business_discovery.username(<USERNAME>){followers_count,media_count} retorna esses valores de outra conta comercial ou de criador. Ele lê os campos públicos da outra conta, que a referência IG User marca: biography, followers_count, id, media_count, username e website, entre outros.
Como você lê o perfil pelo easyCoexistence?
list_social_accounts retorna o username, o name e o external_id de cada conta conectada, que é o seu IG_ID. As contagens do perfil, followers_count, follows_count e media_count, não têm ferramenta, e os tokens do Instagram não são entregues; get_social_insights lê como a audiência se move, com follows_and_unfollows, reach e views.
Erros comuns
- Esperar uma lista de seguidores. A Meta retorna contagens e, a partir de 100 seguidores, dados demográficos, mas não as contas em si.
- Medir o crescimento só com followers_count. Ele é um total acumulado; follows_and_unfollows nos insights separa novos seguidores de quem deixou de seguir.
- Procurar CREATOR em account_type. Uma conta de criador informa Media_Creator, e uma conta comercial, Business.
- Usar o id de /me como ID da conta. O guia da Meta liga o user_id, não o id, às notificações de webhook e a caminhos como /<IG_ID>/media.
De US$ 9 a US$ 0.75 por conexão por mês, caindo à medida que você adiciona conexões, com 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
A API do Instagram retorna a bio do perfil?
Sim, como biography, que a referência IG User da Meta marca como pública. Os nove campos de User do guia Instagram Login deixam esse de fora, então solicite-o em GET /me e confira a resposta na sua configuração.
Por que follows_and_unfollows não retorna nada?
A Meta não o retorna para contas com menos de 100 seguidores.
Posso obter a contagem de seguidores de uma conta pessoal?
Não. A API da Meta atende contas profissionais, e o Business Discovery lê apenas contas comerciais e de criador.
Qual permissão a contagem de seguidores exige?
Com o Instagram Login, instagram_business_basic. Os insights de seguidores acrescentam instagram_business_manage_insights.
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