Pubblicare Reels Instagram tramite l'API
L'API di Instagram pubblica un Reel da un file MOV o MP4 presente su un URL pubblico: crea un container con media_type REELS, attende che Meta elabori il video, quindi lo pubblica. Un Reel dura da 3 secondi a 15 minuti e può arrivare a 300 MB, e Meta consiglia un fotogramma 9:16 per evitare ritagli o spazi vuoti.
easyCoexistence pubblica i Reel con publish_instagram_post da Claude, ChatGPT o dal tuo codice: passi l'URL del video e la didascalia, e mentre il video è ancora in elaborazione termina la pubblicazione da solo.
Il Reel più lungo che l'API pubblica; il più corto dura 3 secondi.
Dimensione massima del file Reel, in MOV o MP4 con video H.264 o HEVC e audio AAC.
Ogni quanto Meta suggerisce di controllare lo status_code di un container in elaborazione, per non più di 5 minuti.
Per quanto tempo un container di Reel può restare non pubblicato prima di scadere.
Come viene pubblicato un Reel?
In tre passaggi. Primo, POST /<IG_ID>/media con media_type impostato su REELS, video_url che punta al file e, se la vuoi, una didascalia; Meta recupera il video e restituisce un ID container. Secondo, attendi che Instagram elabori il video, controllando lo status_code del container. Terzo, POST /<IG_ID>/media_publish con creation_id impostato sull'ID del container, e la risposta contiene il nuovo ID media.
Meta documenta il suo caricamento riprendibile, che può inviare un file da un computer, solo per le configurazioni basate su Facebook Login for Business, Unified Login incluso. Con Instagram Login, il video proviene sempre da un URL pubblico.
Quali sono i requisiti video?
Le specifiche Meta per i Reel, che un file deve rispettare prima che Instagram lo elabori:
- Formato: MOV o MP4 (MPEG-4 Part 14), senza edit list, con l'atomo moov all'inizio del file.
- Video: H.264 o HEVC, scansione progressiva, closed GOP, sottocampionamento cromatico 4:2:0, da 23 a 60 fotogrammi al secondo, fino a 1.920 pixel di larghezza e 25 Mbps.
- Audio: AAC, fino a 48 kHz, mono o stereo, a 128 kbps.
- Rapporto d'aspetto: da 0,01:1 a 10:1, con 9:16 consigliato.
- Durata e dimensione: da 3 secondi a 15 minuti, fino a 300 MB.
Cosa succede mentre il video viene elaborato?
Lo status_code del container vale IN_PROGRESS finché Instagram non ha elaborato il video, poi FINISHED, e solo allora può essere pubblicato. Pubblicare prima fallisce con il codice 9007, sottocodice 2207027, che significa attendere e non correggere. Meta consiglia di controllare lo stato una volta al minuto per non più di 5 minuti.
ERROR indica che il container non ha completato l'elaborazione, ed EXPIRED indica che è rimasto non pubblicato per 24 ore; in entrambi i casi serve un nuovo container. PUBLISHED significa che il Reel è già online.
Quali opzioni per i Reel offre l'API?
Oltre al video e alla didascalia, il container accetta questi parametri di Meta:
share_to_feed: true fa comparire il Reel anche nel Feed oltre che nella scheda Reel, false lo mantiene solo nella scheda Reel. Nessuno dei due valori garantisce un posto nella scheda Reel.cover_url: un JPEG fino a 8 MB usato come copertina nella scheda Reel, ritagliato sul centro 9:16, e in un quadrato quando condiviso nel Feed.thumb_offset: il fotogramma, in millisecondi, usato come miniatura quando non c'è una copertina; 0 è il primo fotogramma.audio_name: un nome per l'audio del Reel, impostabile una sola volta.trial_params: pubblica un Reel di prova, condiviso solo con chi non segue l'account finché non viene promosso.
Cos'altro vale per un Reel?
Alcune regole valgono per un Reel dal momento in cui viene creato il suo container.
- Un Reel non può essere un elemento di un carosello; viene sempre pubblicato da solo.
- Le impostazioni di privacy dell'account si applicano alla pubblicazione: con Consenti remix attivo, il nuovo Reel consente anche il remix.
- Il tagging musicale è disponibile solo per l'audio originale.
- Letto in seguito, un Reel riporta
media_typeVIDEO, come ogni altro video. - Conta come un post verso il limite di 100 post pubblicati tramite API in 24 ore dell'account.
Quali metriche riporta un Reel?
Tramite l'endpoint degli insight dei media, un Reel riporta reach, views, likes, comments, saved, shares, total_interactions e reposts, più tre metriche proprie: ig_reels_avg_watch_time, ig_reels_video_view_total_time e reels_skip_rate, cioè la quota di visualizzazioni saltate entro i primi 3 secondi. Likes, comments e views contano solo l'attività organica, e i dati alla base possono ritardare fino a 48 ore.
Errori comuni
- Pubblicare nel momento in cui viene creato il container. Attendi che status_code riporti FINISHED, altrimenti la chiamata fallisce con sottocodice 2207027.
- Inviare un file WebM o AVI. I Reel devono essere MOV o MP4, altrimenti Meta li rifiuta con codice 352, sottocodice 2207026.
- Aspettarsi che share_to_feed porti il Reel nella scheda Reel. Aggiunge solo il Feed; è Instagram a decidere cosa mostra la scheda Reel.
- Lasciare un container non pubblicato per una notte. Scade 24 ore dopo la creazione, e la pubblicazione richiede poi un nuovo container.
I Reel si possono anche programmare dalla propria coda. Da US$ 9 a US$ 0,75 per connessione al mese, con prezzo decrescente all'aumentare delle connessioni, e con una prova gratuita di 3 giorni.
Domande frequenti
Quanto può durare un Reel tramite l'API?
Da 3 secondi a 15 minuti, come file MOV o MP4 fino a 300 MB.
Posso caricare un Reel dal mio computer?
Non con Instagram Login. L'API recupera il video da un URL pubblico, quindi metti prima il file in un punto che gli dia un link pubblico.
Un Reel pubblicato tramite l'API compare anche nel Feed?
Può. Il parametro share_to_feed decide se il Reel può comparire nel Feed oltre che nella scheda Reel.
Perché la pubblicazione di un Reel fallisce con 9007?
Instagram sta ancora elaborando il video. Controlla lo status_code del container e pubblica quando riporta FINISHED; nella richiesta non serve correggere nulla.
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