Contenu multimédia de l’utilisateur·ice

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 collection d’objets Contenu multimédia sur un Utilisateur·ice.

Création

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

Lecture

GET /{user-id}/media

Obtenez une collection d’objets Contenu multimédia sur un Utilisateur·ice.

Limites

Les stories ne sont pas prises en charge.
Le contenu multimédia dans des publications promues n’est pas pris en charge.
Renvoie un maximum de 10 000 contenu multimédias les plus récents.

Conditions requises

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

Syntaxe de la requête

GET https://graph.instagram.com/{api-version}/{user-id}/media
  ?access_token={access-token}

Paramètres du chemin

Espace réservé	Valeur
`{api-version}` Chaîne	Version de l’API.
`{user-id}` Obligatoire Chaîne	ID utilisateur·ice spécifique à une application (versions 11.0 et ultérieures) ou ID utilisateur·ice brut (toutes les versions) de l’utilisateur·ice de l’application.

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 de champs de contenu multimédia séparés par une virgule à renvoyer par l’élargissement de champ pour chaque nœud Contenu multimédia dans l’ensemble de résultats.
`since` Horodatage	Horodatage Unix ou valeur des données `strtotime` qui indiquent le début d’une plage de données temporelles. Consultez Pagination en fonction du temps.
`until` Horodatage	Horodatage Unix ou valeur des données `strtotime` qui indiquent la fin d’une plage de données temporelles. Consultez Pagination en fonction du temps.

Réponse

Objet au format JSON contenant les données que vous avez demandées.

{
  "data": [],
  "paging": {}
}

Contenus de la réponse

Propriété	Valeur
`data`	Tableau de contenu multimédia sur l’utilisateur.
`paging`	Objet contenant des curseurs de pagination et des URL de récupération d’ensembles de données précédents/suivants.

Exemple de cURL

Requête

curl -X GET \
  'https://graph.instagram.com/v21.0/10218560180051171/media?access_token=IGQVJ...'

Réponse

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

Mise à jour

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

Suppression

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