Batas laju API Instagram: panggilan per 24 jam dan throughput DM
API Instagram memberi setiap aplikasi anggaran panggilan untuk setiap akun yang dilayaninya: 4,800 panggilan dikali impresi akun selama 24 jam bergulir. Pesan memiliki laju terpisah per akun: 100 pesan teks per detik melalui Send API, 10 untuk audio atau video, dan 750 balasan privat per jam. Jika melewati anggaran, panggilan gagal dengan kesalahan 80002, dan header X-Business-Use-Case-Usage menunjukkan seberapa banyak yang sudah dipakai.
easyCoexistence dapat meneruskan komentar, mention, dan DM setiap akun Instagram ke endpoint Anda begitu masuk, sehingga agen bereaksi terhadap event alih-alih melakukan polling, dan saat Meta membatasi sebuah panggilan, Claude, ChatGPT, atau kode Anda sendiri menerima kode dan pesan kesalahan Meta.
Panggilan per impresi yang dapat dilakukan aplikasi untuk satu akun dalam 24 jam bergulir, tidak termasuk pesan.
Balasan privat per akun untuk komentar pada postingan dan Reels; komentar pada Live memperbolehkan 100 per detik.
Panggilan Send API per akun untuk teks, tautan, reaksi, dan stiker; audio atau video memperbolehkan 10.
Postingan yang diterbitkan lewat API per akun dalam periode bergerak 24 jam, diberlakukan saat container diterbitkan.
Kode kesalahan yang diterima aplikasi setelah mencapai pembatasan laju Business Use Case milik Instagram.
Bagaimana Instagram menghitung panggilan API?
Per pasangan aplikasi dan akun, dalam 24 jam bergulir. Endpoint Instagram berada di bawah pembatasan laju Business Use Case dari Meta, dan jumlah panggilan aplikasi untuk satu akun profesional dibatasi 4,800 kali impresi akun tersebut: jumlah kali konten apa pun muncul di layar seseorang dalam 24 jam terakhir. Pesan dihitung terpisah, sedangkan Business Discovery dan Hashtag Search mengikuti pembatasan laju Platform Meta.
Apakah pemakaian satu akun memengaruhi akun lain?
Tidak dengan rumus ini. Meta menyimpan hitungan untuk setiap pasangan aplikasi dan pengguna aplikasi, sehingga aplikasi yang melayani banyak akun profesional memiliki anggaran tersendiri untuk tiap akun, sesuai impresi akun itu sendiri. Akun yang kontennya lebih sering dilihat mendapat lebih banyak panggilan, dan akun baru atau yang sepi mendapat lebih sedikit.
Apa saja batas pesan?
Terpisah dari hitungan 24 jam, dan ditetapkan per akun profesional Instagram dan per API:
- Send API: 100 panggilan per detik untuk teks, tautan, reaksi, dan stiker, serta 10 per detik untuk audio atau video.
- Balasan privat: 750 panggilan per jam untuk komentar pada postingan dan Reels, serta 100 per detik untuk komentar pada Live.
- Conversations API: 2 panggilan per detik.
Di mana batas penerbitan berada?
Di samping anggaran panggilan, sebagai hitungan postingan yang terpisah. Panduan penerbitan Meta mengizinkan 100 postingan yang diterbitkan lewat API per akun dalam periode bergerak 24 jam, diperiksa saat POST /<IG_ID>/media_publish dipanggil, dan panggilan yang melewatinya gagal dengan kode 9, subkode 2207042. Apa yang dapat dimuat sebuah postingan, jumlah container, dan content_publishing_limit termasuk dalam batas penerbitan.
Bagaimana Meta melaporkan pemakaian?
Dalam header respons. Panggilan di bawah batas Business Use Case mengembalikan X-Business-Use-Case-Usage, sebuah string JSON yang diberi kunci ID. Untuk Instagram, tipenya berbunyi instagram; call_count, total_cputime, dan total_time adalah persentase dari kuota yang terpakai, dan panggilan dapat dibatasi begitu waktu CPU atau total waktu mencapai 100. estimated_time_to_regain_access memberi jumlah menit sampai aplikasi yang dibatasi dapat memanggil lagi.
x-business-use-case-usage: {
"<ID>": [
{
"type": "instagram",
"call_count": 28,
"total_cputime": 12,
"total_time": 15,
"estimated_time_to_regain_access": 0
}
]
}Apa yang terjadi saat batas tercapai?
Panggilan gagal sampai hitungan kembali di bawah batas. Untuk batas Business Use Case Instagram, kode kesalahannya adalah 80002, dan Meta memperingatkan bahwa panggilan yang dibuat saat dibatasi tetap menambah hitungan, yang menunda saat panggilan kembali berhasil. Pesan dihitung terpisah dari anggaran ini, di bawah laju per detik dan per jam masing-masing.
Bagaimana agar tetap di bawah batas?
Saran Meta sendiri, diterapkan untuk Instagram:
- Terima komentar, mention, dan pesan lewat webhook, bukan polling; Meta merekomendasikannya untuk memangkas panggilan yang dibutuhkan aplikasi.
- Sebarkan panggilan secara merata, jangan dalam lonjakan.
- Minta hanya field yang dibutuhkan, dan hindari permintaan untuk data yang tumpang tindih.
- Hitung panggilan dalam batch satu per satu: Meta menghitung setiap permintaan di dalamnya sebagai panggilan tersendiri.
- Berhenti saat dibatasi, dan lanjutkan setelah
estimated_time_to_regain_access.
Kesalahan umum
- Mencoba kembali panggilan yang dibatasi dalam loop. Meta menghitung panggilan yang dibuat saat dibatasi, yang menunda saat panggilan kembali berhasil.
- Melakukan polling untuk komentar atau DM baru. Webhook mengirimkannya saat terjadi dan menjaga hitungan panggilan tetap rendah.
- Membaca estimated_time_to_regain_access sebagai detik. Meta memberikannya dalam menit, sehingga klien yang menunggu sebanyak detik itu memanggil lagi saat masih dibatasi.
- Hanya memantau call_count. total_cputime dan total_time juga dihitung untuk pembatasan, jadi pantau ketiga persentase di header.
Setiap akun yang terhubung juga diperiksa setiap 6 jam. Dari US$ 9 hingga US$ 0.75 per koneksi per bulan, turun seiring bertambahnya koneksi, dengan 3 hari pertama gratis.
Pertanyaan yang sering diajukan
Berapa panggilan API yang dapat dilakukan akun Instagram per hari?
4,800 per impresi yang dimiliki kontennya dalam 24 jam terakhir, dihitung per aplikasi dan akun, sehingga akun yang lebih sering dilihat mendapat lebih banyak panggilan.
Apa itu kesalahan API Instagram 80002?
Pembatasan laju Business Use Case milik Instagram: aplikasi telah memakai anggaran panggilannya untuk akun tersebut. Berhenti memanggil dan tunggu waktu yang diberikan header penggunaan.
Apakah DM dihitung dalam rumus 4,800?
Tidak. Pesan dikecualikan dari rumus itu dan memiliki laju per akun tersendiri, misalnya 100 pesan teks per detik melalui Send API.
Apakah balasan privat berbagi laju DM?
Tidak. Meta memberinya laju tersendiri: 750 per jam per akun untuk komentar pada postingan dan Reels, serta 100 per detik untuk komentar pada Live, terpisah dari laju Send API untuk DM.
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