API Reel di Facebook: pubblicare Reel su una Pagina
L'API dei Reel di Facebook pubblica un Reel su una Pagina in tre passaggi: POST /{page-id}/video_reels con upload_phase start restituisce un video_id, il video va su rupload.facebook.com, e POST /{page-id}/video_reels con upload_phase finish e video_state PUBLISHED lo pubblica. La specifica di Meta prevede un video 9:16 da 3 a 90 secondi, e una Pagina può pubblicare 30 Reel tramite l'API in 24 ore.
easyCoexistence pubblica video su una Pagina Facebook come normali post video con publish_facebook_post, da Claude, ChatGPT o dal proprio codice, accanto a testo, link e foto.
Reel pubblicati tramite API per Pagina in un periodo mobile di 24 ore, applicato su POST /{page_id}/video_reels.
Durata del Reel accettata da Meta; un Reel pubblicato come storia su una Pagina non può superare i 60 secondi.
Risoluzione minima del Reel; Meta consiglia 1080 x 1920 pixel con proporzioni 9 x 16.
Limite massimo in avanti che scheduled_publish_time può impostare per un Reel, con almeno 10 minuti di anticipo e video_state SCHEDULED.
Codice di errore per un Reel la cui durata Facebook non supporta; i Reel devono durare da 3 a 90 secondi.
Come pubblica un Reel l'API dei Reel?
In tre passaggi su due host. Le chiamate start e finish vanno all'edge video_reels della Pagina su graph.facebook.com, mentre il video va su rupload.facebook.com, all'upload_url restituito dalla chiamata start. Un controllo di stato sull'ID del video tra il caricamento e la chiamata finish mostra se Meta ha ricevuto l'intero file e lo ha elaborato.
Che video serve per un Reel?
Meta pubblica le specifiche dei Reel nella guida Reels Publishing, e un caricamento che non rispetta proporzioni, risoluzione, durata o frame rate viene rifiutato con un proprio codice di errore. Un Reel destinato a una storia della Pagina deve inoltre restare entro 60 secondi.
Come viene caricato il video?
Con una POST all'upload_url su rupload.facebook.com, con il token della Pagina nell'intestazione Authorization: OAuth. Un file sul proprio computer va nel corpo della richiesta, con l'intestazione offset impostata a 0 e file_size impostato alla sua dimensione in byte. Un file già online viene indicato con l'intestazione file_url, e Meta lo scarica; un caricamento riuscito restituisce success impostato a true.
file_urlaccetta indirizzi http o https; gli URL che richiedono autenticazione non sono supportati.- L'host deve consentire allo user agent facebookexternalhit/1.1 di scaricare il file, perché Meta rifiuta i file su siti che lo bloccano nel robots.txt.
- I file sulla CDN di Meta, come gli URL fbcdn, vengono rifiutati; Meta indica il crosspost per riutilizzare un video su un'altra Pagina.
# <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"Come si controlla lo stato di un Reel?
Con GET /{video-id}?fields=status su graph.facebook.com. La risposta contiene video_status, che può essere uploading, upload_complete, processing, ready, upload_failed, expired o error, e un oggetto per fase: uploading_phase con bytes_transfered, processing_phase con l'eventuale messaggio di errore, e publishing_phase con publish_status (draft, scheduled, published o error) e publish_time. Lo stato di ciascuna fase è not_started, in_progress, completed o error.
Come si riprende un caricamento interrotto?
Inviando di nuovo la POST di caricamento con l'intestazione offset impostata a uploading_phase.bytes_transfered di un controllo di stato, cioè i byte che Meta ha già ricevuto. Un offset non accettato da Meta restituisce OffsetInvalidError, un corpo che non corrisponde alla lunghezza del file restituisce PartialRequestError, e se il ricaricamento non funziona il consiglio di Meta è ricominciare dal primo passaggio.
Cosa richiede la chiamata finish?
Il video_id della chiamata start, upload_phase impostato a finish e video_state impostato a PUBLISHED, DRAFT o SCHEDULED. description contiene il testo e supporta gli hashtag. title, place per una Pagina con sede e is_ai_generated, che dichiara che il Reel è stato creato o modificato con l'IA, sono facoltativi. Un Reel programmato aggiunge scheduled_publish_time, un timestamp UNIX di più di 10 minuti e al massimo 29 giorni avanti. Meta risponde con success impostato a true.
Quanti Reel può pubblicare una Pagina tramite API?
30 in un periodo mobile di 24 ore. Meta applica il limite su POST /{page_id}/video_reels quando un Reel viene pubblicato e consiglia alle app di applicarlo anche da sé, soprattutto alle app che permettono di programmare i post per dopo. Gli inviti ai collaboratori hanno un limite proprio, 10 per Pagina ogni 24 ore, e il riferimento video_reels elenca il codice 613, le chiamate a questa API hanno superato il limite di frequenza.
Quali permessi e attività di Pagina servono?
Un token di accesso alla Pagina di qualcuno che può eseguire l'attività CREATE_CONTENT sulla Pagina, con pages_show_list, pages_read_engagement e pages_manage_posts concessi tramite Facebook Login. Meta chiede inoltre alle app di mostrare alla persona un'informativa su come vengono usati i suoi Reel su Facebook, con opzioni per controllarla, e di offrire solo il pubblico Public, perché la pubblicazione su una Pagina ha un ambito pubblico implicito.
Quali errori restituisce l'API dei Reel?
Il codice 100 indica un parametro obbligatorio mancante, come upload_phase, e il messaggio di Meta elenca quelli mancanti. Altri quattro codici rifiutano un video fuori dalle specifiche:
- 1363040: le proporzioni non sono supportate; i video devono essere tra 16x9 e 9x16.
- 1363127: la risoluzione non è supportata; il minimo è 540 x 960 pixel.
- 1363128: la durata non è supportata; i Reel durano da 3 a 90 secondi.
- 1363129: il frame rate medio non è supportato; i Reel richiedono da 24 a 60 fotogrammi al secondo.
Come si elencano i Reel di una Pagina?
Con GET /{page-id}/video_reels, che restituisce i Reel pubblicati della Pagina con i relativi ID, date di aggiornamento e descrizioni. since e until restringono l'elenco a date indicate come today, yesterday, un timestamp UNIX o yyyy-mm-dd, con until successiva a since. Il riferimento al feed di Meta indica questo edge per i Reel pubblicati su una Pagina.
Come si pubblica un Reel con easyCoexistence?
Non come Reel, per ora. publish_facebook_post invia i video all'edge videos della Pagina, come normali post video, ed easyCoexistence non ha uno strumento per le chiamate video_reels; i token delle Pagine non vengono consegnati, quindi nemmeno i tre passaggi possono essere eseguiti dal proprio codice sulla sua connessione. Pubblica il Reel da Facebook o da Meta Business Suite, oppure pubblica il video come normale post video.
Errori comuni
- Inviare il caricamento a graph.facebook.com. Il video va a rupload.facebook.com con l'intestazione Authorization: OAuth; solo le chiamate start, finish e di stato usano graph.facebook.com.
- Ospitare il file dove Meta non può scaricarlo. Un file_url dietro un login, su un sito il cui robots.txt blocca facebookexternalhit/1.1, o su fbcdn viene rifiutato.
- Ricominciare da capo dopo un caricamento interrotto. Controlla prima lo stato: uploading_phase.bytes_transfered è l'offset da cui riprendere, e una nuova sessione è l'ultima risorsa.
- Mettere in coda più di 30 Reel per una Pagina in un giorno. Meta conta i Reel pubblicati via API in un periodo mobile di 24 ore, quindi distribuisci quelli programmati.
Non ha uno strumento per l'API dei Reel, quindi un Reel si pubblica da Facebook o da Meta Business Suite. Da US$ 9 a US$ 0,75 per connessione al mese, con calo man mano che aggiungi connessioni, con i primi 3 giorni di prova gratuita.
Domande frequenti
È possibile pubblicare un Reel su un profilo o gruppo Facebook tramite API?
No. L'API di pubblicazione dei Reel di Meta pubblica Reel solo su Pagine Facebook, e li fa crosspostare solo su altre Pagine.
publish_facebook_post pubblica Reel?
No. Invia testo, link, foto e video alla Pagina. Un Reel usa le chiamate video_reels, che gli strumenti di easyCoexistence non eseguono.
Come verifico un Reel per corrispondenze di copyright?
Leggi GET /{video-id}?fields=copyright_check_information con pages_read_engagement. Meta esegue il controllo al caricamento, può richiedere un paio di minuti, e solo il proprietario vede le corrispondenze.
Un'altra Pagina può pubblicare anche il mio Reel?
Sì, come collaboratore. POST /{video-id}/collaborators con target_id impostato all'ID della loro Pagina invia un invito, e una volta accettato il Reel compare anche sulla loro Pagina.
Continua a leggere
Collega il tuo primo canale in due minuti.
Nessuna revisione delle piattaforme da aspettare. Collega WhatsApp, Instagram, TikTok o un altro canale, poi chiedi alla tua AI di pubblicare, rispondere o fare un report, e guardala al lavoro.
- 3 giorni gratis
- Disdici quando vuoi
- Solo API ufficiali
- Monitorato 24/7
Verificato il