Iniciar sessãoIniciar teste gratuito
easyCoexistence APIs oficiais

Seguidores e campos de perfil do Instagram através da API

A API do Instagram devolve o número de seguidores de uma conta profissional no campo followers_count, a seguir a follows_count, media_count, username, name, profile_picture_url e account_type. Com o Instagram Login, um GET /me com esses campos lê-os em graph.instagram.com com a permissão instagram_business_basic. A referência IG User da Meta também lista biography e website, e as alterações de seguidores ao longo do tempo vêm dos insights.

O easyCoexistence liga uma conta Business ou de criador do Instagram com o Instagram Login, para que o Claude, o ChatGPT ou o seu próprio código leiam o alcance, as visualizações e os novos seguidores através de get_social_insights, na API oficial da Meta; as contagens de seguidores e de publicações do perfil não têm ferramenta.

followers_count

Número total de utilizadores do Instagram que seguem a conta, um campo que a referência IG User da Meta marca como público.

9 fields

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

Media_Creator

O valor de account_type para uma conta de criador; uma conta empresarial aparece como Business.

100 followers

Abaixo deste limite, a Meta não devolve os insights follows_and_unfollows nem follower_count para a conta.

Que campos de perfil devolve o Instagram Login?

Os nove campos que o guia do 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 o IG_ID da conta para as chamadas seguintes é user_id, não id:

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 se lê a contagem de seguidores?

Pede-se followers_count em /me, que a referência da Meta traduz para o nó User da conta associada ao token. O valor é um total acumulado no momento da chamada, por isso um painel que o represente num gráfico tem de guardar uma leitura por dia.

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
}

Que outros campos lista a referência da Meta?

A referência IG User da Meta, escrita para as três configurações em conjunto, acrescenta campos aos nove do guia do Instagram Login. Marca alguns como disponíveis para contas associadas a uma Página e deixa os restantes sem nota de login:

  • biography: o texto da biografia do perfil, marcado como público.
  • website: o 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 associadas a uma Página, sendo o segundo o ID criado para os endpoints da Marketing API até à v21.0.
  • shopping_product_tag_eligibility: se a conta configurou o Instagram Shop.

Como se acompanha o crescimento de seguidores?

Através dos insights da conta e não do perfil. GET /<IG_ID>/insights com metric=follows_and_unfollows, metric_type=total_value e a segmentação follow_type devolve as contas que seguiram e as que deixaram de seguir ou saíram do Instagram, e com o Instagram Login o token também precisa de instagram_business_manage_insights. A Meta só devolve esta métrica e follower_count 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 devolve followers_count e follows_count como números e não lista nenhuma relação que devolva as contas por trás deles. O que oferece é follower_demographics nos insights da conta, com repartição por idade, cidade, país ou género, para contas com pelo menos 100 seguidores.

É possível 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} devolve-os para outra conta empresarial ou de criador. Lê os campos públicos da outra conta, que a referência IG User marca, entre eles biography, followers_count, id, media_count, username e website.

Como se lê o perfil através do easyCoexistence?

list_social_accounts devolve o username, o name e o external_id de cada conta ligada, sendo o external_id 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ê antes como evolui o público, com follows_and_unfollows, reach e views.

Erros comuns

  • Esperar uma lista de seguidores. A Meta devolve contagens e, a partir de 100 seguidores, dados demográficos, mas não as contas em si.
  • Traçar o crescimento apenas com followers_count. É um total acumulado; follows_and_unfollows nos insights separa os novos seguidores dos que deixaram de seguir.
  • Verificar account_type para CREATOR. Uma conta de criador devolve Media_Creator, e uma conta empresarial devolve Business.
  • Usar o id de /me como ID da conta. O guia da Meta associa user_id, não id, às notificações do webhook e a caminhos como /<IG_ID>/media.
Fazer isto com a EasyCoexistence

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

Perguntas frequentes

A API do Instagram devolve a biografia do perfil?

Sim, como biography, que a referência IG User da Meta marca como pública. Os nove campos User do guia do Instagram Login deixam-na de fora, por isso peça-a em GET /me e verifique a resposta na sua configuração.

Porque é que follows_and_unfollows não devolve nada?

A Meta não o devolve para contas com menos de 100 seguidores.

Posso obter a contagem de seguidores de uma conta pessoal?

Não. A API da Meta serve contas profissionais, e o Business Discovery lê apenas contas empresariais e de criador.

Que permissão precisa a contagem de seguidores?

Com o Instagram Login, instagram_business_basic. Os insights de seguidores acrescentam instagram_business_manage_insights.

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