MasukMulai uji coba gratis
easyCoexistence API resmi

Mempublikasikan Instagram Reels melalui API

API Instagram mempublikasikan Reel dari file MOV atau MP4 di URL publik: buat kontainer dengan media_type REELS, tunggu selagi Meta memproses video, lalu publikasikan. Reel berdurasi 3 detik hingga 15 menit dan berukuran hingga 300 MB, dan Meta menyarankan bingkai 9:16 agar tidak terpotong atau ada ruang kosong.

easyCoexistence mempublikasikan Reel dengan publish_instagram_post dari Claude, ChatGPT, atau kode Anda sendiri: berikan URL video dan caption, dan selagi video masih diproses, ia menyelesaikan publikasi dengan sendirinya.

15 min

Reel terpanjang yang dipublikasikan API; yang terpendek 3 detik.

300 MB

Ukuran file Reel terbesar, berupa MOV atau MP4 dengan video H.264 atau HEVC dan audio AAC.

1 min

Seberapa sering Meta menyarankan memeriksa status kontainer yang sedang diproses, tidak lebih dari 5 menit.

24 hours

Berapa lama kontainer Reel dapat menunggu tanpa dipublikasikan sebelum kedaluwarsa.

Bagaimana Reel dipublikasikan?

Dalam tiga langkah. Pertama, POST /<IG_ID>/media dengan media_type diatur ke REELS, video_url mengarah ke file, dan jika diinginkan, caption; Meta mengambil video dan mengembalikan ID kontainer. Kedua, tunggu selagi Instagram memproses video, dengan memeriksa status_code kontainer. Ketiga, POST /<IG_ID>/media_publish dengan creation_id berisi ID kontainer, dan respons membawa ID media yang baru.

Meta mendokumentasikan unggahan yang dapat dilanjutkan, yang dapat mengirim file dari komputer, hanya untuk pengaturan yang dibangun di atas Facebook Login for Business, termasuk Unified Login. Dengan Instagram Login, video selalu berasal dari URL publik.

Apa saja syarat video?

Spesifikasi Meta untuk Reel, yang harus dipenuhi file sebelum Instagram memprosesnya:

  • Kontainer: MOV atau MP4 (MPEG-4 Part 14), tanpa edit list, dengan moov atom di awal file.
  • Video: H.264 atau HEVC, progressive scan, closed GOP, subsampling kroma 4:2:0, 23 hingga 60 frame per detik, lebar hingga 1920 piksel dan 25 Mbps.
  • Audio: AAC, hingga 48 kHz, mono atau stereo, pada 128 kbps.
  • Rasio aspek: dari 0.01:1 hingga 10:1, dengan 9:16 yang direkomendasikan.
  • Durasi dan ukuran: 3 detik hingga 15 menit, hingga 300 MB.

Apa yang terjadi selama video diproses?

status_code kontainer bernilai IN_PROGRESS hingga Instagram selesai memproses video, lalu FINISHED, dan baru setelah itu dapat dipublikasikan. Publikasi lebih awal gagal dengan kode 9007, subkode 2207027, yang berarti tunggu, bukan perbaiki. Meta menyarankan memeriksa status setiap menit, tidak lebih dari 5 menit.

ERROR berarti kontainer gagal menyelesaikan pemrosesan, dan EXPIRED berarti kontainer tidak dipublikasikan selama 24 jam; keduanya memerlukan kontainer baru. PUBLISHED berarti Reel sudah tayang.

Opsi Reel apa saja yang ditawarkan API?

