Iniciar sessãoIniciar teste gratuito
easyCoexistence APIs oficiais

Instagram Business Discovery: ler as publicações e o número de seguidores de outra conta

A Business Discovery do Instagram lê dados públicos de outra conta empresarial ou de criador pelo nome de utilizador: contagens de seguidores e de publicações, campos de perfil públicos como a biografia e o site, e as suas publicações com contagens de gostos, comentários e visualizações. A sua conta profissional faz o pedido, GET /<IG_ID>?fields=business_discovery.username(<USERNAME>){followers_count,media_count}, com o Facebook Login ou o Unified Login.

A easyCoexistence liga a sua conta empresarial ou de criador do Instagram com o Instagram Login, para que o Claude, o ChatGPT ou o seu próprio código leiam as contagens de seguidores e de publicações, as publicações, os comentários e as métricas através da API oficial da Meta, e também publiquem e respondam a comentários e mensagens diretas nessa conta.

2 setups

A Business Discovery está disponível com a API do Instagram com Facebook Login e com Unified Login.

3 permissions

instagram_basic, instagram_manage_insights e pages_read_engagement, num token de acesso de utilizador do Facebook Login.

Age-gated

Contas profissionais cujos dados a Business Discovery não devolve.

13 Aug 2019

Quando a Business Discovery passou a devolver dados sobre outras contas de criador do Instagram, e não só de empresas.

Platform

Os limites de pedidos a que as chamadas da Business Discovery estão sujeitas, em vez dos limites dos restantes endpoints do Instagram.

Como funciona um pedido à Business Discovery?

É um campo da sua própria conta. Faça o pedido GET /<IG_ID> à conta profissional que gere, com fields=business_discovery.username(<USERNAME>) e, entre chavetas, os campos que quer sobre a outra conta. A resposta aninha-os em business_discovery, ao lado do id da sua conta.

Another account's follower and media counts
GET /<IG_ID>?fields=business_discovery.username(bluebottle){followers_count,media_count}

{
  "business_discovery": {
    "followers_count": 267788,
    "media_count": 1205,
    "id": "17841401441775531"
  },
  "id": "<IG_ID>"
}

Que campos pode devolver?

Os campos públicos da outra conta e as suas publicações, tal como as referências da Meta os descrevem:

  • Perfil: os campos do IG User marcados como públicos, que incluem biography, followers_count, id, media_count, username e website.
  • Publicações: a aresta media, com campos como comments_count, like_count e view_count para cada publicação.
  • view_count: disponível apenas através da Business Discovery, contando em conjunto as visualizações pagas e orgânicas.
  • media_url: omitido em vídeos com áudio protegido por direitos de autor ou licenciado, e em Reels cujo proprietário desativou as transferências.

Como se obtêm as publicações da outra conta?

Expanda media dentro de business_discovery e indique os campos de cada publicação. A aresta media pagina com cursores before e after, mas sem campos next ou previous, pelo que a Meta lhe pede que construa o pedido seguinte a partir do cursor after. Os IDs de media devolvidos não podem ser lidos sozinhos: a Meta indica que um GET sobre eles falha por permissões insuficientes.

The other account's posts with their counts
GET /<IG_ID>?fields=business_discovery.username(bluebottle){media{id,permalink,timestamp,comments_count,like_count,view_count}}

Que contas pode ler?

Contas empresariais e de criador do Instagram, pesquisadas pelo nome de utilizador; as contas de criador estão cobertas desde agosto de 2019. Não são devolvidos dados de contas profissionais com restrição de idade, e as contas pessoais ficam fora da API do Instagram. O que volta são dados públicos, do tipo limitado que a visão geral da Meta indica que alguns endpoints devolvem sobre conteúdos que o utilizador da aplicação não criou.

O que precisa?

Um token de acesso de utilizador do Facebook Login com instagram_basic, instagram_manage_insights e pages_read_engagement, mais ads_management ou ads_read quando a função da pessoa na Página chega pelo Business Manager. O guia da Business Discovery da Meta também indica a configuração com o Unified Login. As chamadas contam para os limites de taxa da Plataforma da Meta, e não para os limites de Business Use Case por trás dos restantes endpoints do Instagram.

Pode usar a Business Discovery através da easyCoexistence?

A easyCoexistence liga o Instagram com o Instagram Login, que abrange o perfil, as publicações, os comentários, as mensagens diretas e as métricas da própria conta ligada. A Meta oferece a Business Discovery com o Facebook Login e o Unified Login, pelo que fica fora desta ligação. Para a própria conta ligada, get_social_insights lê o alcance, as visualizações e os novos seguidores.

Erros comuns

  • Chamar GET aos IDs de media que devolve. A Meta recusa-os por permissões insuficientes; peça antes os campos dentro de business_discovery.
  • Pesquisar uma conta pessoal. A Business Discovery devolve contas empresariais e de criador, e deixa de fora as que têm restrição de idade.
  • Esperar por paging.next. A aresta media devolve apenas cursores, por isso construa o pedido seguinte com o cursor after.
  • Ler view_count como alcance orgânico. A Meta conta nele as visualizações pagas e orgânicas em conjunto.
Fazer isto com a EasyCoexistence

De US$ 9 a US$ 0,75 por ligação por mês, descendo à medida que acrescenta ligações, com os primeiros 3 dias gratuitos.

Perguntas frequentes

Posso ver a contagem de seguidores de um concorrente através da API do Instagram?

Sim, se for uma conta empresarial ou de criador e sem restrição de idade: a Business Discovery devolve o seu followers_count pelo nome de utilizador, com o Facebook Login ou o Unified Login.

A Business Discovery funciona com o Instagram Login?

Não. A Meta indica o Business Discovery para o Facebook Login e o Unified Login, e o seu guia deixa de fora a configuração com o Instagram Login.

Quantos pedidos à Business Discovery posso fazer?

A Business Discovery está sujeita aos limites de taxa da Plataforma da Meta, e não ao orçamento de chamadas por conta dos restantes endpoints do Instagram.

Porque é que a Business Discovery não devolve nada para uma conta?

A conta pode ser pessoal, o que a API não suporta, ou ter restrição de idade, caso em que a Meta não devolve os dados.

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