AnmeldenKostenlose Testphase starten
easyCoexistence Offizielle APIs

Instagram Reels über die API veröffentlichen

Die Instagram-API veröffentlicht ein Reel aus einer MOV- oder MP4-Datei unter einer öffentlichen URL: Sie erstellen einen Container mit media_type REELS, warten, bis Meta das Video verarbeitet hat, und veröffentlichen es dann. Ein Reel reicht von 3 Sekunden bis 15 Minuten und darf bis zu 300 MB groß sein. Meta empfiehlt ein Format von 9:16, damit nichts abgeschnitten wird und keine leeren Flächen entstehen.

easyCoexistence veröffentlicht Reels mit publish_instagram_post aus Claude, ChatGPT oder Ihrem eigenen Code: Übergeben Sie die Video-URL und die Caption.

15 min

Längstes Reel, das die API veröffentlicht; das kürzeste ist 3 Sekunden lang.

300 MB

Größte Reel-Datei als MOV oder MP4 mit H.264- oder HEVC-Video und AAC-Audio.

1 min

Wie oft Meta empfiehlt, den Status eines Verarbeitungscontainers zu prüfen, höchstens 5 Minuten lang.

24 hours

Wie lange ein Reel-Container unveröffentlicht warten kann, bevor er abläuft.

Wie wird ein Reel veröffentlicht?

In drei Schritten. Erstens senden Sie POST /<IG_ID>/media mit media_type auf REELS, video_url mit Verweis auf die Datei und, falls gewünscht, einer Caption; Meta ruft das Video ab und gibt eine Container-ID zurück. Zweitens warten Sie, bis Instagram das Video verarbeitet hat, und prüfen dabei den status_code des Containers. Drittens senden Sie POST /<IG_ID>/media_publish mit creation_id auf die Container-ID, und die Antwort enthält die neue Media-ID.

Meta dokumentiert einen fortsetzbaren Upload, mit dem eine Datei von einem Computer gesendet werden kann, ausschließlich für Setups, die auf Facebook Login for Business aufbauen, einschließlich Unified Login. Bei Instagram Login stammt das Video immer von einer öffentlichen URL.

Welche Anforderungen gelten für das Video?

Die Spezifikation von Meta für Reels, die eine Datei erfüllen muss, bevor Instagram sie verarbeitet:

  • Container: MOV oder MP4 (MPEG-4 Teil 14), ohne Edit-Listen, mit dem moov-Atom am Anfang der Datei.
  • Video: H.264 oder HEVC, progressiver Scan, geschlossene GOP, 4:2:0-Chroma-Subsampling, 23 bis 60 Bilder pro Sekunde, bis zu 1920 Pixel breit und 25 Mbps.
  • Audio: AAC, bis 48 kHz, Mono oder Stereo, mit 128 kbps.
  • Seitenverhältnis: alles von 0.01:1 bis 10:1, empfohlen wird 9:16.
  • Länge und Größe: 3 Sekunden bis 15 Minuten, bis zu 300 MB.

Was passiert während der Verarbeitung des Videos?

Der status_code des Containers lautet IN_PROGRESS, bis Instagram das Video verarbeitet hat, danach FINISHED. Erst dann kann er veröffentlicht werden. Eine Veröffentlichung davor schlägt mit dem Fehlercode 9007, Subcode 2207027 fehl, was bedeutet: warten statt reparieren. Meta empfiehlt, den Status einmal pro Minute zu prüfen, höchstens 5 Minuten lang.

ERROR bedeutet, dass der Container die Verarbeitung nicht abschließen konnte, und EXPIRED bedeutet, dass er 24 Stunden unveröffentlicht lag. Beides erfordert einen neuen Container. PUBLISHED bedeutet, dass das Reel bereits live ist.

Welche Optionen für Reels bietet die API?

