Instagram Reels publiceren via de API
De Instagram-API publiceert een Reel vanuit een MOV- of MP4-bestand op een openbare URL: maak een container aan met media_type REELS, wacht tot Meta de video heeft verwerkt en publiceer hem daarna. Een Reel duurt van 3 seconden tot 15 minuten en mag tot 300 MB zijn. Meta raadt een beeldverhouding van 9:16 aan, om bijsnijden of lege ruimte te voorkomen.
easyCoexistence publiceert Reels met publish_instagram_post vanuit Claude, ChatGPT of je eigen code: geef de video-URL en het bijschrift mee, en zolang de video nog wordt verwerkt, rondt het de publicatie zelf af.
De langste Reel die de API publiceert; de kortste duurt 3 seconden.
Grootste Reel-bestand, als MOV of MP4 met H.264- of HEVC-video en AAC-audio.
Hoe vaak Meta adviseert de status van een verwerkende container te controleren, maximaal 5 minuten lang.
Hoe lang een Reel-container ongepubliceerd kan blijven staan voordat hij verloopt.
Hoe wordt een Reel gepubliceerd?
In drie stappen. Ten eerste: POST /<IG_ID>/media met media_type ingesteld op REELS, video_url dat naar het bestand verwijst en, als je dat wilt, een bijschrift; Meta haalt de video op en geeft een container-ID terug. Ten tweede: wacht terwijl Instagram de video verwerkt en controleer de status_code van de container. Ten derde: POST /<IG_ID>/media_publish met creation_id ingesteld op de container-ID, en het antwoord bevat het nieuwe media-ID.
Meta documenteert zijn hervatbare upload, waarmee een bestand vanaf een computer kan worden verstuurd, uitsluitend voor opzetten die zijn gebouwd op Facebook Login for Business, inclusief Unified Login. Bij Instagram Login komt de video altijd van een openbare URL.
Wat zijn de videovereisten?
De specificatie van Meta voor Reels, waaraan een bestand moet voldoen voordat Instagram het verwerkt:
- Container: MOV of MP4 (MPEG-4 Part 14), zonder edit lists, met het moov-atom vooraan in het bestand.
- Video: H.264 of HEVC, progressieve scan, closed GOP, 4:2:0-chroma-subsampling, 23 tot 60 frames per seconde, maximaal 1920 pixels breed en 25 Mbps.
- Audio: AAC, tot 48 kHz, mono of stereo, op 128 kbps.
- Beeldverhouding: alles van 0.01:1 tot 10:1, met 9:16 als aanbeveling.
- Lengte en grootte: 3 seconden tot 15 minuten, tot 300 MB.
Wat gebeurt er terwijl de video wordt verwerkt?
De status_code van de container staat op IN_PROGRESS zolang Instagram de video verwerkt, daarna op FINISHED, en pas dan kan hij worden gepubliceerd. Eerder publiceren mislukt met code 9007, subcode 2207027, wat betekent dat je moet wachten en niets hoeft te repareren. Meta adviseert de status eens per minuut te controleren, maximaal 5 minuten lang.
ERROR betekent dat de container de verwerking niet heeft kunnen afronden, en EXPIRED betekent dat hij 24 uur ongepubliceerd is gebleven; in beide gevallen is een nieuwe container nodig. PUBLISHED betekent dat de Reel al live staat.
Welke Reel-opties biedt de API?
Naast de video en het bijschrift accepteert de Reel-container van Meta deze parameters:
share_to_feed: true zorgt dat de Reel ook in de Feed verschijnt, naast het Reels-tabblad; false houdt hem beperkt tot het Reels-tabblad. Geen van beide waarden garandeert een plek op het Reels-tabblad.cover_url: een JPEG van maximaal 8 MB die als cover van het Reels-tabblad wordt gebruikt, bijgesneden naar het midden in 9:16, en naar een vierkant wanneer hij naar de Feed wordt gedeeld.thumb_offset: het frame, in milliseconden, dat als miniatuur wordt gebruikt wanneer er geen cover is; 0 is het eerste frame.audio_name: een naam voor de audio van de Reel, die maar één keer kan worden ingesteld.trial_params: publiceert een proef-Reel, die alleen wordt gedeeld met mensen die het account niet volgen totdat hij definitief wordt.
Wat geldt er verder voor een Reel?
Een paar regels gelden voor een Reel vanaf het moment dat zijn container wordt aangemaakt.
- Een Reel kan geen carrouselitem zijn; hij wordt altijd op zichzelf gepubliceerd.
- De privacy-instellingen van het account gelden bij publiceren: met Remixen toestaan aan, staat de nieuwe Reel ook remixen toe.
- Muziektagging is alleen beschikbaar voor originele audio.
- Later uitgelezen heeft een Reel
media_typeVIDEO, net als elke andere video. - Hij telt mee als één van de 100 via de API gepubliceerde posts van het account in 24 uur.
Welke statistieken geeft een Reel terug?
Via het endpoint voor media-inzichten geeft een Reel reach, views, likes, comments, saved, shares, total_interactions en reposts terug, plus drie eigen statistieken: ig_reels_avg_watch_time, ig_reels_video_view_total_time en reels_skip_rate, het aandeel weergaven dat binnen de eerste 3 seconden is overgeslagen. Likes, reacties en weergaven tellen alleen organische activiteit, en de gegevens erachter kunnen tot 48 uur achterlopen.
Veelgemaakte fouten
- De video publiceren op het moment dat de container wordt aangemaakt. Wacht tot status_code FINISHED aangeeft, anders mislukt de aanroep met subcode 2207027.
- Een WebM- of AVI-bestand sturen. Reels moeten MOV of MP4 zijn, anders weigert Meta ze met code 352, subcode 2207026.
- Verwachten dat share_to_feed de Reel op het Reels-tabblad zet. De parameter voegt alleen de Feed toe; Instagram bepaalt wat het Reels-tabblad toont.
- Een container een nacht ongepubliceerd laten staan. Hij verloopt 24 uur na aanmaak, en publiceren vraagt dan om een nieuwe.
Reels kun je ook plannen in de eigen wachtrij. Van US$ 9 tot US$ 0.75 per verbinding per maand, dalend naarmate je meer verbindingen toevoegt, met de eerste 3 dagen gratis.
Veelgestelde vragen
Hoe lang mag een Reel zijn via de API?
Van 3 seconden tot 15 minuten, als MOV- of MP4-bestand van maximaal 300 MB.
Kan ik een Reel vanaf mijn computer uploaden?
Niet met Instagram Login. De API haalt de video op van een openbare URL, dus zet het bestand eerst ergens waar het een openbare link krijgt.
Verschijnt een Reel die via de API is gepubliceerd ook in de Feed?
Dat kan. De parameter share_to_feed bepaalt of de Reel naast het Reels-tabblad ook in de Feed mag verschijnen.
Waarom mislukt het publiceren van een Reel met 9007?
Instagram verwerkt de video nog. Controleer de status_code van de container en publiceer zodra die FINISHED aangeeft; er hoeft niets aan het verzoek te worden aangepast.
Lees verder
Koppel je eerste kanaal in twee minuten.
Geen platformbeoordelingen om op te wachten. Verbind WhatsApp, Instagram, TikTok of een ander kanaal, vraag je AI om te posten, te reageren of een rapport te maken, en zie het aan het werk.
- 3 dagen gratis
- Op elk moment opzegbaar
- Alleen officiële API's
- 24/7 bewaakt
Geverifieerd op