Récupérer les publications d'un compte Instagram via l'API
GET /<IG_ID>/media renvoie les publications d'un compte Instagram professionnel sous forme d'objets IG Media, dans la limite de ses 10 000 publications les plus récentes. Demandez des champs comme id, media_type, media_url, permalink, thumbnail_url et timestamp, et lisez les éléments d'un carrousel via children. Les réponses contiennent des curseurs before et after pour la pagination, et since et until les limitent par date. Avec Instagram Login, l'appel est adressé à graph.instagram.com.
easyCoexistence liste les publications d'un compte Instagram connecté avec list_social_posts, de 1 à 100 à la fois, depuis Claude, ChatGPT ou votre propre code, via l'API officielle de Meta, avec le token ajouté.
Nombre maximal de médias les plus récemment créés que l'edge media renvoie, selon la référence IG User Media de Meta.
Les paramètres de pagination temporelle de l'edge media, qui acceptent des timestamps Unix ou des valeurs strtotime.
Où lire les Stories : l'edge media ne renvoie pas les médias Story.
Le type de média qui renvoie thumbnail_url, l'URL de l'image miniature du média.
Comment Meta indique de traiter media_url, qu'il omet pour certaines vidéos ; utilisez alors permalink ou thumbnail_url à la place.
Comment récupérer les publications d'un compte ?
Avec un GET sur l'edge media du compte, en nommant les champs à renvoyer ; sans le paramètre fields, l'exemple de Meta ne renvoie que l'id de chaque publication. Avec Instagram Login, la requête est adressée à graph.instagram.com avec un token d'accès Instagram User qui porte instagram_business_basic, et la réponse liste les publications dans data, avec un objet paging pour la page suivante.
GET https://graph.instagram.com/<IG_ID>/media
?fields=id,media_type,media_url,permalink,thumbnail_url,timestamp
&limit=25
&access_token=<ACCESS_TOKEN>
{
"data": [
{
"id": "<IG_MEDIA_ID>",
"media_type": "IMAGE",
"media_url": "<CDN_URL>",
"permalink": "https://www.instagram.com/p/<SHORTCODE>/",
"timestamp": "2026-10-30T14:02:11+0000"
}
],
"paging": {
"cursors": { "before": "<CURSOR>", "after": "<CURSOR>" },
"next": "<NEXT_PAGE_URL>"
}
}Quels champs chaque publication peut-elle renvoyer ?
Ceux de l'objet IG Media, listés dans la référence de Meta ; ne demandez que ceux que vous utilisez. Deux lignes de cette référence, caption et media_product_type, portent la mention « Disponible pour l'Instagram API avec Facebook Login uniquement » : vérifiez-les par rapport à votre configuration avant de vous y fier :
Comment fonctionne la pagination ?
Par curseurs. L'objet paging porte les curseurs before et after et, tant qu'il reste des résultats, une URL next ; le guide de l'API Graph de Meta indique d'arrêter lorsque next n'apparaît plus, car une page peut contenir moins d'éléments que ne le demande limit. L'edge media pagine aussi dans le temps : since et until acceptent des timestamps Unix ou des valeurs strtotime et restreignent les résultats à cette plage.
Comment lire les photos et vidéos d'un carrousel ?
Par l'edge children. Une publication dont le media_type est CAROUSEL_ALBUM liste ses éléments avec GET /<IG_MEDIA_ID>/children, avec le même token et la même permission que l'edge media, et chaque élément est un objet IG Media doté de son propre id, media_type et media_url. Meta précise que certains champs, permalink notamment, ne peuvent pas être utilisés sur les photos d'un album.
GET https://graph.instagram.com/<IG_MEDIA_ID>/children
?fields=id,media_type,media_url
&access_token=<ACCESS_TOKEN>Pourquoi media_url manque-t-il sur certaines publications ?
Meta le retire des vidéos qui contiennent un audio protégé par le droit d'auteur ou sous licence, notamment les titres de la bibliothèque audio d'Instagram, ainsi que des médias signalés pour violation de droits d'auteur, même sur les publications du compte lui-même. Sa référence indique de considérer media_url comme facultatif et de se rabattre sur permalink ou thumbnail_url. Une vidéo Live ne peut être lue que pendant sa diffusion.
Comment afficher les publications sur un site web ?
Depuis votre serveur, avec le token de longue durée du compte, qui dure 60 jours et doit être renouvelé avant son expiration. Reliez chaque vignette à son permalink et actualisez la liste selon un calendrier : Meta sert les médias via des URL CDN respectueuses de la vie privée, qui cessent de renvoyer un fichier une fois le contenu supprimé ou expiré. Pour afficher une publication telle qu'Instagram la présente, transmettez plutôt son permalink à l'endpoint oEmbed.
Comment lister les publications via easyCoexistence ?
Avec list_social_posts, qui prend account_id et un paramètre limit compris entre 1 et 100, 25 par défaut, et renvoie les publications récentes du compte avec leurs identifiants, types de média, URL des médias, miniatures, permalinks, timestamps et nombres de likes et de commentaires. L'outil lit les publications les plus récentes, jusqu'à 100, et n'a pas de curseur pour les pages suivantes ni d'autres champs.
Erreurs courantes
- Chercher les Stories dans l'edge media. Meta les exclut ; GET /<IG_ID>/stories les renvoie pendant leurs 24 heures d'existence.
- Bâtir un flux sur media_url seul. Meta l'omet pour certaines vidéos ; conservez permalink ou thumbnail_url comme solution de repli.
- Demander permalink sur les éléments d'un carrousel. Meta ne le renvoie pas pour les photos d'un album ; liez plutôt la publication parente.
- Considérer une page courte comme la dernière. Une page peut contenir moins d'éléments que limit ; arrêtez seulement lorsque la pagination n'a plus de next.
De US$ 9 à US$ 0,75 par connexion et par mois, le prix baisse à mesure que vous ajoutez des connexions, avec un essai gratuit de 3 jours.
Questions fréquemment posées
Combien de publications l'API Instagram peut-elle renvoyer ?
Jusqu'aux 10 000 plus récentes, une page à la fois depuis l'edge media. Les Stories proviennent de l'edge stories séparé, tant qu'elles sont disponibles.
L'edge media inclut-il les Reels ?
Oui. Un Reel est un objet IG Media comme une photo, signalé avec media_type VIDEO ; les Stories sont ce que l'edge media laisse de côté.
Puis-je obtenir les publications d'un autre compte ?
Pas depuis l'edge media, qui lit le compte derrière le token. Business Discovery renvoie les publications d'un autre compte professionnel ou créateur, avec Facebook Login ou Unified Login.
Pourquoi une ancienne media_url ne fonctionne-t-elle plus ?
Les URL CDN de Meta sont respectueuses de la vie privée : elles cessent de renvoyer le média une fois le contenu supprimé ou expiré. Demandez donc des URL à jour lorsque vous en avez besoin.
Poursuivre la lecture
Connectez votre premier canal en deux minutes.
Aucune validation de plateforme à attendre. Connectez WhatsApp, Instagram, TikTok ou un autre canal, puis demandez à votre IA de publier, de répondre ou de faire un rapport, et regardez-la travailler.
- 3 jours gratuits
- Résiliable à tout moment
- API officielles uniquement
- Supervisé 24/7
Vérifié le