Facebook Reels API: Reels naar een pagina publiceren
De Facebook Reels API publiceert een Reel naar een pagina in drie stappen: POST /{page-id}/video_reels met upload_phase start geeft een video_id terug, de video gaat naar rupload.facebook.com, en POST /{page-id}/video_reels met upload_phase finish en video_state PUBLISHED plaatst hem. Meta's specificatie is een 9:16-video van 3 tot 90 seconden, en een pagina kan via de API binnen 24 uur 30 Reels publiceren.
easyCoexistence plaatst video's op een Facebook-pagina als gewone videoberichten met publish_facebook_post, vanuit Claude, ChatGPT of je eigen code, naast tekst, links en foto's.
Via de API gepubliceerde Reels per pagina binnen een voortschrijdende periode van 24 uur, afgedwongen op POST /{page_id}/video_reels.
Reelduur die Meta accepteert; een Reel die als verhaal op een pagina wordt gepubliceerd, mag niet langer zijn dan 60 seconden.
Minimale Reel-resolutie; Meta raadt 1080 x 1920 pixels aan bij een beeldverhouding van 9 x 16.
Het verst vooruit liggende scheduled_publish_time dat een Reel kan instellen, minimaal 10 minuten later, met video_state SCHEDULED.
Foutcode voor een Reel waarvan de duur Facebook niet ondersteunt; Reels moeten 3 tot 90 seconden duren.
Hoe publiceert de Reels API een Reel?
In drie stappen over twee domeinen. De start- en finish-aanroepen gaan naar de video_reels-edge van de pagina op graph.facebook.com, terwijl de video zelf naar rupload.facebook.com gaat, naar de upload_url die de startaanroep teruggeeft. Een statuscontrole op het ID van de video tussen de upload en de finish laat zien of Meta het volledige bestand heeft en het heeft verwerkt.
Welke video heeft een Reel nodig?
Meta publiceert zijn Reel-specificaties in de Reels Publishing-gids. Een upload die de eisen op beeldverhouding, resolutie, duur of framesnelheid niet haalt, wordt geweigerd met een eigen foutcode. Een Reel die als verhaal op een pagina moet verschijnen, moet bovendien binnen 60 seconden blijven.
Hoe wordt de video geüpload?
Met een POST naar de upload_url op rupload.facebook.com, met het pagina-token in een Authorization: OAuth-header. Een bestand op je eigen computer gaat als verzoeklichaam, met een offset-header op 0 en file_size op de grootte in bytes. Een bestand dat al online staat, gaat in plaats daarvan als file_url-header, en Meta haalt het op; een geslaagde upload geeft success terug, ingesteld op true.
file_urlaccepteert http- en https-adressen; URL's die authenticatie vereisen, worden niet ondersteund.- De host moet de user-agent facebookexternalhit/1.1 toestaan om het bestand op te halen, want Meta weigert bestanden op sites die dat in robots.txt blokkeren.
- Bestanden op de eigen CDN van Meta, zoals fbcdn-URL's, worden geweigerd; Meta wijst op crossposting om een video op een andere pagina te hergebruiken.
# <UPLOAD_URL> is the upload_url the start call returned
curl -X POST "<UPLOAD_URL>" \
-H "Authorization: OAuth <PAGE_ACCESS_TOKEN>" \
-H "file_url: https://example.com/reel.mp4"Hoe controleer je de status van een Reel?
Met GET /{video-id}?fields=status op graph.facebook.com. Het antwoord bevat video_status, dat uploading, upload_complete, processing, ready, upload_failed, expired of error kan zijn, en één object per fase: uploading_phase met bytes_transfered, processing_phase met eventuele foutmelding en publishing_phase met publish_status (draft, scheduled, published of error) en publish_time. De status van elke fase is not_started, in_progress, completed of error.
Hoe wordt een onderbroken upload hervat?
Door de upload-POST opnieuw te sturen met de offset-header ingesteld op uploading_phase.bytes_transfered uit een statuscontrole, de bytes die Meta al heeft. Een offset die Meta niet accepteert, geeft OffsetInvalidError terug; een verzoeklichaam dat niet overeenkomt met de lengte van het bestand geeft PartialRequestError; en als opnieuw uploaden niet werkt, adviseert Meta om opnieuw te beginnen bij de eerste stap.
Welke parameters neemt de finish-aanroep?
De video_id uit de startaanroep, upload_phase ingesteld op finish en video_state ingesteld op PUBLISHED, DRAFT of SCHEDULED. description bevat de tekst en ondersteunt hashtags. title, place voor een locatiepagina en is_ai_generated, dat aangeeft dat de Reel met AI is gemaakt of bewerkt, zijn optioneel. Een geplande Reel voegt scheduled_publish_time toe, een UNIX-tijdstempel meer dan 10 minuten en binnen 29 dagen vooruit. Meta antwoordt met success ingesteld op true.
Hoeveel Reels kan een pagina via de API publiceren?
30 binnen een voortschrijdende periode van 24 uur. Meta handhaaft de limiet op POST /{page_id}/video_reels wanneer een Reel wordt gepubliceerd en raadt apps aan die zelf ook te handhaven, vooral apps waarmee mensen berichten voor later kunnen plannen. Uitnodigingen voor medewerkers hebben een eigen limiet, 10 per pagina per 24 uur, en de video_reels-referentie vermeldt foutcode 613: aanroepen naar deze API hebben de snelheidslimiet overschreden.
Welke rechten en paginataak heeft het nodig?
Een pagina-toegangstoken van iemand die de taak CREATE_CONTENT op de pagina kan uitvoeren, met pages_show_list, pages_read_engagement en pages_manage_posts toegekend via Facebook Login. Meta vraagt apps ook om de gebruiker een melding te tonen over hoe zijn Reels op Facebook worden gebruikt, met opties om dat te beheren, en alleen het publiek Public aan te bieden, omdat publiceren naar een pagina impliciet openbaar bereik heeft.
Welke foutcodes geeft de Reels API terug?
Code 100 betekent dat een verplichte parameter ontbreekt, zoals upload_phase, en Meta's bericht somt de ontbrekende op. Nog vier codes weigeren een video die buiten de specificaties valt:
- 1363040: de beeldverhouding wordt niet ondersteund; video's moeten tussen 16x9 en 9x16 liggen.
- 1363127: de resolutie wordt niet ondersteund; het minimum is 540 x 960 pixels.
- 1363128: de duur wordt niet ondersteund; Reels duren 3 tot 90 seconden.
- 1363129: de gemiddelde framesnelheid wordt niet ondersteund; Reels hebben 24 tot 60 frames per seconde nodig.
Hoe vraag je de Reels van een pagina op?
Met GET /{page-id}/video_reels, dat de gepubliceerde Reels van de pagina teruggeeft met hun ID's, bijwerkdatums en beschrijvingen. since en until beperken de lijst tot datums die worden opgegeven als today, yesterday, een UNIX-tijdstempel of yyyy-mm-dd, waarbij until later moet zijn dan since. De feedreferentie van Meta verwijst voor de op een pagina gepubliceerde Reels naar deze edge.
Hoe publiceer je een Reel via easyCoexistence?
Vandaag niet als Reel. publish_facebook_post stuurt video's naar de videos-edge van de pagina, als gewone videoberichten, en easyCoexistence heeft geen tool voor de video_reels-aanroepen; paginatokens worden niet verstrekt, dus de drie stappen kunnen ook niet vanuit je eigen code op zijn verbinding draaien. Publiceer de Reel vanuit Facebook of Meta Business Suite, of plaats de video als gewoon videobericht.
Veelgemaakte fouten
- De upload naar graph.facebook.com sturen. De video gaat naar rupload.facebook.com met een Authorization: OAuth-header; alleen de start-, finish- en statusaanroepen gebruiken graph.facebook.com.
- Het bestand hosten op een plek waar Meta het niet kan ophalen. Een file_url achter een login, op een site waarvan robots.txt facebookexternalhit/1.1 blokkeert, of op fbcdn wordt geweigerd.
- Opnieuw beginnen na een onderbroken upload. Lees eerst de status: uploading_phase.bytes_transfered is de offset om vanaf te hervatten, en een nieuwe sessie is het laatste redmiddel.
- Meer dan 30 Reels per pagina op één dag in de wachtrij zetten. Meta telt via de API gepubliceerde Reels over een voortschrijdende periode van 24 uur, dus spreid geplande Reels uit.
Het heeft geen tool voor de Reels API, dus een Reel wordt gepubliceerd vanuit Facebook of Meta Business Suite. US$ 9 tot US$ 0,75 per verbinding per maand, dalend naarmate je meer verbindingen toevoegt, met een gratis proefperiode van 3 dagen.
Veelgestelde vragen
Kan een Reel via de API naar een Facebook-profiel of -groep worden gepubliceerd?
Nee. De Reels Publishing API van Meta publiceert Reels naar Facebook-pagina's, en crosspost ze alleen naar pagina's.
Publiceert publish_facebook_post Reels?
Nee. Het plaatst tekst, links, foto's en video's op de pagina. Een Reel vereist de video_reels-aanroepen, die de tools van easyCoexistence niet doen.
Hoe controleer ik een Reel op auteursrechttreffers?
Lees GET /{video-id}?fields=copyright_check_information met pages_read_engagement. Meta voert de controle bij de upload uit, die een paar minuten kan duren, en alleen de eigenaar ziet de treffers.
Kan een andere pagina mijn Reel ook publiceren?
Ja, als medewerker. POST /{video-id}/collaborators met target_id ingesteld op het ID van hun pagina stuurt een uitnodiging, en zodra zij accepteren, verschijnt de Reel ook op hun pagina.
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