Conectați-văÎncepeți perioada de probă gratuită
easyCoexistence API-uri oficiale

Publicarea Reels-urilor prin API-ul Instagram

API-ul Instagram publică un Reel dintr-un fișier MOV sau MP4 aflat la un URL public: creați un container cu media_type REELS, așteptați cât timp Meta procesează videoclipul, apoi publicați-l. Un Reel are între 3 secunde și 15 minute și până la 300 MB, iar Meta recomandă un cadru 9:16 pentru a evita decuparea sau spațiul gol.

easyCoexistence publică Reels cu publish_instagram_post din Claude, ChatGPT sau din propriul cod: dați-i URL-ul videoclipului și legenda, iar cât timp videoclipul este încă în procesare, publicarea se finalizează de la sine.

15 min

Cel mai lung Reel pe care API-ul îl publică; cel mai scurt are 3 secunde.

300 MB

Cea mai mare dimensiune a unui fișier Reel, în format MOV sau MP4, cu video H.264 sau HEVC și audio AAC.

1 min

Cât de des sugerează Meta să verificați starea unui container în procesare, pentru cel mult 5 minute.

24 hours

Cât timp poate aștepta un container de Reel nepublicat înainte să expire.

Cum se publică un Reel?

În trei pași. Mai întâi, trimiteți POST /<IG_ID>/media cu media_type setat la REELS, video_url care indică fișierul și, dacă doriți, o legendă; Meta preia videoclipul și returnează ID-ul containerului. Apoi, așteptați cât timp Instagram procesează videoclipul, verificând status_code al containerului. În al treilea pas, trimiteți POST /<IG_ID>/media_publish cu creation_id setat la ID-ul containerului, iar răspunsul conține ID-ul noului media.

Meta documentează încărcarea reluabilă, care poate trimite un fișier de pe un calculator, doar pentru configurațiile construite pe Facebook Login for Business, inclusiv Unified Login. Cu Instagram Login, videoclipul provine întotdeauna dintr-un URL public.

Care sunt cerințele pentru video?

Specificația Meta pentru Reels, pe care un fișier trebuie să o îndeplinească înainte ca Instagram să-l proceseze:

  • Container: MOV sau MP4 (MPEG-4 Part 14), fără liste de editare, cu atomul moov la începutul fișierului.
  • Video: H.264 sau HEVC, scanare progresivă, closed GOP, submostrearea cromatică 4:2:0, 23 până la 60 de cadre pe secundă, până la 1920 de pixeli lățime și 25 Mbps.
  • Audio: AAC, până la 48 kHz, mono sau stereo, la 128 kbps.
  • Raport de aspect: orice între 0,01:1 și 10:1, cu 9:16 recomandat.
  • Lungime și dimensiune: de la 3 secunde la 15 minute, până la 300 MB.

Ce se întâmplă cât timp videoclipul se procesează?

status_code al containerului are valoarea IN_PROGRESS până când Instagram a procesat videoclipul, apoi FINISHED, și abia atunci poate fi publicat. Publicarea mai devreme eșuează cu codul 9007, subcodul 2207027, ceea ce înseamnă că trebuie să așteptați, nu să corectați. Meta sugerează verificarea stării o dată pe minut, pentru cel mult 5 minute.

ERROR înseamnă că containerul nu a reușit să finalizeze procesarea, iar EXPIRED înseamnă că a stat nepublicat 24 de ore; ambele cer un container nou. PUBLISHED înseamnă că Reel-ul este deja publicat.

Ce opțiuni pentru Reel oferă API-ul?

Pe lângă videoclip și legendă, containerul de Reel al Meta acceptă acești parametri:

  • share_to_feed: true face ca Reel-ul să apară și în Feed, pe lângă fila Reels, iar false îl păstrează doar în fila Reels. Nicio valoare nu garantează un loc în fila Reels.
  • cover_url: un JPEG de până la 8 MB folosit ca copertă în fila Reels, decupat la mijloc, în format 9:16, și la pătrat când este partajat în Feed.
  • thumb_offset: cadrul, în milisecunde, folosit ca miniatură când nu există copertă; 0 este primul cadru.
  • audio_name: un nume pentru audio-ul Reel-ului, care poate fi setat o singură dată.
  • trial_params: publică un Reel de probă, partajat doar cu persoanele care nu urmăresc contul, până când este promovat.

Ce altceva se aplică unui Reel?

Câteva reguli urmăresc un Reel din momentul în care containerul său este creat.

  • Un Reel nu poate fi element de carusel; este întotdeauna publicat separat.
  • Setările de confidențialitate ale contului se aplică la publicare: cu „Allow remixing” activat, noul Reel permite și remixarea.
  • Etichetarea muzicii este disponibilă doar pentru audio original.
  • Citit ulterior, un Reel raportează media_type VIDEO, ca orice alt videoclip.
  • Se numără ca o singură postare din cele 100 de postări publicate prin API în 24 de ore ale contului.

Ce metrici raportează un Reel?

Prin endpoint-ul de insights pentru media, un Reel raportează reach, views, likes, comments, saved, shares, total_interactions și reposts, plus trei metrici proprii: ig_reels_avg_watch_time, ig_reels_video_view_total_time și reels_skip_rate, adică proporția vizualizărilor care au fost omise în primele 3 secunde. Likes, comments și views numără doar activitatea organică, iar datele din spatele lor pot întârzia până la 48 de ore.

Greșeli frecvente

  • Publicarea imediat după crearea containerului. Așteptați până când status_code are valoarea FINISHED, altfel apelul eșuează cu subcodul 2207027.
  • Trimiterea unui fișier WebM sau AVI. Reel-urile trebuie să fie MOV sau MP4, altfel Meta le refuză cu codul 352, subcodul 2207026.
  • Așteptarea ca share_to_feed să pună Reel-ul în fila Reels. Parametrul adaugă doar Feed-ul; Instagram decide ce afișează fila Reels.
  • Lăsarea unui container nepublicat peste noapte. Acesta expiră la 24 de ore de la creare, iar publicarea necesită apoi unul nou.
Faceți acest lucru cu EasyCoexistence

Reels pot fi programate și din propria coadă. US$ 9 până la US$ 0,75 pe conexiune pe lună, scăzând pe măsură ce adăugați conexiuni, cu prima perioadă de probă gratuită de 3 zile.

Întrebări frecvente

Cât de lung poate fi un Reel prin API?

De la 3 secunde la 15 minute, sub formă de fișier MOV sau MP4 de până la 300 MB.

Pot încărca un Reel de pe calculatorul meu?

Nu cu Instagram Login. API-ul preia videoclipul de la un URL public, deci puneți mai întâi fișierul undeva unde primește un link public.

Un Reel publicat prin API apare și în Feed?

Poate. Parametrul share_to_feed decide dacă Reel-ul poate apărea în Feed, pe lângă fila Reels.

De ce eșuează publicarea unui Reel cu 9007?

Instagram încă procesează videoclipul. Verificați status_code al containerului și publicați când are valoarea FINISHED; nu trebuie corectat nimic în cerere.

Continuați să citiți

Conectați primul canal în două minute.

Fără recenzii de platformă de așteptat. Conectați WhatsApp, Instagram, TikTok sau alt canal, apoi cereți AI-ului să publice, să răspundă sau să raporteze și urmăriți-l cum lucrează.

  • 3 zile gratuit
  • Anulați oricând
  • Doar API-uri oficiale
  • Monitorizat 24/7

Verificat la