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.

Obtenir des profils d’utilisateur·ice et des contenus multimédias de l’utilisateur·ice

Ce guide explique comment obtenir le profil et les contenus multimédias d’un·e utilisateur·ice Instagram.

Obtenir le profil d’un·e utilisateur·ice

Effectuez les étapes suivantes pour obtenir les données du profil d’un·e utilisateur·ice Instagram (champs) relatives à l’utilisateur·ice.

Étape 1 : Obtenir un token d’accès et des autorisations

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.

Étape 2 : Interroger le nœud 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.

Exemple de requête

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

Exemple de réponse

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

Obtenir les contenus multimédias d’un·e utilisateur·ice

Effectuez les étapes suivantes pour obtenir une collection de contenus multimédias sur un·e utilisateur·ice Instagram.

Étape 1 : Obtenir un token d’accès et des autorisations

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.

Étape 2 : Interroger l’arête des contenus multimédias 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.

Exemple de requête

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

Exemple de réponse

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

Obtenir les données de contenus multimédias

Effectuez les étapes suivantes pour obtenir les données (champs) relatives à une image, une vidéo ou un album.

Étape 1 : Obtenir un token d’accès et des autorisations

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.

Étape 2 : Interroger le nœud Contenu multimédia

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.

Exemple de requête

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

Exemple de réponse

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

Étape 2 (autre possibilité) : Interroger l’arête des contenus multimédias de l’utilisateur·ice

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.

Exemple de requête

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

Exemple de réponse

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

Obtenir le contenu d’un album

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.

Étape 1 : Obtenir un token d’accès et des autorisations

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.

Étape 2 : Interroger l’arête des contenus multimédias enfants

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.

Exemple de requête

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

Exemple de réponse

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