Instagram API hız sınırları: 24 saatte çağrı sayısı ve DM aktarım hızı
Instagram'ın API'si, hizmet verdiği her hesap için uygulamaya bir çağrı bütçesi tanır: hesabın gösterimlerinin 4.800 katı, son 24 saat içinde. Mesajlaşmanın hesap başına ayrı hızları vardır: Send API üzerinden saniyede 100 metin mesajı, ses veya video için 10 ve saatte 750 özel yanıt. Bütçe aşıldığında çağrılar 80002 hatasıyla başarısız olur ve X-Business-Use-Case-Usage başlığı ne kadarının kullanıldığını gösterir.
easyCoexistence, her Instagram hesabının yorumlarını, anmalarını ve DM'lerini geldikleri anda uç noktanıza iletebilir; böylece bir ajan yoklama yapmak yerine olaylara tepki verir.
Bir uygulamanın tek bir hesap için son 24 saatte yapabileceği, gösterim başına çağrı sayısı; mesajlaşma hariç.
Gönderi ve Reel yorumlarına hesap başına özel yanıt sayısı; Canlı yayın yorumlarında saniyede 100.
Metin, bağlantı, tepki ve çıkartmalar için hesap başına Send API çağrısı; ses veya video için 10.
API ile yayınlanan gönderi sayısı, 24 saatlik kayan dönemde hesap başına; kapsayıcı yayınlandığında uygulanır.
Bir uygulama Instagram'ın Business Use Case hız sınırına ulaştığında aldığı hata kodu.
Instagram API çağrılarını nasıl sayar?
Uygulama ve hesap çifti başına, son 24 saat üzerinden. Instagram uç noktaları Meta'nın Business Use Case hız sınırları kapsamına girer; bir uygulamanın tek bir profesyonel hesap için çağrı sayısı, o hesabın gösterimlerinin 4.800 katıyla sınırlıdır. Gösterim, son 24 saatte içeriklerinden herhangi birinin bir kişinin ekranına girme sayısıdır. Mesajlaşma ayrı sayılır; Business Discovery ve Hashtag Search ise bunun yerine Meta'nın Platform hız sınırlarına tabidir.
Bir hesabın kullanımı diğerini etkiler mi?
Bu formül kapsamında hayır. Meta sayacı her uygulama ve uygulama kullanıcısı çifti için tutar; yani çok sayıda profesyonel hesaba hizmet veren bir uygulamanın her biri için, o hesabın kendi gösterimlerine göre belirlenen ayrı bir bütçesi olur. İçeriği daha sık görülen bir hesap daha fazla çağrı alır; yeni veya az etkileşimli bir hesap ise daha az.
Mesajlaşma sınırları nelerdir?
24 saatlik sayımdan ayrı olarak, Instagram profesyonel hesabı ve API başına belirlenir:
- Send API: metin, bağlantı, tepki ve çıkartmalar için saniyede 100 çağrı; ses veya video için saniyede 10.
- Özel yanıtlar: gönderi ve Reel yorumları için saatte 750 çağrı; Canlı yayın yorumları için saniyede 100.
- Conversations API: saniyede 2 çağrı.
Yayınlama sınırı nerede yer alır?
Çağrı bütçesinin yanında, ayrı bir gönderi sayacı olarak. Meta'nın yayınlama kılavuzu, son 24 saatlik kayan dönemde hesap başına API ile yayınlanan 100 gönderiye izin verir; bu, POST /<IG_ID>/media_publish çağrıldığında denetlenir ve sınırı aşan çağrı 9 kodu ve 2207042 alt koduyla başarısız olur. Bir gönderinin içerebileceği şeyler, kapsayıcı sayısı ve content_publishing_limit ise yayınlama sınırlarına aittir.
Meta kullanımı nasıl bildirir?
Bir yanıt başlığında. Business Use Case sınırları kapsamındaki çağrılar, bir kimlikle anahtarlanmış bir JSON metni olan X-Business-Use-Case-Usage döndürür. Instagram için türü instagram değerini taşır; call_count, total_cputime ve total_time, kullanılan kotanın yüzdeleridir ve CPU süresi veya toplam süre 100'e ulaştığında çağrılar kısıtlanabilir. estimated_time_to_regain_access, kısıtlanan bir uygulamanın yeniden çağrı yapabileceği dakika cinsinden süreyi verir.
x-business-use-case-usage: {
"<ID>": [
{
"type": "instagram",
"call_count": 28,
"total_cputime": 12,
"total_time": 15,
"estimated_time_to_regain_access": 0
}
]
}Sınıra ulaşılınca ne olur?
Sayaç yeniden sınırın altına düşene kadar çağrılar başarısız olur. Instagram'ın Business Use Case sınırı için hata kodu 80002'dir; Meta, kısıtlanmışken yapılan çağrıların da sayıya eklendiğini ve bu yüzden çağrıların yeniden başarılı olacağı anı geri ittiğini uyarır. Mesajlaşma bu bütçeden ayrı, kendi saniyelik ve saatlik hızlarıyla sayılır.
Limitlerin altında nasıl kalırsınız?
Meta'nın kendi tavsiyesi, Instagram için uygulanmış hali:
- Yorumları, anmaları ve mesajları yoklama yerine webhook'lar üzerinden alın; Meta, bir uygulamanın ihtiyaç duyduğu çağrıları azaltmak için bunları önerir.
- Çağrıları patlamalar halinde değil, eşit aralıklarla gönderin.
- Yalnızca ihtiyaç duyduğunuz alanları isteyin ve örtüşen verileri içeren isteklerden kaçının.
- Bir toplu istekteki çağrıları tek tek sayın: Meta, içindeki her isteği ayrı bir çağrı olarak sayar.
- Kısıtlandığınızda durun ve
estimated_time_to_regain_accesssüresinden sonra devam edin.
Yaygın hatalar
- Kısıtlanmış bir çağrıyı döngü içinde yeniden denemek. Meta, kısıtlanmışken yapılan çağrıları sayar; bu da çağrıların yeniden başarılı olacağı anı geciktirir.
- Yeni yorum veya DM için yoklama yapmak. Webhook'lar bunları gerçekleştikleri anda iletir ve çağrı sayısını düşük tutar.
- estimated_time_to_regain_access değerini saniye sanmak. Meta bu değeri dakika cinsinden verir; bu süre kadar saniye bekleyen bir istemci, hâlâ kısıtlıyken yeniden çağrı yapar.
- Yalnızca call_count değerine bakmak. total_cputime ve total_time de kısıtlamaya dahildir; bu yüzden başlıktaki üç yüzdeyi de izleyin.
Meta bir çağrıyı kısıtladığında ise Claude, ChatGPT veya kendi kodunuz Meta'nın hata kodunu ve mesajını geri alır. Ayrıca bağlı her hesabı 6 saatte bir kontrol eder. Bağlantı başına aylık US$ 9 ile US$ 0.75 arası, bağlantı ekledikçe düşer; ilk 3 gün ücretsiz.
Sık sorulan sorular
Bir Instagram hesabı günde kaç API çağrısı yapabilir?
Son 24 saatte içeriğinin her gösterimi için 4.800 çağrı; uygulama ve hesap başına sayılır, bu yüzden daha sık görülen bir hesap daha fazla çağrı alır.
Instagram API hatası 80002 nedir?
Instagram'ın Business Use Case hız sınırıdır: uygulama o hesap için çağrı bütçesini kullanmıştır. Çağrı yapmayı durdurun ve kullanım başlığının verdiği süreyi bekleyin.
DM'ler 4.800 formülüne dahil mi?
Hayır. Mesajlaşma bu formülün dışındadır ve kendi hesap başına hızlarına sahiptir; örneğin Send API üzerinden saniyede 100 metin mesajı.
Özel yanıtlar DM hızını paylaşır mı?
Hayır. Meta bunlara ayrı bir hız tanımlar: gönderi ve Reel yorumları için hesap başına saatte 750, Canlı yayın yorumları için saniyede 100; bunlar DM'ler için Send API hızlarından ayrıdır.
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