Selain video dan caption, kontainer Reel Meta menerima parameter berikut:

  • share_to_feed: true membuat Reel dapat muncul di Feed sekaligus tab Reels, false membatasinya hanya di tab Reels. Kedua nilai tidak menjamin Reel tampil di tab Reels.
  • cover_url: JPEG hingga 8 MB yang digunakan sebagai sampul tab Reels, dipotong di tengah 9:16, dan menjadi persegi saat dibagikan ke Feed.
  • thumb_offset: bingkai, dalam milidetik, yang dipakai sebagai thumbnail jika tidak ada sampul; 0 adalah bingkai pertama.
  • audio_name: nama untuk audio Reel, yang hanya dapat diatur sekali.
  • trial_params: mempublikasikan Reel uji, hanya dibagikan kepada orang yang tidak mengikuti akun hingga Reel itu dipromosikan.

Aturan lain apa yang berlaku untuk Reel?

Beberapa aturan berlaku sejak kontainer Reel dibuat.

  • Reel tidak dapat menjadi item carousel; Reel selalu dipublikasikan sendiri.
  • Pengaturan privasi akun berlaku saat publikasi: jika Allow remixing aktif, Reel baru juga mengizinkan remix.
  • Pemberian tag musik hanya tersedia untuk audio orisinal.
  • Saat dibaca kemudian, Reel melaporkan media_type VIDEO, seperti video lainnya.
  • Reel dihitung sebagai satu dari 100 postingan yang dipublikasikan API dalam 24 jam untuk akun tersebut.

Metrik apa yang dilaporkan Reel?

Melalui endpoint media insights, Reel melaporkan reach, views, likes, comments, saved, shares, total_interactions dan reposts, ditambah tiga metrik tersendiri: ig_reels_avg_watch_time, ig_reels_video_view_total_time dan reels_skip_rate, yaitu proporsi tayangan yang dilewati dalam 3 detik pertama. likes, comments dan views hanya menghitung aktivitas organik, dan data di baliknya dapat tertinggal hingga 48 jam.

Kesalahan umum

  • Mempublikasikan saat kontainer baru dibuat. Tunggu hingga status_code bernilai FINISHED, atau panggilan gagal dengan subkode 2207027.
  • Mengirim file WebM atau AVI. Reel harus berupa MOV atau MP4, atau Meta menolaknya dengan kode 352, subkode 2207026.
  • Mengira share_to_feed akan menempatkan Reel di tab Reels. Parameter itu hanya menambahkan Feed; Instagram yang menentukan isi tab Reels.
  • Membiarkan kontainer tidak dipublikasikan semalaman. Kontainer kedaluwarsa 24 jam setelah dibuat, dan publikasi kemudian memerlukan kontainer baru.
Melakukan ini dengan EasyCoexistence

Reel juga dapat dijadwalkan dari antrean sendiri. US$ 9 hingga US$ 0.75 per koneksi per bulan, turun seiring penambahan koneksi, dengan 3 hari pertama gratis.

Pertanyaan yang sering diajukan

Berapa lama Reel dapat berdurasi lewat API?

Dari 3 detik hingga 15 menit, sebagai file MOV atau MP4 berukuran hingga 300 MB.

Bisakah saya mengunggah Reel dari komputer saya?

Tidak dengan Instagram Login. API mengambil video dari URL publik, jadi letakkan file di tempat yang memberinya tautan publik terlebih dahulu.

Apakah Reel yang dipublikasikan lewat API juga muncul di Feed?

Bisa. Parameter share_to_feed menentukan apakah Reel boleh muncul di Feed sekaligus di tab Reels.

Mengapa publikasi Reel gagal dengan 9007?

Instagram masih memproses video. Periksa status_code kontainer dan publikasikan setelah bernilai FINISHED; tidak ada yang perlu diperbaiki dalam permintaan.

Lanjut membaca

Hubungkan saluran pertama Anda dalam dua menit.

Tanpa menunggu peninjauan platform. Hubungkan WhatsApp, Instagram, TikTok, atau saluran lainnya, lalu minta AI Anda untuk memposting, membalas, atau membuat laporan, dan lihat hasilnya langsung.

  • Gratis 3 hari
  • Batalkan kapan saja
  • Hanya API resmi
  • Dipantau 24/7

Diverifikasi pada