Instagram Basic Display API ist abgeschaltet: was du stattdessen nutzt

Meta hat die Instagram Basic Display API am 4. Dezember 2024 eingestellt, und Anfragen laufen jetzt auf einen Fehler. Was sie ersetzt, hängt vom Konto ab: die Instagram API mit Instagram Login für professionelle Konten, der oEmbed-Endpoint zum Einbetten öffentlicher Beiträge, und für ein einfaches privates Konto nichts. Changelog am 22. Oktober 2026 geprüft.

Was mit der Basic Display API wirklich passiert ist

Das Changelog der Instagram-Plattform führt den Eintrag unter dem 4. Dezember 2024: „The Instagram Basic Display API has been deprecated.“ Anfragen liefern einen Fehler statt Daten. Es bleibt keine Schonfrist, die man einplanen könnte, und kein Schalter im App Dashboard, der sie zurückbringt.

Basic Display war die einfache. Sie las Profil, Medien und Bildtexte eines Nutzers mit einem privaten Instagram-Konto, ohne Facebook-Page, ohne Umstellung auf ein Business-Konto, und mit einem Review, das die meisten Nebenprojekte bestanden. Genau deshalb steht sie noch überall in Stack-Overflow-Antworten, npm-Paketen und Tutorials von 2023. Wenn deine Integration kaputtgegangen ist und du nach der Lösung gesucht hast, hast du davon wahrscheinlich drei gefunden, bevor du hier gelandet bist.

Zwei weitere Daten aus demselben Changelog zählen während der Migration. Die alten Scope-Werte wurden am 27. Januar 2025 eingestellt und durch die Familie instagram_business_* ersetzt. Und die oEmbed-Read-Funktion ist seit dem 3. November 2025 eingestellt, mit mehreren entfernten oEmbed-Antwortfeldern.

Was du stattdessen nutzt, Fall für Fall

Das Muster ist dasselbe, dem Meta seit 2023 auf seiner ganzen Plattform folgt: APIs gibt es für Konten, die ein Unternehmen sind, und die Lese-API für private Konten ist endgültig weg.

Instagram API mit Instagram Login: der echte Ersatz

Hier landen fast alle. Sie deckt professionelle Instagram-Konten ab, Business und Creator, und verlangt keine verknüpfte Facebook-Page, und genau das macht sie zum echten Nachfolger statt zum Umweg. Die Credentials sind Instagrams eigene und der Host ist graph.instagram.com, über den Flow, den Meta Business Login for Instagram nennt.

Vier Scopes decken die ganze Fläche ab:

• instagram_business_basic, immer erforderlich
• instagram_business_content_publish, um Medien zu veröffentlichen
• instagram_business_manage_comments, um Kommentare zu lesen, zu beantworten, zu verbergen und zu löschen
• instagram_business_manage_messages, für DMs

Metas Migrationsleitfaden beschreibt es als zwei Berechtigungen pro Aufgabe: den Basis-Scope plus den einen spezifischen Scope für Nachrichten, Kommentarmoderation oder Veröffentlichung. Angeboten werden Kommentarmoderation, Content-Veröffentlichung, Medien-Insights, Mentions und Nachrichten. Die dokumentierten Grenzen lohnen sich vor der Planung: dieses Setup kommt nicht an Ads und nicht an Tagging.

Die Migration ist also kein einzeiliger Host-Tausch. Du änderst den Kontotyp, den Login-Flow, die Scope-Namen und das Permission-Review, und du gewinnst einen Schreibzugriff, den du vorher nicht hattest. Wenn dich vor allem die Tokens beschäftigen, habe ich ihren ganzen Lebenszyklus in Social-Media-Access-Tokens aufgeschrieben.

Instagram API mit Facebook Login: der Page-gebundene Weg

Wenn das Konto schon mit einer Facebook-Page verbunden ist und deine App Page-Credentials hält, ist das die Variante, die du behältst. Sie läuft mit Facebook-Credentials gegen die Graph API, und Meta positioniert sie für bestehende Page-gebundene Integrationen, nicht für neue Projekte. Der Funktionsumfang überschneidet sich stark mit Instagram Login; der Unterschied liegt darin, durch welches Login der Nutzer geht und ob überhaupt eine Page existieren muss.

Nimm sie, wenn eine Page schon Teil des Produkts ist, zum Beispiel weil du auch auf Facebook veröffentlichst. Nimm Instagram Login, wenn der Nutzer nur Instagram hat und du nicht erklären willst, warum deine App nach Facebook fragt. Die volle Fläche von beiden, mit den Endpoints und den Rate Limits, steht in Instagram Graph API im Jahr 2026.

Öffentliche Beiträge einbetten: oEmbed, mit Einschränkungen

Wenn du Basic Display nur genutzt hast, um einen Beitrag auf eine Webseite zu setzen, ist der Endpoint, den du willst, GET /instagram_oembed auf graph.facebook.com. Er liefert das Embed-HTML für Fotos, Videos, Reels und Feed-Beiträge, bis zu 1.000 Anfragen pro Stunde.

