Este documento foi atualizado.
A tradução para Português (Brasil) não foi concluída ainda.

Atualização em inglês: 15 de jun de 2021

Usuário

Representa um perfil de usuário do Instagram.

Os IDs do usuário no escopo do aplicativo (ASIDs, pelas iniciais em inglês) foram lançados com a versão 11.0 da API. Você ainda poderá consultar os usuários pelos números de identificação brutos deles ou os ASIDs equivalentes. No entanto, as chamadas da versão 11.0 e posteriores receberão ASIDs como resposta.

Os ASIDs substituirão os números de identificação do usuário brutos em aproximadamente dois anos, quando a versão 10.0 for descontinuada. Por isso, recomendamos que você comece a mapear os usuários do seu aplicativo aos ASIDs equivalentes.

Como criar

Esta operação não é suportada.

Leitura

GET /{user-id}

Obtenha campos e bordas em um usuário.

Limitações

Os números de identificação do usuário da API antiga do Instagram não são compatíveis.

Requisitos

Tipo	Requisito
Tokens de acesso	Usuário do Instagram
Permissões	`instagram_graph_user_profile`. O campo `media_count` também exige `instagram_graph_user_media`.

Sintaxe da solicitação

GET https://graph.instagram.com/{api-version}/{user-id}
  ?fields={fields}
  &access_token={access-token}

Parâmetros de caminhos

Espaço reservado	Valor
`{api-version}` Cadeia de caracteres	Versão da API.
`{user-id}` Obrigatório Cadeia de caracteres	Os IDs do usuário no escopo do aplicativo (para a versão 11.0 ou superiores) ou número de identificação bruto do usuário (em todas as versões)

Parâmetros da cadeia de caracteres de consulta

Inclua o parâmetro da cadeia de caracteres de consulta a seguir para ampliar a solicitação.

Chave	Valor
`access_token` Obrigatório Cadeia de caracteres	O token de acesso do usuário do Instagram do usuário do aplicativo.
`fields` Lista separada por vírgulas	Uma lista separada por vírgulas dos campos e bordas que devem ser retornados. Se omitida, os campos padrão serão retornados.

Campos

Use o parâmetro de cadeia de caracteres de consulta fields para solicitar os seguintes campos em um usuário.

Nome do campo	Descrição
`account_type`	O tipo de conta do usuário. Pode ser `BUSINESS`, `MEDIA_CREATOR` ou `PERSONAL`.
`id`	Os IDs do usuário no escopo do aplicativo (para a versão 11.0 ou superiores) ou número de identificação bruto do usuário (para a versão 10.0 ou anteriores).
`media_count`	O número de mídia no usuário. Este campo requer a permissão `instagram_graph_user_media`.
`username`	O nome que o usuário usa.

Bordas

Você pode solicitar as bordas a seguir como parâmetros de caminho ou usar o parâmetro de cadeia de caracteres de consulta fields.

Borda	Descrição
`media`	Obtenha uma lista de mídia no usuário.

Resposta

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

{
  "{field}":"{value}",
  ...
}

Exemplo de cURL

Solicitação

curl -X GET \
  'https://graph.instagram.com/v19.0/10218560180051171?fields=id,username&access_token=IGQVJ...'

Resposta

{
  "id": "17841405793187218",
  "username": "jayposiris"
}

Atualização

Esta operação não é aceita.

Exclusão

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