Usuário do Instagram

Representa uma conta comercial ou uma conta de criador de conteúdo do Instagram.

Em toda nossa documentação, mencionamos "usuário do Instagram" e "conta do Instagram" de forma intercambiável. Ambos representam a conta profissional do Instagram do usuário do seu app.

Requirements

	Instagram API with Instagram Login	Instagram API with Facebook Login
Access Tokens	Instagram User user access token	Facebook User access token
Host URL	`graph.instagram.com`	`graph.facebook.com`
Login Type	Business Login for Instagram	Facebook Login for Business
Permissions	`instagram_business_basic`	`instagram_basic` `pages_read_engagement` If the app user was granted a role via the Business Manager on the Page connected to the targeted IG User, you will also need one of: `ads_management` `ads_read` If you are requesting the `shopping_product_tag_eligibility` field for product tagging, you will also need: `catalog_management` `instagram_shopping_tag_products`
Business Roles	Not applicable.	If you are requesting the `shopping_product_tag_eligibility` field for product tagging, the app user must have an admin role on the Business Manager that owns the IG User's Instagram Shop.
Instagram Shop	Not applicable.	If you are requesting the `shopping_product_tag_eligibility` field for product tagging, the IG User must have an approved Instagram Shop with a product catalog containing products.

Criação

Esta operação não é compatível.

Leitura

GET /<IG_USER_ID>

Consulta campos e bordas em uma conta comercial ou em uma conta de criador de conteúdo do Instagram.

If you are migrating from Marketing API Instagram Ads endpoints to Instagram Platform endpoints, be aware that some field names are different.

Sintaxe da solicitação

GET https://graph.facebook.com/<API_VERSION>/<IG_USER_ID>
  ?fields=<LIST_OF_FIELDS>
  &access_token=<ACCESS_TOKEN>

Parâmetros de caminho

Espaço reservado	Valor
`<API_VERSION>`	A versão da API.
`<IG_USER_ID>`	Obrigatório. Número de identificação do usuário do Instagram.

Parâmetros da string de consulta

Chave	Espaço reservado	Valor
`access_token`	`<ACCESS_TOKEN>`	Obrigatório. O token de acesso do usuário do app.
`fields`	`<LIST_OF_FIELDS>`	Lista separada por vírgulas dos campos de usuário do Instagram que você quer retornar para cada usuário no conjunto de resultados.

Campos

Os campos públicos podem ser retornados por uma borda usando a expansão de campo. Apenas alguns campos estarão disponíveis para acessar as contas do Instagram associadas à Página.

Nome do campo	Descrição
`alt_text` Público	Texto que descreve as imagens para fins de acessibilidade.
`biography` Público	Texto da bio do perfil.
`followers_count` Público	Número total de seguidores do Instagram do usuário.
`follows_count`	Número total de usuários do Instagram que o usuário segue.
`has_profile_pic`	Indica se a conta profissional do Instagram do usuário do seu app tem foto do perfil.
`id` Público	É o número de identificação do usuário no escopo do app. Disponível para contas do Instagram associadas à Página.
`is_published`	Indica se a conta do Instagram do usuário do app foi publicada. Disponível para contas do Instagram associadas à Página.
`legacy_instagram_user_id`	O ID do Instagram do usuário do app que foi criado para pontos de extremidade da API de Marketing na versão 21.0 e em versões anteriores. Disponível para contas do Instagram associadas à Página.
`media_count` Público	O número total de mídias do Instagram publicados na conta do usuário do seu app.
`name`	O nome do perfil no Instagram do usuário do seu app.
`profile_picture_url`	O URL da foto de perfil no Instagram do usuário do seu app.
`collaborative_media_search`	Procure uma mídia colaborativa específica por ID. Acesse via expansão de campo. Disponível apenas para a API do Instagram com o Login do Facebook.
`shopping_product_tag_eligibility`	Retorna `true` se o usuário do app estiver qualificado para a marcação de produtos após ter configurado uma Loja do Instagram. Caso contrário, retorna `false`.
`username` Público	O nome de usuário do perfil no Instagram do usuário do seu app.
`website` Público	O URL do site do usuário do seu app.

Bordas

Borda	Descrição
`agencies`	Uma lista de empresas que podem anunciar na conta profissional do Instagram.
`authorized_adaccounts`	Contas de anúncios que podem anunciar na conta profissional do Instagram.
`business_discovery`	Consulta dados sobre outros usuários do Instagram com uma conta comercial ou de criador de conteúdo.
`connected_threads_user`	Representa a conta do Threads conectada a uma conta do Instagram.
`content_publishing_limit`	Representa o uso atual da publicação de conteúdo de um usuário do Instagram.
`insights`	Representa as métricas de interação social sobre um usuário do Instagram.
`instagram_backed_threads_user`	Representa a conta do Threads associada a uma conta do Instagram.
`live_media`	Representa uma coleção de mídia do Instagram de vídeo ao vivo em um usuário da plataforma.
`media`	Representa uma coleção de mídias em um usuário do Instagram.
`media_publish`	Publica um contêiner do Instagram em um usuário do Instagram para Empresas.
`mentions`	Cria um comentário do Instagram em um comentário ou mídia do Instagram com legenda em que um usuário tenha sido @mencionado por outro.
`mentioned_comment`	Consulta dados sobre um comentário do Instagram em que um usuário foi @mencionado por outro.
`mentioned_media`	Consulta dados sobre uma mídia do Instagram em que um usuário foi @mencionado em uma legenda por outro.
`recently_searched_hashtags`	Consulta as hashtags do Instagram pesquisadas por um usuário nos últimos 7 dias.
`stories`	Representa uma coleção de objetos de mídia de story do Instagram em um usuário do Instagram.
`tags`	Representa uma coleção de mídias do Instagram em que um usuário foi marcado por outro.
`upcoming_events`	Uma lista de eventos que a conta profissional do Instagram está organizando.
`collaboration_invites`	Representa uma coleção de atributos de objeto `IG Media` (media_id, media_owner_username, caption, media_url) nos quais o usuário do Instagram foi convidado a colaborar.
`collaborative_media`	Representa uma coleção de mídia do Instagram em que o usuário é um colaborador aceito. Não inclui mídias que são propriedade direta do usuário. Disponível apenas para a API do Instagram com o Login do Facebook.

Resposta

Um objeto formatado por JSON contendo os campos e as bordas solicitadas e padrão.

{
  "<FIELD>":"<VALUE>",
  ...
}

Exemplo de cURL

Solicitação

curl -X GET \
  'https://graph.facebook.com/v25.0/17841405822304914?fields=biography%2Cid%2Cusername%2Cwebsite&access_token=EAACwX...'

Resposta

{
  "biography": "Dino data crunching app",
  "id": "17841405822304914",
  "username": "metricsaurus",
  "website": "http://www.metricsaurus.com/"
}

Atualização

Esta operação não é compatível.

Exclusão

Esta operação não é compatível.