Mempublikasikan Instagram Stories melalui API
API Instagram mempublikasikan Story dari satu gambar atau satu video di URL publik: buat container dengan media_type STORIES, lalu publikasikan. Gambar berformat JPEG hingga 8 MB, video berdurasi 3 hingga 60 detik dan hingga 100 MB, Meta menyarankan bingkai 9:16, dan Story hilang setelah 24 jam, seperti di aplikasi.
easyCoexistence mempublikasikan Story gambar dan video dengan publish_instagram_post dari Claude, ChatGPT, atau kode Anda sendiri, dan dapat menjadwalkannya dari antrean sendiri.
Video Story terpanjang yang dipublikasikan API; yang terpendek 3 detik, dan berkas bisa mencapai 100 MB.
Gambar Story terbesar, yang harus berformat JPEG.
Lama Story yang sudah dipublikasikan tetap tayang sebelum kedaluwarsa.
Nilai metrik Story yang sangat rendah dikembalikan sebagai kode kesalahan 10, penonton belum cukup, alih-alih angka.
Bagaimana Story dipublikasikan?
Dengan dua panggilan yang sama seperti postingan biasa. POST /<IG_ID>/media dengan media_type diisi STORIES dan salah satu dari image_url atau video_url, lalu POST /<IG_ID>/media_publish dengan ID container. Video Story diproses lebih dulu, jadi status_code container-nya harus bertuliskan FINISHED sebelum bisa dipublikasikan.
Referensi Meta menjelaskan caption untuk foto, video, dan carousel, bukan untuk Story, jadi kata-kata untuk penonton sebaiknya ada di dalam gambar atau video itu sendiri.
Apa saja syarat media Story?
Meta menyarankan bingkai 9:16 untuk gambar dan video Story, agar tidak terpotong atau muncul ruang kosong.
- Gambar: JPEG, hingga 8 MB, dalam sRGB; ruang warna lain akan dikonversi.
- Video: MOV atau MP4 dengan video H.264 atau HEVC dan audio AAC, 23 hingga 60 frame per detik, lebar hingga 1920 piksel dan 25 Mbps.
- Durasi video: 3 hingga 60 detik, dengan berkas hingga 100 MB.
- Rasio aspek video: apa pun dari 0.1:1 hingga 10:1 diterima.
Apa yang bisa dibawa sebuah Story?
Gambar atau video itu sendiri, serta penyebutan akun lain: sejak Juli 2025 parameter user_tags menandai akun publik di Story gambar dan video, dengan koordinat x dan y bersifat opsional. Meta tidak mendukung publikasi stiker lewat API, sehingga tautan, polling, dan lokasi tetap ada di aplikasi.
Apa yang terjadi setelah Story dipublikasikan?
Story tetap tayang selama 24 jam lalu kedaluwarsa, seperti di aplikasi. Meta mencantumkan Story yang sedang tayang di edge stories terpisah; daftar media akun, GET /<IG_ID>/media, tidak menyertakannya. Saat dibaca kembali, media_type sebuah Story adalah IMAGE atau VIDEO, sama seperti media lain, jadi bedakan Story dari tempat Anda menemukannya, bukan dari tipenya.
Bagaimana balasan dan penyebutan kembali?
Sebagai pesan langsung. Balasan untuk Story sampai ke akun sebagai DM di webhook messages, dengan ID dan URL Story terlampir, dan membuka jendela 24 jam biasa untuk membalas. Ketika seseorang menyebut akun di Story-nya sendiri, itu juga masuk sebagai pesan, dengan lampiran bertipe story_mention. Mentions API Meta tidak mencakup Story.
Metrik apa yang dilaporkan Story?
Jangkauan, tayangan, dibagikan, balasan, pengikut, kunjungan profil, aktivitas profil, navigasi, klik tautan, repost, dan total interaksi, dibaca lewat endpoint insights media. Data hanya tersedia selama 24 jam, dan nilai di bawah 5 mengembalikan kode kesalahan 10, penonton belum cukup, alih-alih angka. Balasan dari orang di Eropa dan Jepang tidak dihitung, dan Story yang dibuat akun di sana melaporkan 0 balasan.
Kesalahan umum
- Merencanakan stiker tautan. API tidak mempublikasikan stiker, jadi tautan harus sampai ke orang lain dengan cara lain, misalnya lewat balasan DM.
- Membaca metrik Story keesokan harinya. Data hanya tersedia selama 24 jam, jadi kumpulkan saat Story masih tayang.
- Mencari Story yang sudah dipublikasikan di daftar media akun. Story yang sedang tayang tercantum di edge stories terpisah.
- Mempublikasikan video lanskap sebagai Story. Meta menyarankan 9:16, dan bentuk lain bisa menampilkan ruang kosong atau terpotong.
Balasan untuk Story masuk sebagai DM, yang bisa diteruskan ke endpoint Anda atau dibalas oleh otomasi. US$ 9 hingga US$ 0.75 per koneksi per bulan, turun seiring Anda menambah koneksi, dengan 3 hari pertama gratis.
Pertanyaan yang sering diajukan
Bisakah saya menambahkan stiker tautan ke Story lewat API?
Tidak. Meta tidak mendukung publikasi stiker lewat API, termasuk tautan, polling, dan lokasi. Menyebut akun lain tanpa stiker didukung.
Di mana Story yang dipublikasikan tercantum di API?
Di edge stories terpisah milik akun selama Story masih tayang. GET /<IG_ID>/media tidak menyertakan Story, dan Story dibaca kembali sebagai IMAGE atau VIDEO.
Bisakah Story memiliki caption lewat API?
Tidak. Referensi Meta tidak mencantumkan caption untuk Story, dan publish_instagram_post mengirim Story tanpa caption, jadi kata-kata untuk penonton diletakkan di dalam gambar atau video itu sendiri.
Berapa lama insight Story tersedia?
Selama 24 jam. Meta hanya menyediakan metrik Story selama itu, jadi baca saat Story masih tayang.
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