MasukMulai uji coba gratis
easyCoexistence API resmi

Batas caption Instagram: karakter, hashtag, dan @ tag di API

API Instagram menerbitkan caption hingga 2,200 karakter untuk foto, Reel, atau carousel, dengan maksimal 20 @ tag. Per November 2026, Pusat Bantuan Instagram mengizinkan 5 hashtag per postingan, sedangkan referensi API Meta masih mencantumkan 30, jadi batasi di angka 5. Akun yang disebut lewat @ akan menerima notifikasi saat postingan dipublikasikan, dan caption yang terlalu panjang gagal dengan kode 36004, subkode 2207010.

easyCoexistence mempublikasikan foto, carousel, atau Reel beserta caption-nya lewat publish_instagram_post, dari Claude, ChatGPT, atau kode Anda sendiri, dengan mengatur caption sekali pada carousel, dan list_social_posts membaca kembali caption tiap postingan.

2,200

Jumlah karakter maksimum yang dapat ditampung caption lewat API Instagram.

5

Jumlah hashtag maksimum yang kini diizinkan Pusat Bantuan Instagram pada satu postingan, di caption maupun komentar.

30

Jumlah hashtag maksimum per caption di referensi API Meta, yang masih mencantumkan angka lama.

20

Jumlah @ tag maksimum dalam satu caption; jika melebihi, muncul kode 100, subkode 2207040.

2207010

Subkode kesalahan, di bawah kode 36004, untuk caption yang lebih panjang dari yang diizinkan Instagram.

Partial

media_publish bisa berhasil dengan config_issue CAPTION_NOT_ATTACHED: postingan sudah tayang tanpa caption-nya.

Berapa batas caption?

Ada tiga, semuanya berlaku pada parameter caption dari media container. Caption dapat memuat hashtag, ditulis #tag, dan nama pengguna akun Instagram, ditulis @username, dalam batas berikut:

  • Panjang: hingga 2.200 karakter.
  • Hashtag: hingga 5 per postingan menurut Pusat Bantuan Instagram, termasuk yang ada di komentar; referensi API Meta masih mencantumkan 30.
  • @ tag: hingga 20, dan setiap akun yang disebut akan diberi notifikasi saat postingan dipublikasikan.

Postingan apa yang menerima caption?

Foto, Reel, dan carousel. Pada carousel, caption ditempatkan di container carousel, karena gambar dan video di dalamnya tidak mendukung caption. Referensi Meta tidak mencantumkan caption untuk Stories, jadi kata-kata untuk Story harus ada di dalam gambar atau videonya sendiri.

Apa yang terjadi jika caption melanggar batas?

Permintaan gagal dengan kesalahan yang menyebutkan masalahnya. Caption yang terlalu panjang mengembalikan kode 36004, subkode 2207010, dan solusi Meta untuknya menyatakan ulang batasnya: maksimal 2.200 karakter, 30 hashtag, dan 20 @ tag. Lebih dari 20 @ tag juga dapat mengembalikan kode 100, subkode 2207040. Persingkat caption lalu kirim ulang permintaan.

Kapan akun yang disebut menerima notifikasi?

Saat container dipublikasikan, bukan saat dibuat. Akun yang disebut dengan @ dalam caption menerima notifikasi pada saat itu, sehingga container yang disiapkan lebih awal tidak memberi tahu siapa pun sampai tayang. Batas Meta sebesar 20 @ tag per caption berlaku untuk sebutan ini.

Bisakah postingan tayang tanpa caption-nya?

Bisa. media_publish dapat berhasil dengan field config_issue bernilai CAPTION_NOT_ATTACHED, yang berarti media terbit tanpa caption-nya. Meta menyebut ini keberhasilan sebagian: media ID-nya valid, jadi cocokkan ulang postingan itu alih-alih mempublikasikannya lagi.

Bisakah caption diubah setelah dipublikasikan?

Referensi media Meta mendokumentasikan satu pembaruan untuk media yang sudah dipublikasikan: mengaktifkan atau menonaktifkan komentar dengan POST /<IG_MEDIA_ID> dan comment_enabled. Tidak ada cara untuk mengedit caption, jadi periksa teks, hashtag, dan @ tag sebelum container dibuat.

Kesalahan umum

  • Hanya memeriksa panjang. Caption di bawah 2.200 karakter tetap melanggar batas jika memuat lebih dari 5 hashtag, aturan Instagram saat ini, atau lebih dari 20 @ tag.
  • Memberi caption pada item carousel. Hanya container carousel yang menerima caption.
  • Menulis caption untuk Story. Container Stories tidak menerima caption, jadi taruh kata-katanya di gambar atau video.
  • Mempublikasikan ulang setelah CAPTION_NOT_ATTACHED. Postingan pertama sudah tayang, dan publikasi kedua membuat duplikat.
Melakukan ini dengan EasyCoexistence

US$ 9 hingga US$ 0.75 per koneksi per bulan, turun seiring penambahan koneksi, dengan 3 hari pertama gratis.

Pertanyaan yang sering diajukan

Apa arti kesalahan 2207040 di Instagram?

Caption memiliki lebih dari 20 @ tag, dikembalikan di bawah kode 100. Hapus tag hingga tersisa 20 atau kurang, lalu kirim ulang permintaan.

Apakah batas 5 hashtag Instagram mencakup hashtag di komentar?

Ya. Pusat Bantuan Instagram mengizinkan hingga 5 hashtag per postingan, dengan menghitung yang ada di caption dan di komentar.

Bisakah saya mematikan komentar pada postingan yang sudah tayang lewat API?

Bisa. POST /<IG_MEDIA_ID> dengan comment_enabled bernilai false mematikan komentar, dan true mengaktifkannya kembali, satu-satunya pembaruan yang didokumentasikan referensi media Meta untuk media yang sudah dipublikasikan.

Apa arti kesalahan 2207010?

Caption lebih panjang dari yang diizinkan Instagram. Persingkat hingga 2.200 karakter atau kurang, lalu kirim ulang 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