Instagram açıklama sınırları: API'de karakter, hashtag ve @ etiketleri
Instagram'ın API'si, fotoğraf, Reel ya da karusel ile birlikte en fazla 2,200 karakterlik bir açıklama yayınlar; en fazla 20 @ etiketi eklenebilir. Kasım 2026 itibarıyla Instagram Yardım Merkezi gönderi başına en fazla 5 hashtag'e izin veriyor, Meta'nın API referansı ise hâlâ 30 yazıyor, bu yüzden 5'te kalın. Açıklamada @ ile anılan hesaplar gönderi yayınlandığında bildirim alır; çok uzun bir açıklama 36004 kodu ve 2207010 alt koduyla başarısız olur.
easyCoexistence, bir fotoğrafı, karuseli ya da Reel'i açıklamasıyla birlikte publish_instagram_post aracıyla yayınlar; Claude, ChatGPT ya da kendi kodunuzdan.
Instagram API'si üzerinden bir açıklamanın tutabileceği en fazla karakter sayısı.
Instagram Yardım Merkezi'nin gönderi başına artık izin verdiği en fazla hashtag sayısı; açıklamada ve yorumlarda.
Meta API referansında gönderi başına en fazla hashtag sayısı; referans hâlâ eski rakamı veriyor.
Bir açıklamadaki en fazla @ etiketi sayısı; aşılırsa 100 kodu ve 2207040 alt kodu döner.
36004 kodu altında, Instagram'ın izin verdiğinden uzun açıklama için hata alt kodu.
media_publish, config_issue CAPTION_NOT_ATTACHED ile başarılı olabilir: gönderi açıklamasız yayında olur.
Açıklama sınırları nelerdir?
Üç sınır var; hepsi media container'ın caption parametresi için geçerlidir. Açıklamaya #etiket biçiminde yazılan hashtag'ler ve @kullanıcıadı biçiminde yazılan Instagram hesap adları eklenebilir; bunlar şu sınırlar içinde kalmalıdır:
- Uzunluk: en fazla 2.200 karakter.
- Hashtag'ler: Instagram Yardım Merkezine göre bir gönderide en fazla 5, yorumlardakiler de sayılır; Meta'nın API referansı hâlâ 30 listeler.
- @ etiketleri: en fazla 20; anılan her hesap, gönderi yayınlandığında bilgilendirilir.
Hangi gönderiler açıklama alır?
Fotoğraflar, Reel'ler ve karuseller. Karuselde açıklama karusel container'ına eklenir, çünkü içindeki görseller ve videolar açıklamayı desteklemez. Meta'nın referansı Hikâyeler için açıklama tanımlamaz; bu yüzden hikâyeye yazılacak sözler görselin ya da videonun kendisine konmalıdır.
Bir açıklama sınırı aşarsa ne olur?
İstek, sorunu adlandıran bir hatayla başarısız olur. Çok uzun bir açıklama 36004 kodu ve 2207010 alt kodu döndürür; Meta'nın bu hataya önerdiği düzeltme sınırları yeniden belirtir: en fazla 2.200 karakter, 30 hashtag ve 20 @ etiketi. 20'den fazla @ etiketi de 100 kodu ve 2207040 alt kodu döndürebilir. Açıklamayı kısaltıp isteği yeniden gönderin.
Anılan hesaplar ne zaman bilgilendirilir?
Container oluşturulduğunda değil, yayınlandığında. Açıklamada @ ile anılan hesaplar tam o anda bildirim alır; bu yüzden önceden hazırlanan bir container, canlıya çıkana kadar kimseyi uyarmaz. Meta'nın açıklama başına 20 @ etiketi sınırı bu anılmalar için geçerlidir.
Gönderi açıklamasız yayınlanabilir mi?
Evet. media_publish, config_issue alanı CAPTION_NOT_ATTACHED olarak ayarlanmış bir başarı yanıtı verebilir; bu, medyanın açıklamasız yayınlandığı anlamına gelir. Meta buna kısmi başarı der: medya kimliği geçerlidir, bu yüzden gönderiyi yeniden yayınlamak yerine mevcut gönderiyle eşleştirin.
Yayınlandıktan sonra açıklama değiştirilebilir mi?
Meta'nın medya referansı, yayınlanmış medya için tek bir güncellemeyi belgeler: POST /<IG_MEDIA_ID> ve comment_enabled ile yorumları açmak ya da kapatmak. Açıklamayı düzenlemek için bir yol listelemez; bu yüzden metni, hashtag'leri ve @ etiketlerini container oluşturulmadan önce kontrol edin.
Yaygın hatalar
- Yalnızca uzunluğa bakmak. 2.200 karakterin altındaki bir açıklama da, Instagram'ın güncel kuralına göre 5'ten fazla hashtag ya da 20'den fazla @ etiketi içerirse sınırları aşar.
- Karusel öğelerine açıklama yazmak. Açıklamayı yalnızca karusel container'ı alır.
- Hikâye için açıklama yazmak. Hikâye container'ı açıklama almaz; sözleri görsele ya da videoya koyun.
- CAPTION_NOT_ATTACHED sonrası yeniden yayınlamak. İlk gönderi zaten canlıdır; ikinci yayın bir kopya oluşturur.
Karuselde açıklamayı bir kez ayarlarsınız ve list_social_posts her gönderinin açıklamasını geri okur. Bağlantı başına aylık US$ 9'dan US$ 0,75'e kadar, bağlantı ekledikçe düşer; ilk 3 gün ücretsiz.
Sık sorulan sorular
Instagram'da 2207040 hatası ne anlama gelir?
Açıklamada 20'den fazla @ etiketi var; 100 kodu altında döner. 20 ya da daha az kalana kadar etiket çıkarın ve isteği yeniden gönderin.
Instagram'ın 5 hashtag sınırı yorumdaki hashtag'leri de kapsar mı?
Evet. Instagram Yardım Merkezi, gönderi başına en fazla 5 hashtag'e izin verir; açıklamadakiler ve yorumdakiler birlikte sayılır.
Yayınlanmış bir gönderinin yorumlarını API üzerinden kapatabilir miyim?
Evet. comment_enabled değeri false olarak ayarlanmış POST /<IG_MEDIA_ID> yorumları kapatır, true yeniden açar. Meta'nın medya referansının yayınlanmış medya için belgelediği tek güncelleme budur.
2207010 hatası ne anlama gelir?
Açıklama, Instagram'ın izin verdiğinden uzun. 2.200 karakter ya da daha az olacak şekilde kısaltın ve isteği yeniden gönderin.
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