Instagram-Stories über die API veröffentlichen
Die Instagram-API veröffentlicht eine Story aus einem Bild oder einem Video unter einer öffentlichen URL: Zuerst wird ein Container mit media_type STORIES erstellt, dann wird er veröffentlicht. Bilder sind JPEG bis 8 MB, Videos laufen 3 bis 60 Sekunden und bis 100 MB, Meta empfiehlt ein 9:16-Format, und die Story verschwindet nach 24 Stunden, wie in der App.
easyCoexistence veröffentlicht Bild- und Video-Stories mit publish_instagram_post aus Claude, ChatGPT oder Ihrem eigenen Code und kann sie über die eigene Warteschlange planen.
Längstes Story-Video, das die API veröffentlicht; das kürzeste hat 3 Sekunden, und die Datei kann bis zu 100 MB groß sein.
Größtes Story-Bild, das als JPEG vorliegen muss.
Wie lange eine veröffentlichte Story sichtbar bleibt, bevor sie abläuft.
Story-Kennzahlen mit so niedrigen Werten werden als Fehlercode 10 zurückgegeben (nicht genügend Zuschauer) statt als Zahl.
Wie wird eine Story veröffentlicht?
Mit denselben zwei Aufrufen wie bei jedem Beitrag. POST /<IG_ID>/media mit media_type auf STORIES und entweder image_url oder video_url, dann POST /<IG_ID>/media_publish mit der Container-ID. Ein Video-Story wird zuerst verarbeitet, daher muss der status_code seines Containers FINISHED lauten, bevor sie veröffentlicht werden kann.
Die Referenz von Meta beschreibt die Bildunterschrift für Fotos, Videos und Karussells, nicht für Stories. Texte für die Betrachter gehören daher ins Bild oder ins Video selbst.
Welche Medienanforderungen gelten für Stories?
Meta empfiehlt für Story-Bilder und -Videos gleichermaßen ein 9:16-Format, um Zuschneiden oder leeren Raum zu vermeiden.
- Bild: JPEG, bis 8 MB, im sRGB-Farbraum; andere Farbräume werden umgewandelt.
- Video: MOV oder MP4 mit H.264- oder HEVC-Video und AAC-Audio, 23 bis 60 Bilder pro Sekunde, bis 1920 Pixel breit und 25 Mbps.
- Videolänge: 3 bis 60 Sekunden, bei einer Datei von bis zu 100 MB.
- Seitenverhältnis des Videos: alles von 0.1:1 bis 10:1 wird akzeptiert.
Was kann eine Story enthalten?
Das Bild oder Video selbst sowie Erwähnungen anderer Konten: Seit Juli 2025 markiert der Parameter user_tags öffentliche Konten in Bild- und Video-Stories, wobei die Koordinaten x und y optional sind. Meta unterstützt das Veröffentlichen von Stickern über die API nicht, daher bleiben Links, Umfragen und Standorte in der App.
Was passiert nach der Veröffentlichung einer Story?
Sie bleibt 24 Stunden sichtbar und läuft dann ab, wie in der App. Meta führt Live-Stories in einer eigenen stories-Edge; die Medienliste des Kontos, GET /<IG_ID>/media, enthält sie nicht. Beim Abrufen ist der media_type einer Story IMAGE oder VIDEO, wie bei jedem anderen Medium. Stories lassen sich daher nur daran erkennen, wo man sie gefunden hat, nicht an ihrem Typ.
Wie kommen Antworten und Erwähnungen zurück?
Als Direktnachrichten. Eine Antwort auf eine Story erreicht das Konto als DM über den messages-Webhook, mit der ID und URL der Story, und öffnet das übliche 24-Stunden-Fenster für eine Antwort. Wenn jemand das Konto in der eigenen Story erwähnt, kommt das ebenfalls als Nachricht an, mit einem Anhang vom Typ story_mention. Die Mentions API von Meta deckt Stories nicht ab.
Welche Kennzahlen meldet eine Story?
Reichweite, Aufrufe, Teilen, Antworten, Follows, Profilbesuche, Profilaktivität, Navigation, Linkklicks, Reposts und Interaktionen insgesamt, abrufbar über den Endpoint für Medien-Insights. Sie sind nur 24 Stunden verfügbar; liegt ein Wert unter 5, wird Fehlercode 10 (nicht genügend Zuschauer) statt einer Zahl zurückgegeben. Antworten von Personen in Europa und Japan werden nicht mitgezählt, und eine Story, die von einem Konto dort erstellt wurde, meldet 0 Antworten.
Häufige Fehler
- Einen Link-Sticker planen. Die API veröffentlicht keine Sticker, daher muss ein Link die Menschen auf einem anderen Weg erreichen, etwa über eine DM-Antwort.
- Die Story-Kennzahlen am nächsten Tag abrufen. Sie sind nur 24 Stunden verfügbar, also erheben Sie sie, solange die Story online ist.
- In der Medienliste des Kontos nach einer veröffentlichten Story suchen. Live-Stories werden in einer eigenen stories-Edge geführt.
- Ein Querformat-Video als Story veröffentlichen. Meta empfiehlt 9:16, andere Formate können leeren Raum zeigen oder abgeschnitten werden.
Antworten auf eine Story kommen als DMs an und können an Ihren Endpoint weitergeleitet oder durch eine Automatisierung beantwortet werden. US$ 9 bis US$ 0.75 pro Verbindung und Monat, sinkend mit jeder weiteren Verbindung, mit der kostenlosen Testphase von 3 Tagen.
Häufig gestellte Fragen
Kann ich einen Link-Sticker über die API zu einer Story hinzufügen?
Nein. Meta unterstützt das Veröffentlichen von Stickern über die API nicht, einschließlich Links, Umfragen und Standorten. Eine Erwähnung eines anderen Kontos ohne Sticker wird unterstützt.
Wo wird eine veröffentlichte Story in der API aufgeführt?
In der eigenen stories-Edge des Kontos, solange sie live ist. GET /<IG_ID>/media enthält keine Stories, und eine Story wird als IMAGE oder VIDEO zurückgegeben.
Kann eine Story über die API eine Bildunterschrift haben?
Nein. Die Referenz von Meta sieht keine Bildunterschrift für Stories vor, und publish_instagram_post sendet eine Story ohne eine, daher gehören Texte für die Betrachter ins Bild oder ins Video selbst.
Wie lange sind Story-Insights verfügbar?
24 Stunden. Meta stellt Story-Kennzahlen nur so lange bereit, daher sollten Sie sie abrufen, solange die Story online ist.
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