Neben Video und Caption nimmt der Reel-Container von Meta folgende Parameter entgegen:

  • share_to_feed: true lässt das Reel zusätzlich im Feed erscheinen, false beschränkt es auf den Reels-Tab. Keiner der beiden Werte garantiert einen Platz im Reels-Tab.
  • cover_url: ein JPEG mit bis zu 8 MB, das als Cover im Reels-Tab dient, auf 9:16 in der Mitte zugeschnitten und bei Freigabe im Feed quadratisch.
  • thumb_offset: der Frame in Millisekunden, der als Vorschaubild dient, wenn kein Cover vorhanden ist; 0 ist der erste Frame.
  • audio_name: ein Name für den Audio-Track des Reels, der nur einmal gesetzt werden kann.
  • trial_params: veröffentlicht ein Probe-Reel, das nur mit Personen geteilt wird, die dem Konto nicht folgen, bis es in den regulären Modus übernommen wird.

Was gilt sonst für ein Reel?

Einige Regeln gelten für ein Reel ab dem Moment, in dem sein Container erstellt wird.

  • Ein Reel kann kein Karussell-Element sein; es wird immer allein veröffentlicht.
  • Die Datenschutzeinstellungen des Kontos gelten bei der Veröffentlichung: Ist Remixing erlauben aktiv, erlaubt auch das neue Reel Remixing.
  • Musik-Tagging ist nur für Originalaudio verfügbar.
  • Später abgerufen, meldet ein Reel media_type VIDEO, wie jedes andere Video.
  • Es zählt als ein Beitrag zu den 100 über die API veröffentlichten Beiträgen des Kontos in 24 Stunden.

Welche Kennzahlen meldet ein Reel?

Über den Endpoint für Media-Insights meldet ein Reel Reichweite, Aufrufe, Likes, Kommentare, gespeichert, geteilt, total_interactions und Reposts, dazu drei eigene Kennzahlen: ig_reels_avg_watch_time, ig_reels_video_view_total_time und reels_skip_rate, den Anteil der Aufrufe, die in den ersten 3 Sekunden übersprungen wurden. Likes, Kommentare und Aufrufe zählen nur organische Aktivität, und die zugrunde liegenden Daten können bis zu 48 Stunden verzögert sein.

Häufige Fehler

  • Die Veröffentlichung im Moment der Containererstellung. Warten Sie, bis status_code FINISHED lautet, sonst schlägt der Aufruf mit Subcode 2207027 fehl.
  • Eine WebM- oder AVI-Datei senden. Reels müssen MOV oder MP4 sein, sonst lehnt Meta sie mit Code 352, Subcode 2207026 ab.
  • Erwarten, dass share_to_feed das Reel in den Reels-Tab bringt. Der Parameter fügt nur den Feed hinzu; Instagram entscheidet, was im Reels-Tab angezeigt wird.
  • Einen Container über Nacht unveröffentlicht lassen. Er läuft 24 Stunden nach der Erstellung ab, und die Veröffentlichung braucht dann einen neuen.
Mit EasyCoexistence

Solange das Video noch verarbeitet wird, schließt es die Veröffentlichung selbstständig ab. Reels lassen sich auch über die eigene Warteschlange planen. Von US$ 9 bis US$ 0.75 pro Verbindung und Monat, sinkend mit jeder weiteren Verbindung, mit 3 Tagen kostenloser Testphase.

Häufig gestellte Fragen

Wie lang kann ein Reel über die API sein?

Von 3 Sekunden bis 15 Minuten, als MOV- oder MP4-Datei mit bis zu 300 MB.

Kann ich ein Reel von meinem Computer hochladen?

Nicht mit Instagram Login. Die API ruft das Video von einer öffentlichen URL ab, legen Sie die Datei also zuerst an einem Ort ab, der einen öffentlichen Link erzeugt.

Erscheint ein über die API veröffentlichtes Reel auch im Feed?

Das kann es. Der Parameter share_to_feed entscheidet, ob das Reel zusätzlich zum Reels-Tab im Feed erscheinen darf.

Warum schlägt die Veröffentlichung eines Reels mit 9007 fehl?

Instagram verarbeitet das Video noch. Prüfen Sie den status_code des Containers und veröffentlichen Sie, sobald er FINISHED lautet. An der Anfrage muss nichts geändert werden.

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