Contenu multimédia

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.

Représente une image, une vidéo ou un album.

Création

Cette opération n’est pas prise en charge.

Lecture

GET /{media-id}

Obtient des champs et des arêtes sur une image, une vidéo ou un album.

Conditions requises

Type	Condition requise
Tokens d’accès	Utilisateur·ice Instagram
Autorisations	`instagram_graph_user_media`

Syntaxe de la requête

GET https://graph.instagram.com/{media-id}
  ?fields={fields}
  &access_token={access-token}

Paramètres de la chaîne de requête

Inclure les paramètres de chaîne de requête suivants pour augmenter la demande.

Clé	Valeur
`access_token` Obligatoire Chaîne	Token d’accès pour utilisateur Instagram de l’utilisateur·ice de l’application.
`fields` Liste d’éléments séparés par une virgule	Liste des arêtes et des champs (séparés par des virgules) à renvoyer. En cas d’omission, les champs par défaut sont renvoyés.

Champs

Vous pouvez utiliser le paramètre de chaîne de requête fields pour demander les champs suivants sur un contenu multimédia.

Nom du champ	Description
`caption`	Texte de légende du contenu multimédia. Ne peut pas être renvoyé pour les contenus multimédia d’albums. Remarque : lorsque la légende contient des emojis, le format d’encodage doit être UTF-8 et la longueur des caractères peut être affectée selon l’emoji utilisé.
`id`	ID du contenu multimédia.
`is_shared_to_feed`	Pour les reels uniquement. Quand la valeur renvoyée est `true`, indique que le reel peut apparaître à la fois dans l’onglet Fil et l’onglet Reels. Quand la valeur renvoyée est `false`, indique que le reel peut apparaître uniquement dans l’onglet Reels. Aucune des deux valeurs ne détermine si le reel apparaît effectivement dans l’onglet Reels, car le reel peut ne pas respecter les critères d’éligibilité ou peut ne pas être sélectionné par notre algorithme. Consultez les caractéristiques des reels pour connaître les critères d’éligibilité.
`media_type`	Type du contenu multimédia. La valeur peut être `IMAGE`, `VIDEO` ou `CAROUSEL_ALBUM`.
`media_url`	URL du contenu multimédia.
`permalink`	URL permanente du contenu multimédia. Ne sera pas précisée si le contenu multimédia comprend des éléments protégés par des droits d’auteur ou a fait l’objet d’un signalement pour cause de violation des droits d’auteur.
`thumbnail_url`	URL de l’image miniature du contenu multimédia. Uniquement disponible sur le contenu multimédia `VIDEO`.
`timestamp`	Date de publication du contenu multimédia au format ISO 8601.
`username`	Nom d’utilisateur·ice du propriétaire du contenu multimédia.

Arêtes

Vous pouvez interroger les arêtes suivantes en tant que paramètres du chemin ou en utilisant le paramètre de chaîne de requête fields.

Arête	Description
`children`	Obtient une liste de contenus multimédia sur les contenus multimédia d’albums. Uniquement disponible sur le contenu multimédia `CAROUSEL_ALBUM`.

Réponse

Objet au format JSON contenant des arêtes et des champs demandés et par défaut.

{
  "{field}":"{value}",
  ...
}

Exemple de cURL

Requête

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

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"
}

Mise à jour

Cette opération n’est pas prise en charge.

Suppression

Cette opération n’est pas prise en charge.