On September 4, 2024, we announced the deprecation of the Instagram Basic Display API.

Starting December 4, 2024, all requests to the Instagram Basic Display API will return an error message. We recommend that you migrate your app to the Instagram API to avoid any disruption to your services.

Visit our News for Developers blog post to learn more.

Obter perfis e mídia do usuário

Este guia explica como obter o perfil e as mídias de um usuário do Instagram.

Obter o perfil de um usuário

Siga estas etapas para obter os dados do perfil de um usuário do Instagram (campos) em Usuário.

Etapa 1: obter um token de acesso e permissões

Siga nosso guia sobre tokens de acesso e permissões para obter o token de acesso de usuário do Instagram. Você precisará da permissão instagram_graph_user_profile. Por isso, solicite o escopo user_profile quando receber a autorização do usuário.

Etapa 2: consultar o nó de usuário

Envie uma solicitação ao ponto de extremidade a seguir:

GET /me?fields={fields}&access_token={access-token}

Substitua {fields} por uma lista separada por vírgulas dos campos de usuário que você quer que sejam retornados e troque {access-token} pelo token de acesso do usuário. O ponto de extremidade GET /me determinará o número de identificação do usuário e redirecionará a solicitação para o nó de usuário.

Exemplo de solicitação

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

Exemplo de resposta

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

Obter as mídias de um usuário

Siga estas etapas para obter uma coleção de mídia de um usuário do Instagram.

Etapa 1: obter um token de acesso e permissões

Siga nosso guia sobre tokens de acesso e permissões para obter o token de acesso de usuário do Instagram. Você precisará das permissões instagram_graph_user_profile e instagram_graph_user_media permissions. Por isso, solicite os escopos user_profile e user_media quando receber a autorização do usuário.

Etapa 2: consultar a borda de mídia do usuário

Envie uma solicitação ao ponto de extremidade a seguir:

GET /me/media?fields={fields}&access_token={access-token}

Substitua {fields} por uma lista separada por vírgulas dos campos de mídia que você quer que sejam retornados para cada mídia incluída na resposta (ou omita o parâmetro fields se quiser obter somente os números de identificação) e troque {access-token} pelo token de acesso do usuário. O ponto de extremidade GET /me determinará o número de identificação do usuário e redirecionará a solicitação para o nó de usuário.

Exemplo de solicitação

curl -X GET \
  'https://graph.instagram.com/me/media?fields=id,caption&access_token=IGQVJ...'

Exemplo de resposta

{
  "data": [
    {
      "id": "17895695668004550",
      "caption": ""
    },
    {
      "id": "17899305451014820",
      "caption": ""
    },
    {
      "id": "17896450804038745",
      "caption": ""
    },
    {
      "id": "17881042411086627",
      "caption": ""
    }
  ],
  "paging": {
    "cursors": {
      "after": "MTAxN...",
      "before": "NDMyN..."
      },
    "next": "https://graph.faceb..."
  }
}

Obter dados de mídia

Siga estas etapas para obter os dados (campos) sobre uma imagem, um vídeo ou um álbum.

Etapa 1: obter um token de acesso e permissões

Siga nosso guia sobre tokens de acesso e permissões para obter o token de acesso de usuário do Instagram. Você precisará da permissão instagram_graph_user_media. Por isso, solicite o escopo user_media quando receber a autorização do usuário.

Etapa 2: consultar o nó de mídia

Envie uma solicitação ao ponto de extremidade a seguir:

GET /{media-id}?fields={fields}&access_token={access-token}

Substitua {media-id} pelo ID da imagem, do vídeo ou do álbum que você quer consultar, {fields} por uma lista separada por vírgulas dos campos de mídia a serem retornados e {access-token} pelo token de acesso do usuário.

Exemplo de solicitação

curl -X GET \
  'https://graph.instagram.com/17895695668004550?fields=id,media_type,media_url,username,timestamp&access_token=IGQVJ...'

Exemplo de resposta

{
  "id": "17895695668004550",
  "media_type": "IMAGE",
  "media_url": "https://fb-s-b-a.akamaihd.net/...",
  "username": "jayposiris"
  "timestamp": "2017-08-31T18:10:00+0000"
}

Etapa 2 (alternativa): consultar a borda de mídia do usuário

Você pode consultar a borda de mídia do usuário para obter uma coleção de mídia do usuário e usar a expansão de campo para que a resposta inclua campos de mídia em cada mídia na coleção. Para fazer isso, envie uma solicitação ao ponto de extremidade a seguir:

GET /me/media?fields={fields}&access_token={access-token}

Substitua {fields} por uma lista separada por vírgulas dos campos de mídia que você quer que sejam retornados para cada mídia na coleção e troque {access-token} pelo token de acesso do usuário. O ponto de extremidade GET /me determinará o número de identificação do usuário e redirecionará a solicitação para o nó de usuário.

Exemplo de solicitação

curl -X GET \
  'https://graph.instagram.com/me/media?fields=id,caption&access_token=IGQVJ...'

Exemplo de resposta

{
  "data": [
    {
      "id": "17895695668004550",
      "caption": ""
    },
    {
      "id": "17899305451014820",
      "caption": ""
    },
    {
      "id": "17896450804038745",
      "caption": ""
    },
    {
      "id": "17881042411086627",
      "caption": ""
    }
  ],
  "paging": {
    "cursors": {
      "after": "MTAxN...",
      "before": "NDMyN..."
      },
    "next": "https://graph.faceb..."
  }
}

Obter conteúdo do álbum

Siga estas etapas para obter uma coleção de mídia de imagens e vídeos em um álbum de mídia.

Etapa 1: obter um token de acesso e permissões

Siga nosso guia sobre tokens de acesso e permissões para obter o token de acesso de usuário do Instagram. Você precisará da permissão instagram_graph_user_media. Por isso, solicite o escopo user_media quando receber a autorização do usuário.

Etapa 2: consultar a borda de mídia derivada

Envie uma solicitação ao ponto de extremidade a seguir:

GET /{media-id}/children?fields={fields}&access_token={access-token}

Substitua {media-id} pelo ID do álbum que você quer consultar, {fields} por uma lista separada por vírgulas dos campos de mídia a serem retornados para cada mídia na coleção (ou omita o parâmetro fields se quiser obter somente os números de identificação) e troque {access-token} pelo token de acesso do usuário.

Exemplo de solicitação

curl -X GET \
  'https://graph.instagram.com/17896450804038745/children?access_token=IGQVJ...'

Exemplo de resposta

{
  "data": [
    {
      "id": "17880997618081620"
    },
    {
      "id": "17871527143187462"
    }
  ],
  "paging": {
    "cursors": {
      "after": "MTAxN...",
      "before": "NDMyN..."
      },
    "previous": "https://graph.faceb...",
    "next": "https://graph.faceb..."
  }
}