L'API Instagram Basic Display est morte : par quoi la remplacer

Meta a déprécié l'API Instagram Basic Display le 4 décembre 2024, et les requêtes renvoient désormais une erreur. Ce qui la remplace dépend du compte : l'API Instagram avec Instagram Login pour les comptes pro, l'endpoint oEmbed pour intégrer des posts publics, et pour un simple compte personnel, rien. Changelog vérifié le 22 octobre 2026.

Ce qui est arrivé à l'API Basic Display

Le changelog de la plateforme Instagram porte l'entrée au 4 décembre 2024 : « The Instagram Basic Display API has been deprecated. » Les requêtes renvoient une erreur plutôt que des données. Il ne reste aucune période de grâce à planifier, et aucun réglage dans l'App Dashboard ne la ramène.

Basic Display était la facile. Elle lisait le profil, les médias et les légendes d'un utilisateur avec un compte Instagram personnel, sans Page Facebook, sans conversion en compte pro, et avec un processus de validation que la plupart des projets perso passaient. C'est exactement pour ça qu'elle traîne encore partout dans les réponses Stack Overflow, les paquets npm et les tutoriels datés de 2023. Si ton intégration a cassé et que tu as cherché le correctif, tu en as sûrement croisé trois avant de tomber ici.

Deux autres dates du même changelog comptent pendant ta migration. Les anciennes valeurs de scope ont été dépréciées le 27 janvier 2025, remplacées par la famille instagram_business_*. Et la fonctionnalité oEmbed Read est dépréciée depuis le 3 novembre 2025, avec plusieurs champs de réponse oEmbed retirés.

Par quoi la remplacer, cas par cas

Le schéma est celui que Meta suit sur toute sa plateforme depuis 2023 : des API existent pour les comptes qui sont une entreprise, et l'API de lecture des comptes personnels est partie pour de bon.

API Instagram avec Instagram Login : le vrai remplaçant

C'est là que presque tout le monde atterrit. Elle couvre les comptes Instagram pro, business et créateurs, et elle n'exige pas de Page Facebook liée, ce qui en fait un vrai successeur plutôt qu'un détour. Les identifiants sont ceux d'Instagram et l'hôte est graph.instagram.com, via le flux que Meta appelle Business Login for Instagram.

Quatre scopes couvrent la surface :

• instagram_business_basic, toujours requis
• instagram_business_content_publish, pour publier des médias
• instagram_business_manage_comments, pour lire, répondre, masquer et supprimer des commentaires
• instagram_business_manage_messages, pour les DM

Le guide de migration de Meta le décrit comme deux permissions par tâche : le scope de base plus le scope spécifique pour la messagerie, la modération des commentaires ou la publication. Les capacités proposées sont la modération des commentaires, la publication de contenu, les insights des médias, les mentions et la messagerie. Les limites documentées valent le coup d'œil avant de planifier : cette configuration ne peut pas accéder aux publicités ni au tagging.

La migration n'est donc pas un simple changement d'hôte sur une ligne. Tu changes le type de compte, le flux de login, les noms de scope et la validation des permissions, et tu gagnes un accès en écriture que tu n'avais pas. Si ce sont les tokens qui t'inquiètent, j'ai détaillé tout leur cycle de vie dans les tokens d'accès des réseaux sociaux.

API Instagram avec Facebook Login : la voie liée à une Page

Si le compte est déjà relié à une Page Facebook et que ton app détient des identifiants de Page, c'est la variante à garder. Elle tourne sur les identifiants Facebook contre la Graph API, et Meta la positionne pour les intégrations existantes liées à une Page plutôt que pour de nouveaux projets. L'ensemble des capacités recoupe largement Instagram Login ; la différence, c'est par quel login passe l'utilisateur et si une Page doit exister du tout.

Prends-la quand une Page fait déjà partie du produit, par exemple parce que tu publies aussi sur Facebook. Prends Instagram Login quand l'utilisateur n'a qu'Instagram et que tu ne veux pas expliquer pourquoi ton app lui parle de Facebook. La surface complète des deux, avec les endpoints et les limites de débit, est dans API Instagram Graph en 2026.

Intégrer des posts publics : oEmbed, avec des réserves

Si tout ce que tu faisais avec Basic Display était de poser un post sur une page web, l'endpoint qu'il te faut est GET /instagram_oembed sur graph.facebook.com. Il renvoie le HTML d'intégration pour les photos, vidéos, Reels et posts du fil, jusqu'à 1 000 requêtes par heure.

