Intégrer des publications Instagram sur un site avec oEmbed
L'endpoint oEmbed d'Instagram, GET /instagram_oembed?url=<POST_URL>, renvoie le HTML qui intègre un post ou un Reel Instagram public dans une page web, ainsi que version, provider_name, provider_url, type et width. Depuis le 15 mai 2026, il peut être appelé sans token d'accès, et le HTML charge embed.js d'Instagram pour afficher la publication.
easyCoexistence renvoie le permalink de chaque post Instagram connecté via list_social_posts, prêt à être transmis à oEmbed, et permet à Claude, ChatGPT ou votre propre code de publier, programmer et répondre aux commentaires et aux messages privés du compte, via l'API officielle de Meta.
Depuis cette date, l'API oEmbed d'Instagram de Meta peut être appelée sans token d'accès, dans toutes les versions.
Nombre de requêtes par heure autorisé par le guide oEmbed de Meta.
La plage acceptée par maxwidth ; maxheight n'est pas pris en charge.
Moment où author_name, author_url et les champs de vignette ont quitté les réponses oEmbed d'Instagram, dans toutes les versions de l'API.
Non pris en charge par l'endpoint oEmbed, pas plus que les posts de comptes privés, inactifs ou soumis à restriction d'âge.
Comment fonctionne l'endpoint oEmbed d'Instagram ?
Vous envoyez l'URL d'un post public et vous recevez le HTML qui l'affiche. L'endpoint fonctionne sur l'hôte principal de la Graph API de Meta, celui qu'utilisent les appels de Facebook Login, et non sur graph.instagram.com. La réponse est un petit objet JSON dont le champ html est inséré tel quel dans la page.
GET /instagram_oembed?url=https://www.instagram.com/p/<SHORTCODE>/
{
"version": "1.0",
"provider_name": "Instagram",
"provider_url": "https://www.instagram.com/",
"type": "rich",
"width": 658,
"html": "<EMBED_HTML>"
}Quelles URL sont acceptées ?
Trois formats, tels que le guide de Meta les liste pour le paramètre url, qui peut être envoyé en clair ou encodé en URL ; les deux exemples de requêtes du guide en montrent un de chaque :
- Posts à image unique et carrousels : https://www.instagram.com/p/{media-shortcode}/
- Vidéos et Reels : https://www.instagram.com/reel/{media-shortcode}/
- Profils : https://www.instagram.com/{username}
Faut-il un token d'accès ?
Plus depuis le 15 mai 2026, date à laquelle le changelog de Meta indique que l'API oEmbed d'Instagram peut être appelée sans token. Auparavant, les applications devaient obtenir la fonctionnalité Meta oEmbed Read via App Review et envoyer un token à chaque appel ; l'accès avec token fonctionne toujours. Le guide oEmbed de Meta autorise jusqu'à 1 000 requêtes par heure, et l'annonce de Meta sur l'accès sans token indique que les applications avec token peuvent obtenir des limites de débit plus élevées.
Quels paramètres accepte-t-il ?
Quatre en plus de url, d'après le guide de Meta et sa référence :
- maxwidth : de 320 à 658 ; l'intégration est par ailleurs responsive, et maxheight n'est pas pris en charge.
- hidecaption : true masque la légende du post ; la valeur par défaut est false.
- omitscript : true retire le script du HTML, pour les pages qui chargent embed.js une seule fois et appellent instgrm.Embeds.process().
- fields : limite la réponse aux champs indiqués.
Que contient la réponse ?
Six champs par défaut : html, le balisage à afficher ; version, toujours 1.0 ; provider_name et provider_url, qui désignent Instagram ; type, le type de ressource oEmbed ; et width, en pixels. Le 3 novembre 2025, Meta a retiré author_name, author_url, thumbnail_url, thumbnail_width et thumbnail_height des réponses pour les posts Instagram, dans toutes les versions de l'API. Pour les posts de votre propre compte, l'edge media renvoie toujours username, permalink et thumbnail_url.
Qu'est-ce qui ne peut pas être intégré ?
Le guide de Meta énumère ce que l'endpoint laisse de côté, ainsi qu'une règle d'usage :
- Les posts de comptes privés, inactifs ou soumis à restriction d'âge.
- Les comptes qui ont désactivé les intégrations.
- Les stories, et les pages qui affichent l'intégration dans un Shadow DOM.
- Tout usage au-delà d'un affichage côté front-end : Meta interdit formellement d'utiliser les métadonnées ou le contenu de l'endpoint à d'autres fins.
Comment intégrer les posts de votre propre compte ?
Prenez le permalink de chaque post et transmettez-le comme url. Avec easyCoexistence, list_social_posts renvoie les posts récents du compte connecté avec leurs permalinks, depuis Claude, ChatGPT ou votre propre code ; et comme l'appel oEmbed ne nécessite aucun token, votre site peut l'effectuer directement.
Erreurs courantes
- Envoyer le lien d'une Story. L'endpoint oEmbed de Meta ne prend pas en charge les Stories ; intégrez donc un post ou un Reel.
- Lire thumbnail_url dans la réponse. Meta l'a retiré, avec author_name et les autres champs de vignette, le 3 novembre 2025.
- Définir maxwidth en dessous de 320 ou au-dessus de 658. Meta n'accepte que des valeurs dans cette plage, et aucun maxheight du tout.
- Charger embed.js à chaque intégration. Avec omitscript à true, chargez le script une seule fois et appelez instgrm.Embeds.process().
De US$ 9 à US$ 0,75 par connexion et par mois, en baisse à mesure que vous ajoutez des connexions, avec un essai gratuit de 3 jours.
Questions fréquemment posées
Puis-je intégrer un Reel Instagram ?
Oui. Transmettez son URL https://www.instagram.com/reel/{media-shortcode}/, et l'endpoint renvoie le HTML d'intégration.
L'intégration Instagram est-elle responsive ?
Oui. Le guide de Meta indique que l'intégration est responsive, et maxwidth fixe sa largeur maximale.
Puis-je intégrer un profil Instagram ?
Oui. Le guide de Meta répertorie les URL de profil, https://www.instagram.com/{username}, parmi les formats acceptés par le paramètre url.
Puis-je utiliser les données oEmbed à des fins d'analyse ?
Non. Meta n'autorise l'endpoint que pour afficher la publication sur une page ou dans une application, et interdit les autres usages de ses métadonnées et de son contenu.
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