Como criar

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

Leitura

GET /{ig-user-id}

Obter campos e bordas em uma conta empresarial ou em uma conta de criador de conteúdo do Instagram.

Requisitos

TipoDescrição

Tokens de acesso

Usuário.

Funções na empresa

Se você estiver solicitando o campo shopping_product_tag_eligibility para marcação de produtos, o usuário do app precisará ter uma função de administrador no Gerenciador de Negócios da Loja do Instagram.

Loja do Instagram

Se você estiver solicitando o campo shopping_product_tag_eligibility para a marcação de produtos, o usuário do Instagram precisará ter uma Loja do Instagram aprovada com um catálogo que inclui produtos.

Permissões

instagram_basic
pages_read_engagement
pages_show_list


Caso uma função na Página tenha sido concedida ao usuário do app por meio do Gerenciador de Negócios, você também precisará obter uma destas permissões:


ads_management
business_management


Se você estiver solicitando o campo shopping_product_tag_eligibility para marcação de produtos, também precisará do seguinte:


catalog_management
instagram_shopping_tag_products

Sintaxe da solicitação

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

Parâmetros de caminho

Espaço reservadoValor

{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

ChaveEspaço reservadoValor

access_token

{access-token}

Obrigatório. O token de acesso do usuário do app.

fields

{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 por meio da expansão de campo.

Nome do campoDescrição

biography
Público

Texto da biografia do perfil.

id
Público

ID do usuário no escopo do app.

ig_id

Número de identificação do usuário do Instagram. Usado com a API do Instagram antiga, agora obsoleta. Em vez disso, use id.

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.

media_count
Público

Número total de mídias do Instagram publicadas em um usuário.

name

Nome do perfil.

profile_picture_url

URL da foto do perfil.

shopping_product_tag_eligibility

Retorna true se o usuário do app estiver qualificado para marcação de produtos, pois configurou uma Loja do Instagram. Caso contrário, retorna false.

username
Público

Nome de usuário do perfil.

website
Público

URL do site do perfil.

Bordas

BordaDescrição

business_discovery

Obtém dados sobre outros usuários do Instagram com uma conta empresarial ou de criador de conteúdo.

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.

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

Obtém dados sobre um comentário do Instagram em que um usuário foi @mencionado por outro.

mentioned_media

Obtém dados sobre uma mídia do Instagram em que um usuário foi @mencionado em uma legenda por outro.

recently_searched_hashtags

Obtém 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.

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/v19.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.