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.
Ce guide explique comment obtenir le profil et les contenus multimédias d’un·e utilisateur·ice Instagram.
Effectuez les étapes suivantes pour obtenir les données du profil d’un·e utilisateur·ice Instagram (champs) relatives à l’utilisateur·ice.
Consultez notre guide sur l’obtention des tokens d’accès et des autorisations pour obtenir le token d’accès pour utilisateur·ice Instagram de l’utilisateur·ice. Vous aurez besoin de l’autorisation instagram_graph_user_profile
. Vous devez donc demander l’étendue user_profile
lors de l’obtention de l’autorisation de l’utilisateur·ice.
Envoyez une demande au point de terminaison suivant :
GET /me?fields={fields}&access_token={access-token}
Remplacez {fields}
par une liste des champs de l’utilisateur·ice (séparés par des virgules) que vous souhaitez voir renvoyer. Remplacez également {access-token}
par le token d’accès de l’utilisateur·ice. Le point de terminaison GET /me
détermine l’ID de l’utilisateur·ice à partir du token et redirige la demande au nœud Utilisateur·ice.
curl -X GET \ 'https://graph.instagram.com/me?fields=id,username&access_token=IGQVJ...'
{ "id": "17841405793187218", "username": "jayposiris" }
Effectuez les étapes suivantes pour obtenir une collection de contenus multimédias sur un·e utilisateur·ice Instagram.
Consultez notre guide sur l’obtention des tokens d’accès et des autorisations pour obtenir le token d’accès utilisateur·ice Instagram de l’utilisateur·ice. Vous aurez besoin des autorisations instagram_graph_user_profile
et instagram_graph_user_media permissions
. Vous devez donc demander les étendues user_profile
et user_media
lors de l’obtention de l’autorisation de l’utilisateur·ice.
Envoyez une demande au point de terminaison suivant :
GET /me/media?fields={fields}&access_token={access-token}
Remplacez {fields}
par une liste des champs de contenus multimédias (séparés par des virgules) que vous souhaitez voir renvoyer pour chaque contenu multimédia inclus dans la réponse (ou omettez complètement le paramètre fields
si vous souhaitez juste les ID). Remplacez également {access-token}
par le token d’accès de l’utilisateur·ice. Le point de terminaison GET /me
détermine l’ID de l’utilisateur·ice à partir du token et redirige la demande au nœud Utilisateur·ice.
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..." } }
Effectuez les étapes suivantes pour obtenir les données (champs) relatives à une image, une vidéo ou un album.
Consultez notre guide sur l’obtention des tokens d’accès et des autorisations pour obtenir le token d’accès utilisateur·ice Instagram de l’utilisateur·ice. Vous aurez besoin de l’autorisation instagram_graph_user_media
. Vous devez donc demander l’étendue user_media
lors de l’obtention de l’autorisation de l’utilisateur·ice.
Envoyez une demande au point de terminaison suivant :
GET /{media-id}?fields={fields}&access_token={access-token}
Remplacez {media-id}
par l’ID de l’image, la vidéo ou l’album que vous souhaitez interroger. Remplacez {fields}
par une liste de champs de contenus multimédias (séparés par des virgules) que vous souhaitez renvoyer. Remplacez également {access-token}
par le token d’accès de l’utilisateur·ice.
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" }
Vous pouvez interroger l’arête des contenus multimédias de l’utilisateur·ice pour obtenir une collection de contenus multimédias sur l’utilisateur·ice et utiliser un élargissement de champ de sorte que la réponse inclue les champs de contenus multimédias relatifs à chaque contenu multimédia de la collection. Pour cela, envoyez une demande au point de terminaison suivant :
GET /me/media?fields={fields}&access_token={access-token}
Remplacez {fields}
par une liste des champs de contenus multimédias (séparés par des virgules) que vous souhaitez voir renvoyer pour chaque contenu multimédia de la collection. Remplacez également {access-token}
par le token d’accès de l’utilisateur·ice. Le point de terminaison GET /me
détermine l’ID de l’utilisateur·ice à partir du token et redirige la demande au nœud Utilisateur·ice.
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..." } }
Effectuez les étapes suivantes pour obtenir une collection de contenus multimédias d’images et de vidéos sur un contenu multimédia d’album.
Consultez notre guide sur l’obtention des tokens d’accès et des autorisations pour obtenir le token d’accès utilisateur·ice Instagram de l’utilisateur·ice. Vous aurez besoin de l’autorisation instagram_graph_user_media
. Vous devez donc demander l’étendue user_media
lors de l’obtention de l’autorisation de l’utilisateur·ice.
Envoyez une demande au point de terminaison suivant :
GET /{media-id}/children?fields={fields}&access_token={access-token}
Remplacez {media-id}
par l’ID de l’album que vous souhaitez interroger. Remplacez {fields}
par une liste des champs de contenus multimédias (séparés par des virgules) que vous souhaitez voir renvoyer pour chaque contenu multimédia d’image et de vidéo de la collection (ou omettez complètement le paramètre fields
si vous souhaitez juste les ID). Remplacez également {access-token}
par le token d’accès de l’utilisateur·ice.
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..." } }