Giriş yapınÜcretsiz denemeyi başlatın
easyCoexistence Resmi API'ler

Instagram hikayelerini API üzerinden yayınlama

Instagram API'si bir hikayeyi, herkese açık bir URL'deki tek bir görselden veya tek bir videodan yayınlar: media_type değeri STORIES olan bir konteyner oluşturun, ardından yayınlayın. Görseller en fazla 8 MB'lık JPEG, videolar 3 ila 60 saniye ve en fazla 100 MB olabilir. Meta 9:16 çerçeve öneriyor; hikaye, uygulamadaki gibi 24 saat sonra kaybolur.

easyCoexistence, Claude, ChatGPT ya da kendi kodunuzdan publish_instagram_post ile görsel ve video hikayeleri yayınlar; bunları kendi kuyruğundan zamanlayabilir.

60 s

API'nin yayınladığı en uzun hikaye videosu; en kısası 3 saniye, dosya 100 MB'a kadar çıkabilir.

8 MB

En büyük hikaye görseli; JPEG olmak zorunda.

24 hours

Yayınlanmış bir hikayenin süresi dolmadan önce ne kadar yayında kaldığı.

Under 5

Bu kadar düşük hikaye metrik değerleri, sayı yerine hata 10 (yeterli izleyici yok) olarak döner.

Bir hikaye nasıl yayınlanır?

Diğer gönderilerle aynı iki çağrıyla. media_type değeri STORIES olan ve image_url ya da video_url içeren POST /<IG_ID>/media, ardından konteyner kimliğiyle POST /<IG_ID>/media_publish. Video hikaye önce işlenir; yayınlanabilmesi için konteynerin status_code değerinin FINISHED olması gerekir.

Meta'nın referansı fotoğraflar, videolar ve karusel için açıklama tanımlıyor, hikayeler için tanımlamıyor; bu yüzden izleyiciye yönelik sözler görselin ya da videonun içinde yer almalı.

Hikaye medya gereksinimleri nelerdir?

Meta, hikaye görselleri ve videoları için kırpma ya da boş alanı önlemek adına 9:16 çerçeve öneriyor.

  • Görsel: JPEG, en fazla 8 MB, sRGB renk uzayında; diğer renk uzayları dönüştürülür.
  • Video: H.264 veya HEVC video ve AAC ses içeren MOV ya da MP4, saniyedeki kare sayısı 23 ila 60, en fazla 1920 piksel genişlikte ve 25 Mbps.
  • Video süresi: 3 ila 60 saniye, en fazla 100 MB dosya boyutuyla.
  • Video en-boy oranı: 0,1:1 ile 10:1 arasındaki her oran kabul edilir.

Bir hikaye neleri taşıyabilir?

Görselin ya da videonun kendisini ve diğer hesaplara yapılan etiketlemeleri. Temmuz 2025'ten itibaren user_tags parametresi, görsel ve video hikayelerinde herkese açık hesapları etiketler; x ve y koordinatları isteğe bağlıdır. Meta, API üzerinden çıkartmaların yayınlanmasını desteklemiyor; bu nedenle bağlantılar, anketler ve konumlar uygulamada kalır.

Bir hikaye yayınlandıktan sonra ne olur?

Uygulamadaki gibi 24 saat yayında kalır, ardından süresi dolar. Meta, canlı hikayeleri ayrı bir stories edge üzerinde listeler; hesabın medya listesi, GET /<IG_ID>/media, bunları içermez. Geri okunduğunda bir hikayenin media_type değeri, diğer tüm medya gibi IMAGE ya da VIDEO olur. Bu yüzden hikayeleri türüne göre değil, nerede bulduğunuza göre ayırt edin.

Yanıtlar ve etiketlemeler nasıl geri gelir?

Doğrudan mesaj olarak. Bir hikayeye verilen yanıt, hikayenin ID'si ve URL'si eklenmiş halde messages webhook'una DM olarak ulaşır ve yanıt için olağan 24 saatlik pencereyi açar. Biri hesabı kendi hikayesinde etiketlediğinde bu da story_mention türünde bir ekle birlikte mesaj olarak gelir. Meta'nın Mentions API'si hikayeleri kapsamaz.

Bir hikaye hangi metrikleri bildirir?

Erişim, görüntülenme, paylaşım, yanıt, takip, profil ziyareti, profil etkinliği, gezinme, bağlantı tıklamaları, yeniden paylaşım ve toplam etkileşim; media insights uç noktası üzerinden okunur. Yalnızca 24 saat kullanılabilirler ve 5'ten küçük bir değer, sayı yerine hata kodu 10'u (yeterli izleyici yok) döndürür. Avrupa ve Japonya'daki kişilerden gelen yanıtlar sayıya katılmaz; oradaki bir hesabın oluşturduğu hikaye 0 yanıt bildirir.

Yaygın hatalar

  • Bir bağlantı çıkartması planlamak. API çıkartma yayınlamaz; bu yüzden bağlantının kişilere başka bir yoldan, örneğin bir DM yanıtıyla, ulaşması gerekir.
  • Hikaye metriklerini ertesi gün okumak. Yalnızca 24 saat kullanılabilirler; bu yüzden hikaye yayındayken toplayın.
  • Yayınlanmış bir hikayeyi hesabın medya listesinde aramak. Canlı hikayeler ayrı bir stories edge üzerinde listelenir.
  • Yatay bir videoyu hikaye olarak yayınlamak. Meta 9:16 öneriyor; diğer biçimler boş alan gösterebilir ya da kırpılabilir.
Bunu EasyCoexistence'la yapmak

Bir hikayeye gelen yanıtlar DM olarak ulaşır; uç noktanıza iletilebilir ya da bir otomasyondan yanıt alabilir. Bağlantı başına aylık US$ 9'dan US$ 0,75'e kadar, bağlantı ekledikçe düşer; ilk 3 gün ücretsizdir.

Sık sorulan sorular

API ile hikayeye bağlantı çıkartması ekleyebilir miyim?

Hayır. Meta, API üzerinden bağlantılar, anketler ve konumlar dahil çıkartma yayınlanmasını desteklemez. Çıkartma olmadan başka bir hesabı etiketlemek desteklenir.

Yayınlanmış bir hikaye API'de nerede listelenir?

Canlıyken hesabın ayrı stories edge üzerinde. GET /<IG_ID>/media hikayeleri içermez ve bir hikaye IMAGE ya da VIDEO olarak geri okunur.

Bir hikayenin API üzerinden açıklaması olabilir mi?

Hayır. Meta'nın referansı hikayeler için bir açıklama tanımlamıyor ve publish_instagram_post, bir hikayeyi açıklamasız gönderir; bu yüzden izleyiciye yönelik sözler görselin ya da videonun içine yazılmalı.

Hikaye içgörüleri ne kadar süreyle kullanılabilir?

24 saat. Meta hikaye metriklerini yalnızca bu kadar süre kullanılabilir kılar; bu yüzden hikaye yayındayken okuyun.

Okumaya devam edin

İlk kanalınızı iki dakikada bağlayın.

Beklemeniz gereken platform incelemesi yok. WhatsApp, Instagram, TikTok veya başka bir kanalı bağlayın, ardından yapay zekânızdan paylaşım yapmasını, yanıtlamasını ya da rapor vermesini isteyin ve işini izleyin.

  • 3 gün ücretsiz
  • İstediğiniz zaman iptal
  • Yalnızca resmi API'ler
  • 7/24 izleniyor

Doğrulama tarihi