Ce qu'il ne fera pas est plus long que ce qu'il fera. Il ne sert pas les comptes privés, inactifs ou soumis à une limite d'âge, les comptes qui ont désactivé les intégrations, les Stories, ni rien dans un Shadow DOM. Et selon l'entrée de changelog du 8 avril 2025, la fonctionnalité oEmbed Read est dépréciée depuis le 3 novembre 2025, avec des champs de réponse retirés. Traite-le comme une voie de maintenance, pas comme une fondation.

API Instagram pour un compte personnel : cette version n'existe pas

C'est la réponse honnête que personne qui écrit sur Basic Display ne veut donner. Il n'existe aucune API qui lise les médias d'un compte Instagram personnel. Basic Display, c'était ça, et c'est coupé. Tes options sont de demander à l'utilisateur de passer en compte pro, ce qui est gratuit et réversible dans l'app Instagram, ou de retirer la fonctionnalité.

Ce qu'il ne faut surtout pas faire, c'est se rabattre sur un scraper ou une bibliothèque non officielle qui se connecte à la place de l'utilisateur. C'est une violation directe des Platform Terms de Meta, et le compte qui paie, c'est celui de ton utilisateur, pas le tien. J'ai détaillé ce qui déclenche un flag et pourquoi dans l'automatisation Instagram en 2026.

Une checklist de migration qui tient sur un écran

1. Décide du type de compte que tu vas gérer. Un compte pro débloque tout, un compte personnel ne débloque rien.
2. Déclare le produit sur ton app Meta : API Instagram avec Instagram Login, ou avec Facebook Login si une Page est déjà dans le tableau.
3. Remplace les anciennes valeurs de scope par les noms instagram_business_*. Les anciennes sont sorties le 27 janvier 2025.
4. Reconstruis le login en Business Login for Instagram et stocke le token que tu reçois, pas celui que ton ancien code attendait.
5. Soumets à l'App Review les scopes que tu utilises vraiment. La publication et la messagerie sont validées séparément des lectures de base.
6. Revérifie le changelog avant de livrer. Trois des dates de cet article étaient des dépréciations annoncées des mois avant la coupure.

Si tu préfères ne rien porter de tout ça, c'est le travail que fait PlugKit : une API et un serveur MCP hébergé sur Instagram, Facebook, LinkedIn, TikTok, YouTube, X, WhatsApp et Telegram, avec les flux OAuth, le refresh des tokens et les bizarreries de chaque plateforme gardés de notre côté. 49 $ par mois pour 5 comptes connectés, résiliable à tout moment. Il ne parle qu'aux comptes Instagram pro, parce que c'est la seule chose à laquelle l'API officielle parle. Pour le côté agent, vois le serveur MCP Instagram.

FAQ

L'API Instagram Basic Display est-elle encore disponible ?

Non. Le changelog de la plateforme Instagram l'enregistre comme dépréciée le 4 décembre 2024, et les requêtes renvoient une erreur. Il n'y a ni prolongation ni mode legacy.

Qu'est-ce qui a remplacé l'Instagram Basic Display API ?

L'API Instagram avec Instagram Login, pour les comptes Instagram pro, business et créateurs, sans Page Facebook requise. Elle couvre la publication, les commentaires, la messagerie, les insights des médias et les mentions, et contrairement à Basic Display elle sait écrire, pas seulement lire.

Puis-je utiliser l'API Instagram avec un compte personnel ?

Non. Toutes les API Instagram actuelles exigent un compte pro, business ou créateur. Basic Display était la seule voie pour un compte personnel, et elle est coupée. Passer en compte pro dans l'app Instagram ne coûte rien et se défait.

Ai-je encore besoin d'une Page Facebook pour utiliser l'API Instagram ?

Pas avec l'API Instagram avec Instagram Login, qui s'authentifie avec les identifiants Instagram contre graph.instagram.com. Une Page n'est nécessaire que pour l'API Instagram avec Facebook Login et pour le support Messenger API pour Instagram.

Puis-je encore intégrer des posts Instagram sans clé d'API ?

L'endpoint oEmbed GET /instagram_oembed renvoie le HTML d'intégration pour les photos, vidéos, Reels et posts du fil publics, jusqu'à 1 000 requêtes par heure. Il ne marche pas pour les comptes privés ni pour les Stories, et sa fonctionnalité Read est dépréciée depuis le 3 novembre 2025, donc prévois qu'il continue de se réduire.

AB

Antoine BlancoFondateur de PlugKit. Gère ses propres comptes Instagram, YouTube et X via l'API et le serveur MCP décrits ici.