Was er nicht tut, ist länger als was er tut. Er bedient keine privaten, inaktiven oder altersbeschränkten Konten, keine Konten, die Embeds abgeschaltet haben, keine Stories und nichts innerhalb eines Shadow DOM. Und laut Changelog-Eintrag vom 8. April 2025 ist die oEmbed-Read-Funktion seit dem 3. November 2025 eingestellt, mit entfernten Antwortfeldern. Behandle ihn als Wartungsweg, nicht als Fundament.

Instagram API für ein privates Konto: diese Version gibt es nicht

Das ist die ehrliche Antwort, die niemand geben will, der über Basic Display schreibt. Es gibt keine API, die die Medien eines privaten Instagram-Kontos liest. Basic Display war das, und sie ist aus. Deine Optionen sind, den Nutzer zu bitten, auf ein professionelles Konto zu wechseln, was gratis und in der Instagram-App umkehrbar ist, oder die Funktion zu streichen.

Was du auf keinen Fall tun darfst: zu einem Scraper oder einer unoffiziellen Library greifen, die sich als der Nutzer einloggt. Das ist ein direkter Bruch von Metas Platform Terms, und das Konto, das dafür zahlt, ist das deines Nutzers, nicht deins. Was einen Flag auslöst und warum, habe ich in Instagram-Automatisierung im Jahr 2026 beschrieben.

Eine Migrations-Checkliste, die auf einen Bildschirm passt

1. Entscheide, welchen Kontotyp du unterstützt. Ein Business-Konto schaltet alles frei, ein privates nichts.
2. Registriere das Produkt in deiner Meta-App: Instagram API mit Instagram Login, oder mit Facebook Login, wenn eine Page schon im Spiel ist.
3. Ersetze die alten Scope-Werte durch die Namen instagram_business_*. Die alten sind am 27. Januar 2025 ausgelaufen.
4. Bau das Login als Business Login for Instagram neu und speichere das Token, das du zurückbekommst, nicht das, das dein alter Code erwartet hat.
5. Reiche die Scopes zum App Review ein, die du wirklich nutzt. Veröffentlichung und Nachrichten werden getrennt von den Basis-Lesezugriffen geprüft.
6. Prüf das Changelog noch einmal, bevor du ausrollst. Drei der Daten in diesem Artikel waren Einstellungen, die Monate vor dem Stichtag angekündigt wurden.

Wenn du davon nichts selbst tragen willst, genau das macht PlugKit: eine API und ein gehosteter MCP-Server über Instagram, Facebook, LinkedIn, TikTok, YouTube, X, WhatsApp und Telegram, mit den OAuth-Flows, dem Token-Refresh und den Eigenheiten jeder Plattform auf unserer Seite. 49 $ pro Monat für 5 verbundene Accounts, jederzeit kündbar. Er spricht nur mit professionellen Instagram-Konten, weil die offizielle API mit nichts anderem spricht. Für die Agentenseite siehe den Instagram MCP-Server.

FAQ

Ist die Instagram Basic Display API noch verfügbar?

Nein. Das Changelog der Instagram-Plattform führt sie als eingestellt zum 4. Dezember 2024, und Anfragen laufen auf einen Fehler. Es gibt keine Verlängerung und keinen Legacy-Modus.

Was hat die Instagram Basic Display API ersetzt?

Die Instagram API mit Instagram Login, für professionelle Instagram-Konten, Business und Creator, ohne erforderliche Facebook-Page. Sie deckt Veröffentlichung, Kommentare, Nachrichten, Medien-Insights und Mentions ab, und anders als Basic Display kann sie schreiben, nicht nur lesen.

Kann ich die Instagram API mit einem privaten Konto nutzen?

Nein. Jede aktuelle Instagram API verlangt ein professionelles Konto, Business oder Creator. Basic Display war der einzige Weg für ein privates Konto, und sie ist aus. Der Wechsel zu einem professionellen Konto in der Instagram-App kostet nichts und lässt sich zurücknehmen.

Brauche ich für die Instagram API noch eine Facebook-Page?

Nicht mit der Instagram API mit Instagram Login, die sich mit Instagram-Credentials authentifiziert, gegen graph.instagram.com. Eine Page brauchst du nur für die Instagram API mit Facebook Login und für den Messenger-API-Support für Instagram.

Kann ich Instagram-Beiträge noch ohne API-Key einbetten?

Der oEmbed-Endpoint GET /instagram_oembed liefert das Embed-HTML für öffentliche Fotos, Videos, Reels und Feed-Beiträge, bis zu 1.000 Anfragen pro Stunde. Er funktioniert nicht für private Konten und nicht für Stories, und seine Read-Funktion ist seit dem 3. November 2025 eingestellt, rechne also damit, dass er weiter schrumpft.

AB

Antoine BlancoGründer von PlugKit. Betreibt seine eigenen Instagram-, YouTube- und X-Accounts über die hier beschriebene API und den MCP-Server.