EntrarComeçar teste grátis
easyCoexistence APIs oficiais

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.

followers_count

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.

9 fields

Os campos de User que o guia Instagram Login da Meta lista, de id e user_id até followers_count e media_count.

Media_Creator

O valor de account_type para uma conta de criador; uma conta comercial lê Business.

100 followers

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:

idThe app user's app-scoped ID
user_idThe professional account's ID, the id in its webhook notifications
usernameThe account's username
nameThe profile name
account_typeBusiness or Media_Creator
profile_picture_urlThe profile picture's URL
followers_countAccounts following it
follows_countAccounts it follows
media_countMedia published on the account

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.

Counts and username with Instagram Login
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_published e legacy_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.
Fazendo isso com o EasyCoexistence

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