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.
Este guia explica como obter o perfil e as mídias de um usuário do Instagram.
Siga estas etapas para obter os dados do perfil de um usuário do Instagram (campos) em Usuário.
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.
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.
curl -X GET \ 'https://graph.instagram.com/me?fields=id,username&access_token=IGQVJ...'
{ "id": "17841405793187218", "username": "jayposiris" }
Siga estas etapas para obter uma coleção de mídia de um usuário do Instagram.
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.
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.
curl -X GET \ 'https://graph.instagram.com/me/media?fields=id,caption&access_token=IGQVJ...'
{ "data": [ { "id": "17895695668004550", "caption": "" }, { "id": "17899305451014820", "caption": "" }, { "id": "17896450804038745", "caption": "" }, { "id": "17881042411086627", "caption": "" } ], "paging": { "cursors": { "after": "MTAxN...", "before": "NDMyN..." }, "next": "https://graph.faceb..." } }
Siga estas etapas para obter os dados (campos) sobre uma imagem, um vídeo ou um álbum.
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.
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.
curl -X GET \ 'https://graph.instagram.com/17895695668004550?fields=id,media_type,media_url,username,timestamp&access_token=IGQVJ...'
{ "id": "17895695668004550", "media_type": "IMAGE", "media_url": "https://fb-s-b-a.akamaihd.net/...", "username": "jayposiris" "timestamp": "2017-08-31T18:10:00+0000" }
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.
curl -X GET \ 'https://graph.instagram.com/me/media?fields=id,caption&access_token=IGQVJ...'
{ "data": [ { "id": "17895695668004550", "caption": "" }, { "id": "17899305451014820", "caption": "" }, { "id": "17896450804038745", "caption": "" }, { "id": "17881042411086627", "caption": "" } ], "paging": { "cursors": { "after": "MTAxN...", "before": "NDMyN..." }, "next": "https://graph.faceb..." } }
Siga estas etapas para obter uma coleção de mídia de imagens e vídeos em um álbum de mídia.
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.
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.
curl -X GET \ 'https://graph.instagram.com/17896450804038745/children?access_token=IGQVJ...'
{ "data": [ { "id": "17880997618081620" }, { "id": "17871527143187462" } ], "paging": { "cursors": { "after": "MTAxN...", "before": "NDMyN..." }, "previous": "https://graph.faceb...", "next": "https://graph.faceb..." } }