Instagram-Beiträge mit oEmbed auf einer Website einbetten
Metas Instagram-oEmbed-Endpoint, GET /instagram_oembed?url=<POST_URL>, liefert das HTML, mit dem sich ein öffentlicher Instagram-Beitrag oder Reel auf einer Webseite einbetten lässt, dazu version, provider_name, provider_url, type und width. Seit dem 15. Mai 2026 lässt er sich ohne Token aufrufen, und das HTML lädt Instagrams embed.js, das den Beitrag darstellt.
easyCoexistence liefert über list_social_posts den Permalink jedes verbundenen Instagram-Beitrags, bereit für oEmbed, und lässt Claude, ChatGPT oder Ihren eigenen Code über die offizielle Meta-API Beiträge veröffentlichen und planen sowie auf Kommentare und Direktnachrichten im Konto antworten.
Seit diesem Datum lässt sich Metas Instagram-oEmbed-API in allen Versionen ohne Token aufrufen.
Anfragen pro Stunde, die Metas oEmbed-Leitfaden zulässt.
Der Bereich, den maxwidth akzeptiert; maxheight wird nicht unterstützt.
Datum, ab dem author_name, author_url und die Thumbnail-Felder in allen API-Versionen aus den Instagram-oEmbed-Antworten entfielen.
Nicht unterstützt vom oEmbed-Endpoint, ebenso wenig Beiträge von privaten, inaktiven oder altersbeschränkten Konten.
Wie funktioniert der oEmbed-Endpoint von Instagram?
Sie senden die URL eines öffentlichen Beitrags und erhalten das HTML zurück, das ihn anzeigt. Der Endpoint läuft auf Metas zentralem Graph-API-Host, den auch die Facebook-Login-Aufrufe nutzen, und nicht auf graph.instagram.com. Die Antwort ist ein kleines JSON-Objekt, dessen Feld html unverändert in die Seite eingefügt wird.
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>"
}Welche URLs akzeptiert er?
Drei Formate, wie Metas Leitfaden sie für den Parameter url auflistet. Die URL kann unverschlüsselt oder URL-kodiert gesendet werden; die beiden Beispielanfragen des Leitfadens zeigen je eines davon:
- Einzelbild- und Karussell-Beiträge: https://www.instagram.com/p/{media-shortcode}/
- Videos und Reels: https://www.instagram.com/reel/{media-shortcode}/
- Profile: https://www.instagram.com/{username}
Braucht er ein Token?
Nein, seit dem 15. Mai 2026. Laut Metas Changelog ist die Instagram-oEmbed-API seitdem ohne Token aufrufbar. Davor brauchten Apps das Feature Meta oEmbed Read, das über das App Review freigeschaltet werden musste, sowie ein Token bei jedem Aufruf; der tokenbasierte Zugriff funktioniert weiterhin. Metas oEmbed-Leitfaden erlaubt bis zu 1.000 Anfragen pro Stunde, und Metas Ankündigung des Zugriffs ohne Token sagt, dass Apps mit Token höhere Ratenlimits erhalten können.
Welche Parameter nimmt er an?
Neben url vier weitere, laut Metas Leitfaden und Referenz:
- maxwidth: von 320 bis 658; das Embed ist sonst responsiv, und maxheight wird nicht unterstützt.
- hidecaption: true blendet die Bildunterschrift des Beitrags aus; standardmäßig ist der Wert false.
- omitscript: true lässt das Skript aus dem HTML weg, für Seiten, die embed.js selbst einmal laden und instgrm.Embeds.process() aufrufen.
- fields: beschränkt die Antwort auf die genannten Felder.
Was enthält die Antwort?
Sechs Standardfelder: html, das anzuzeigende Markup; version, immer 1.0; provider_name und provider_url, die Instagram benennen; type, der oEmbed-Ressourcentyp; und width in Pixeln. Meta hat author_name, author_url, thumbnail_url, thumbnail_width und thumbnail_height am 3. November 2025 aus den Instagram-Beitragsantworten in allen API-Versionen entfernt. Bei Beiträgen Ihres eigenen Kontos liefert die Media-Kante weiterhin username, permalink und thumbnail_url.
Was lässt sich nicht einbetten?
Metas Leitfaden nennt, was der Endpoint ausschließt, und eine Regel zur Nutzung:
- Beiträge von privaten, inaktiven und altersbeschränkten Konten.
- Konten, die Einbettungen deaktiviert haben.
- Stories sowie Seiten, die das Embed in einem Shadow DOM rendern.
- Jede Nutzung über eine reine Frontend-Anzeige hinaus: Meta untersagt ausdrücklich, die Metadaten oder Inhalte des Endpoints für andere Zwecke zu verwenden.
Wie binden Sie die Beiträge Ihres eigenen Kontos ein?
Nehmen Sie den Permalink jedes Beitrags und übergeben Sie ihn als url. Über easyCoexistence gibt list_social_posts die letzten Beiträge des verbundenen Kontos mit ihren Permalinks zurück, aufrufbar von Claude, ChatGPT oder Ihrem eigenen Code. Da der oEmbed-Aufruf kein Token braucht, kann Ihre Website ihn direkt ausführen.
Häufige Fehler
- Einen Story-Link senden. Metas oEmbed-Endpoint unterstützt keine Stories, also betten Sie einen Beitrag oder ein Reel ein.
- thumbnail_url aus der Antwort auslesen. Meta hat es zusammen mit author_name und den anderen Thumbnail-Feldern am 3. November 2025 entfernt.
- maxwidth unter 320 oder über 658 setzen. Meta akzeptiert nur Werte in diesem Bereich und überhaupt kein maxheight.
- embed.js bei jeder Einbettung laden. Mit omitscript auf true laden Sie das Skript einmal und rufen instgrm.Embeds.process() auf.
US$ 9 bis US$ 0.75 pro Verbindung und Monat, sinkend mit jeder weiteren Verbindung, mit 3 Tagen kostenloser Testphase.
Häufig gestellte Fragen
Kann ich ein Instagram-Reel einbetten?
Ja. Übergeben Sie seine URL https://www.instagram.com/reel/{media-shortcode}/, und der Endpoint liefert das Embed-HTML zurück.
Ist das Instagram-Embed responsiv?
Ja. Laut Metas Leitfaden ist das Embed responsiv, und maxwidth legt die größte Breite fest, die es erreicht.
Kann ich ein Instagram-Profil einbetten?
Ja. Metas Leitfaden nennt Profil-URLs, https://www.instagram.com/{username}, unter den Formaten, die der Parameter url akzeptiert.
Kann ich oEmbed-Daten für Analysen nutzen?
Nein. Meta erlaubt den Endpoint nur zur Anzeige des Beitrags auf einer Seite oder in einer App und untersagt andere Nutzungen seiner Metadaten und Inhalte.
Weiterlesen
Verbinden Sie Ihren ersten Kanal in zwei Minuten.
Keine Plattform-Prüfungen, auf die Sie warten müssen. Verbinden Sie WhatsApp, Instagram, TikTok oder einen anderen Kanal, bitten Sie dann Ihre KI, zu posten, zu antworten oder Berichte zu erstellen, und sehen Sie ihr bei der Arbeit zu.
- 3 Tage kostenlos
- Jederzeit kündbar
- Nur offizielle APIs
- Überwacht rund um die Uhr (24/7)
Verifiziert am