Log masukMulakan percubaan percuma
easyCoexistence API rasmi

Menerbitkan Instagram Stories melalui API

API Instagram menerbitkan Story daripada satu imej atau satu video pada URL awam: cipta container dengan media_type STORIES, kemudian terbitkannya. Imej ialah JPEG sehingga 8 MB, video berdurasi 3 hingga 60 saat dan sehingga 100 MB, Meta mengesyorkan bingkai 9:16, dan Story hilang selepas 24 jam, sama seperti dalam aplikasi.

easyCoexistence menerbitkan Story imej dan video dengan publish_instagram_post daripada Claude, ChatGPT atau kod anda sendiri, dan boleh menjadualkannya daripada barisan sendiri.

60 s

Video Story terpanjang yang API terbitkan; yang paling pendek ialah 3 saat, dan fail boleh mencecah 100 MB.

8 MB

Imej Story terbesar, yang mesti berformat JPEG.

24 hours

Tempoh Story yang diterbitkan kekal sebelum tamat tempoh.

Under 5

Nilai metrik Story yang serendah ini dikembalikan sebagai ralat 10, tidak cukup penonton, dan bukannya nombor.

Bagaimana Story diterbitkan?

Dengan dua panggilan yang sama seperti mana-mana siaran. POST /<IG_ID>/media dengan media_type ditetapkan kepada STORIES dan sama ada image_url atau video_url, kemudian POST /<IG_ID>/media_publish dengan ID container. Video Story diproses dahulu, jadi status_code container itu mesti menunjukkan FINISHED sebelum ia boleh diterbitkan.

Rujukan Meta menerangkan kapsyen untuk foto, video dan carousel, bukan untuk Story, jadi perkataan untuk penonton perlu berada dalam imej atau video itu sendiri.

Apakah keperluan media Story?

Meta mengesyorkan bingkai 9:16 untuk imej dan video Story, bagi mengelakkan pemotongan atau ruang kosong.

  • Imej: JPEG, sehingga 8 MB, dalam sRGB; ruang warna lain akan ditukar.
  • Video: MOV atau MP4 dengan video H.264 atau HEVC dan audio AAC, 23 hingga 60 bingkai sesaat, sehingga 1920 piksel lebar dan 25 Mbps.
  • Panjang video: 3 hingga 60 saat, dengan fail sehingga 100 MB.
  • Nisbah aspek video: sebarang nisbah antara 0.1:1 hingga 10:1 diterima.

Apakah yang boleh dibawa oleh Story?

Imej atau video itu sendiri, dan sebutan akaun lain: sejak Julai 2025 parameter user_tags menandakan akaun awam dalam Story imej dan video, dengan koordinat x dan y sebagai pilihan. Meta tidak menyokong penerbitan pelekat melalui API, jadi pautan, undian dan lokasi kekal dalam aplikasi.

Apa yang berlaku selepas Story diterbitkan?

Ia kekal selama 24 jam dan kemudian tamat tempoh, sama seperti dalam aplikasi. Meta menyenaraikan Story aktif pada tepi stories yang berasingan; senarai media akaun, GET /<IG_ID>/media, tidak merangkumi Story tersebut. Apabila dibaca semula, media_type Story ialah IMAGE atau VIDEO, sama seperti mana-mana media lain, jadi bezakan Story melalui tempat anda menemuinya dan bukan melalui jenisnya.

Bagaimana balasan dan sebutan diterima?

Sebagai mesej langsung (DM). Balasan kepada Story sampai kepada akaun sebagai DM pada webhook mesej, dengan ID dan URL Story dilampirkan, dan ia membuka tetingkap 24 jam biasa untuk balasan. Apabila seseorang menyebut akaun dalam Story mereka sendiri, ia tiba sebagai mesej juga, dengan lampiran jenis story_mention. API Mentions Meta tidak meliputi Story.

Metrik apa yang dilaporkan oleh Story?

Capaian, tontonan, kongsi, balasan, ikutan, lawatan profil, aktiviti profil, navigasi, klik pautan, siaran semula dan jumlah interaksi, dibaca melalui endpoint insights media. Metrik hanya tersedia selama 24 jam, dan nilai di bawah 5 mengembalikan kod ralat 10, tidak cukup penonton, dan bukannya nombor. Balasan daripada pengguna di Eropah dan Jepun tidak dikira dalam jumlah, dan Story yang dicipta oleh akaun di sana melaporkan 0 balasan.

Kesilapan biasa

  • Merancang pelekat pautan. API tidak menerbitkan pelekat, jadi pautan perlu sampai kepada orang melalui cara lain, seperti balasan DM.
  • Membaca metrik Story pada hari berikutnya. Metrik hanya tersedia selama 24 jam, jadi kumpulkannya ketika Story masih aktif.
  • Mencari Story yang diterbitkan dalam senarai media akaun. Story aktif disenaraikan pada tepi stories yang berasingan.
  • Menerbitkan video landskap sebagai Story. Meta mengesyorkan 9:16, dan bentuk lain boleh memaparkan ruang kosong atau dipotong.
Menggunakan EasyCoexistence untuk ini

Balasan kepada Story tiba sebagai DM, yang boleh dimajukan ke endpoint anda atau dibalas oleh automasi. US$ 9 hingga US$ 0.75 setiap sambungan sebulan, menurun apabila anda menambah sambungan, dengan percubaan percuma 3 hari.

Soalan lazim

Bolehkah saya menambah pelekat pautan pada Story melalui API?

Tidak. Meta tidak menyokong penerbitan pelekat melalui API, termasuk pautan, undian dan lokasi. Menyebut akaun lain tanpa pelekat disokong.

Di manakah Story yang diterbitkan disenaraikan dalam API?

Pada tepi stories akaun yang berasingan ketika ia aktif. GET /<IG_ID>/media tidak merangkumi Story, dan Story dibaca semula sebagai IMAGE atau VIDEO.

Bolehkah Story mempunyai kapsyen melalui API?

Tidak. Rujukan Meta tidak menerangkan kapsyen untuk Story, dan publish_instagram_post menghantar Story tanpa kapsyen, jadi perkataan untuk penonton perlu diletakkan dalam imej atau video itu sendiri.

Berapa lamakah insights Story tersedia?

Selama 24 jam. Meta hanya menyediakan metrik Story untuk tempoh itu, jadi bacalah ketika Story masih aktif.

Teruskan membaca

Sambungkan saluran pertama anda dalam masa dua minit.

Tidak perlu menunggu semakan platform. Sambungkan WhatsApp, Instagram, TikTok atau saluran lain, kemudian minta AI anda menyiarkan, membalas atau melaporkan, dan lihat ia bekerja.

  • 3 hari percuma
  • Batal bila-bila masa
  • API rasmi sahaja
  • Dipantau 24/7

Disahkan pada