API Instagram 2026 : de votre app à votre première publication
En 2026, l'API Instagram mène une app à sa première publication en six étapes : un compte professionnel, une configuration de connexion, une app Meta, des permissions au bon niveau d'accès, un token d'accès, puis un conteneur média créé avec POST /<IG_ID>/media et publié avec media_publish. Commentaires, messages privés, webhooks, insights et limites de Meta viennent ensuite. Pour les nouvelles apps, Meta recommande Unified Login.
easyCoexistence transforme les étapes 2 à 5 en une seule connexion avec Instagram : son app Meta gère la connexion, renouvelle le token avant son expiration et vérifie le compte toutes les 6 heures, pendant que Claude, ChatGPT ou votre propre plateforme publie, programme, répond aux commentaires et aux messages privés et lit les insights via l'API officielle de Meta.
Unified Login, recommandé pour les nouvelles intégrations, ainsi qu'Instagram Login et Facebook Login, conservés pour les intégrations existantes.
Les nouvelles apps Meta créées ne peuvent pas configurer l'API Instagram avec Instagram Login, selon le guide de migration de Meta.
Durée de vie d'un token d'accès Instagram User de longue durée ; un renouvellement est possible à partir de 24 heures.
Publications via l'API qu'un compte peut effectuer sur une période glissante de 24 heures ; un carrousel compte pour une seule.
Durée habituelle de l'App Review ; Meta indique qu'une demande est généralement traitée en moins d'une semaine.
Quelles sont les étapes entre une nouvelle app et une première publication ?
Six étapes mènent à la première publication, et quatre autres définissent ce que fait l'app ensuite. Le compte doit être professionnel, l'app choisit l'une des trois configurations de connexion de Meta, le propriétaire du compte accorde les permissions, et le serveur de l'app conserve un token. Publier se fait ensuite en deux appels. Commentaires, messages privés, webhooks, insights et limites suivent, et les dernières sections indiquent la page qui détaille chaque étape.
Étape 1 : quel compte Instagram fonctionne avec l'API ?
Un compte professionnel, de type entreprise ou créateur. L'Instagram Platform de Meta ne sert que les comptes professionnels, et les deux types fonctionnent de la même façon pour publier, commenter, gérer les messages privés et lire les insights. Un compte personnel passe en professionnel dans l'app Instagram, sous « Type de compte et outils », et un compte privé devient public à cette occasion. Instagram Login et Unified Login n'exigent aucune Page liée, alors que Facebook Login en demande une.
Étape 2 : quelle configuration de connexion l'app doit-elle utiliser ?
Meta en documente trois, et ce choix fixe l'hôte, le token et les noms de permissions. Sa vue d'ensemble recommande Unified Login pour les nouvelles intégrations, sa page Unified Login indique que les nouvelles fonctionnalités de l'API Instagram n'y sont publiées, et son guide de migration précise que les apps nouvellement créées ne peuvent pas configurer Instagram Login. Les intégrations Instagram Login existantes continuent de fonctionner, sans date de fin annoncée.
- Unified Login : le client se connecte avec Instagram ou via Facebook Login, choisit un Business Portfolio, et l'app reçoit un token Business Integration System User.
- Instagram Login : le propriétaire se connecte avec Instagram, et les appels passent par graph.instagram.com avec un token Instagram User et les permissions instagram_business_*.
- Facebook Login : le compte doit être lié à une Page que la personne peut gérer, avec les permissions instagram_* et Page.
Étape 3 : comment créer l'app Meta ?
Dans l'App Dashboard, selon un parcours qui dépend de la configuration. Le guide Unified Login de Meta part d'une app dotée du cas d'usage « Manage messaging & content on Instagram », détenue par un Business Portfolio. Sous « API setup with Unified login », l'app crée une configuration dont le config_id désigne les permissions et ressources à demander, enregistre une URL de redirection HTTPS et copie l'URL de connexion. Une app Instagram Login existante conserve « API setup with Instagram login », où se trouvent son ID d'app Instagram et son secret.
Étape 4 : quelles permissions et quel niveau d'accès l'app doit-elle avoir ?
Une permission par fonctionnalité, accordée par le propriétaire du compte à la connexion. Unified Login utilise la famille instagram_*, comme instagram_content_publish et instagram_manage_comments, et Instagram Login les noms instagram_business_*. Le Standard Access, par défaut, couvre les comptes que vous possédez ou gérez et les personnes ayant un rôle sur l'app. Servir les comptes d'autres entreprises demande Advanced Access, accordé permission par permission via l'App Review, avec la Business Verification.
Étape 5 : comment l'app obtient-elle un token d'accès ?
À partir de la connexion du propriétaire, échangé côté serveur, jamais dans un navigateur ou une app mobile. Avec Instagram Login, la redirection transmet un code valable une heure et utilisable une seule fois ; il devient un token de courte durée, puis un token de longue durée valable 60 jours, renouvelable une fois qu'il a un jour. Avec Unified Login, le code devient un token Business Integration System User, dont l'expiration dépend de la configuration.
Étape 6 : comment publier une première publication ?
En deux appels. POST /<IG_ID>/media avec une image_url publique, que Meta récupère elle-même, crée un conteneur ; POST /<IG_ID>/media_publish avec l'ID de ce conteneur comme creation_id le publie et renvoie l'ID du média. Les images doivent être au format JPEG. Pour un Reel ou une autre vidéo, vérifiez le status_code du conteneur jusqu'à ce qu'il affiche FINISHED, car une publication plus tôt échoue.
POST https://graph.instagram.com/v26.0/<IG_ID>/media
?image_url=https://www.example.com/images/first-post.jpg
&caption=Hello%20from%20the%20API
&access_token=<ACCESS_TOKEN>
{ "id": "<IG_CONTAINER_ID>" }
POST https://graph.instagram.com/v26.0/<IG_ID>/media_publish
?creation_id=<IG_CONTAINER_ID>
&access_token=<ACCESS_TOKEN>
{ "id": "<IG_MEDIA_ID>" }Étape 7 : comment fonctionnent les commentaires et les messages privés ?
Les deux démarrent avec quelqu'un d'autre. GET /<IG_MEDIA_ID>/comments renvoie jusqu'à 50 commentaires de premier niveau par requête, POST /<IG_COMMENT_ID>/replies répond à l'un d'eux publiquement, et une réponse privée envoie au commentateur un seul message privé dans les 7 jours suivant le commentaire. Les messages privés vont aux personnes qui ont écrit en premier, dans une fenêtre standard de 24 heures pour la plupart des actions, une fois que le propriétaire active « Autoriser l'accès aux messages » dans l'app Instagram.
Étape 8 : comment les webhooks indiquent-ils à l'app ce qui s'est passé ?
Meta envoie un POST en JSON à un endpoint HTTPS, qui se valide une fois en renvoyant hub.challenge, et signe chaque événement dans X-Hub-Signature-256 avec un HMAC-SHA256 du payload, à partir du secret de l'app. L'app sélectionne des champs comme comments et messages dans l'App Dashboard, puis abonne chaque compte via son edge subscribed_apps. Les notifications ne parviennent qu'aux apps en mode Live, et les notifications de commentaires exigent l'Advanced Access.
Étape 9 : comment l'app lit-elle les insights ?
À partir de deux edges : GET /<IG_ID>/insights pour le compte et GET /<IG_MEDIA_ID>/insights pour une publication, un Reel ou une Story. Les métriques de compte comme reach, views et accounts_engaged prennent period=day avec metric_type=total_value. views a remplacé impressions en 2025, certaines métriques exigent au moins 100 abonnés, et Meta précise que les données peuvent accuser un retard allant jusqu'à 48 heures.
Quelles limites encadrent l'app ?
Meta fixe ses principales limites par compte, de sorte qu'un nouveau compte dispose de son propre quota au lieu d'en partager un :
- Appels : 4 800 fois les impressions du compte sur 24 heures glissantes, par app et par compte, hors messagerie.
- Publication : 100 publications via l'API et 400 conteneurs média par compte sur 24 heures.
- Messagerie : 100 appels de l'API Send par seconde pour le texte, et 750 réponses privées par heure sur les publications et les Reels.
- Conteneurs : un conteneur non publié pendant 24 heures expire et doit être recréé.
Quelle page détaille chaque étape ?
Chaque étape dispose de sa propre page de référence dans cette documentation, avec les champs, erreurs et cas limites que ce guide laisse de côté. Les chemins ci-dessous se trouvent sous l'adresse du site, et la page de code présente côte à côte les appels de publication, de commentaires, d'insights et de webhooks en Python et Node.js :
Quel est le parcours avec easyCoexistence ?
Une connexion unique remplace les étapes 2 à 5 et la configuration des webhooks. Dans le dashboard, choisissez « Nouvelle connexion », puis Instagram, connectez-vous avec le compte Entreprise ou Créateur et approuvez ses cinq permissions instagram_business_*. L'app Meta d'easyCoexistence gère la connexion, renouvelle le token et vérifie le compte toutes les 6 heures. Claude, ChatGPT ou votre propre agent travaille ensuite via https://easycoexistence.com/api/mcp, votre code peut récupérer l'ID du compte et la base de l'API avec get_social_credentials, et les publications peuvent être programmées jusqu'à 90 jours à l'avance depuis la file d'attente d'easyCoexistence.
Erreurs courantes
- Démarrer une nouvelle app sur Instagram Login. Le guide de migration de Meta précise que les nouvelles apps ne peuvent pas le configurer, et sa vue d'ensemble recommande Unified Login pour les nouvelles intégrations.
- Appeler une intégration Unified Login avec un token Instagram User. Le guide des webhooks de Meta indique que ces tokens et graph.instagram.com ne fonctionnent pas avec Unified Login.
- Publier un conteneur vidéo tout de suite. media_publish échoue avec le sous-code 2207027 tant que le status_code du conteneur n'affiche pas FINISHED.
- Interroger en boucle les commentaires et les messages privés. Meta recommande les webhooks, qui réduisent les appels d'une app et son risque d'être limitée en débit.
De US$ 9 à US$ 0,75 par connexion et par mois, dégressif à mesure que vous ajoutez des connexions, avec un essai gratuit de 3 jours.
Questions fréquemment posées
Combien de temps faut-il pour obtenir l'accès à l'API Instagram ?
Pour les comptes que vous possédez ou gérez, aucune attente : le Standard Access fonctionne dès le départ. Servir d'autres entreprises exige l'App Review, que Meta indique prendre en général moins d'une semaine, et la Business Verification.
Une nouvelle app Meta peut-elle encore utiliser Instagram Login ?
Non, selon le guide de migration de Meta, qui précise que les apps nouvellement créées ne peuvent pas le configurer. Les intégrations Instagram Login existantes continuent de fonctionner, et Meta n'a annoncé aucune date de fin.
L'API peut-elle publier un fichier depuis mon ordinateur ?
Pas avec Instagram Login, où Meta récupère chaque image ou vidéo depuis une URL publique. Meta documente les uploads reprenables, qui acceptent un fichier vidéo local, pour les configurations bâties sur Facebook Login for Business, Unified Login compris.
Combien coûte easyCoexistence pour un compte Instagram ?
Chaque compte Instagram correspond à une connexion : de US$ 9 à US$ 0,75 par connexion et par mois, dégressif à mesure que vous ajoutez des connexions, avec un essai gratuit de 3 jours.
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