Zaloguj sięRozpocznij bezpłatny okres próbny
easyCoexistence Oficjalne API

Limity wywołań API Instagrama: wywołania na 24 godziny i przepustowość DM

Interfejs API Instagrama przydziela każdej aplikacji budżet wywołań dla każdego obsługiwanego konta: 4,800 wywołań pomnożonych przez liczbę wyświetleń konta w ruchomym oknie 24 godzin. Wiadomości mają osobne limity dla każdego konta: 100 wiadomości tekstowych na sekundę przez Send API, 10 dla audio lub wideo oraz 750 prywatnych odpowiedzi na godzinę. Po przekroczeniu budżetu wywołania kończą się błędem 80002, a nagłówek X-Business-Use-Case-Usage pokazuje, ile budżetu wykorzystano.

easyCoexistence może przekazywać komentarze, wzmianki i DM każdego konta Instagram na Twój endpoint w chwili ich nadejścia, dzięki czemu agent reaguje na zdarzenia zamiast je odpytywać.

4,800

Wywołania na wyświetlenie, jakie aplikacja może wykonać dla jednego konta w ruchomym oknie 24 godzin, bez wiadomości.

750/hour

Prywatne odpowiedzi na konto na komentarze pod postami i Reelsami; komentarze pod Live: 100 na sekundę.

100/sec

Wywołania Send API na konto dla tekstu, linków, reakcji i naklejek; dla audio lub wideo: 10.

100 posts

Posty publikowane przez API na konto w ruchomym 24-godzinnym okresie, egzekwowane przy publikacji kontenera.

80002

Kod błędu, jaki aplikacja otrzymuje po osiągnięciu limitu Business Use Case Instagrama.

Jak Instagram liczy wywołania API?

Dla każdej pary aplikacja – konto, w ruchomym oknie 24 godzin. Endpointy Instagrama podlegają limitom Business Use Case Mety, a liczba wywołań aplikacji dla jednego konta profesjonalnego jest ograniczona do 4,800 razy wyświetlenia tego konta, czyli liczby razy, gdy którakolwiek jego treść pojawiła się na czyimś ekranie w ciągu ostatnich 24 godzin. Wiadomości liczone są osobno, a Business Discovery i Hashtag Search podlegają zamiast tego limitom platformy Meta.

Czy wykorzystanie jednego konta wpływa na inne?

Nie w tym wzorze. Meta prowadzi licznik osobno dla każdej pary aplikacja – użytkownik aplikacji, więc aplikacja obsługująca wiele kont profesjonalnych ma osobny budżet dla każdego z nich, wyznaczony przez wyświetlenia tego konta. Konto, którego treści są oglądane częściej, dostaje więcej wywołań, a nowe lub mało aktywne konto dostaje ich mniej.

Jakie są limity wiadomości?

Niezależne od 24-godzinnego licznika i ustalane dla każdego profesjonalnego konta Instagram oraz dla każdego API:

  • Send API: 100 wywołań na sekundę dla tekstu, linków, reakcji i naklejek oraz 10 na sekundę dla audio lub wideo.
  • Prywatne odpowiedzi: 750 wywołań na godzinę dla komentarzy pod postami i Reelsami oraz 100 na sekundę dla komentarzy pod Live.
  • Conversations API: 2 wywołania na sekundę.

Gdzie mieści się limit publikacji?

Obok budżetu wywołań, jako osobny licznik postów. Przewodnik Mety po publikowaniu dopuszcza 100 postów publikowanych przez API na konto w ruchomym 24-godzinnym okresie, sprawdzanych przy wywołaniu POST /<IG_ID>/media_publish. Wywołanie ponad ten limit kończy się kodem 9, podkodem 2207042. To, co może zawierać post, liczba kontenerów i content_publishing_limit należą do limitów publikowania.

Jak Meta raportuje wykorzystanie?

W nagłówku odpowiedzi. Wywołania objęte limitami Business Use Case zwracają X-Business-Use-Case-Usage, czyli ciąg JSON kluczowany identyfikatorem. Dla Instagrama jego typ ma wartość instagram. call_count, total_cputime i total_time są procentami wykorzystanego limitu, a wywołania mogą być ograniczane, gdy czas CPU lub czas całkowity osiągnie 100. estimated_time_to_regain_access podaje w minutach, po jakim czasie ograniczona aplikacja może znów wykonywać wywołania.

The usage header on an Instagram call
x-business-use-case-usage: {
  "<ID>": [
    {
      "type": "instagram",
      "call_count": 28,
      "total_cputime": 12,
      "total_time": 15,
      "estimated_time_to_regain_access": 0
    }
  ]
}

Co się dzieje po przekroczeniu limitu?

Wywołania kończą się błędem, dopóki licznik nie spadnie poniżej limitu. Dla limitu Business Use Case Instagrama kodem błędu jest 80002. Meta ostrzega, że wywołania wykonane podczas ograniczenia nadal zwiększają licznik, co opóźnia moment, w którym wywołania znów się powiodą. Wiadomości liczone są od tego budżetu osobno, w ramach własnych limitów na sekundę i na godzinę.

Jak pozostać poniżej limitów?

Własne zalecenia Mety, odniesione do Instagrama:

  • Odbieraj komentarze, wzmianki i wiadomości przez webhooki, a nie przez odpytywanie; Meta zaleca je, by ograniczyć liczbę wywołań, których potrzebuje aplikacja.
  • Rozkładaj wywołania równomiernie zamiast wysyłać je seriami.
  • Żądaj tylko potrzebnych pól i unikaj żądań nakładających się na te same dane.
  • Licz wywołania w wsadzie pojedynczo: Meta traktuje każde żądanie w nim jako odrębne wywołanie.
  • Zatrzymaj się po ograniczeniu i wznów po upływie czasu z estimated_time_to_regain_access.

Typowe błędy

  • Ponawianie ograniczonego wywołania w pętli. Meta liczy wywołania wykonane podczas ograniczenia, co opóźnia moment, w którym wywołania znów się powiodą.
  • Odpytywanie o nowe komentarze lub DM. Webhooki dostarczają je w chwili, gdy się pojawiają, i utrzymują niską liczbę wywołań.
  • Odczytywanie estimated_time_to_regain_access jako sekund. Meta podaje je w minutach, więc klient czekający tyle sekund wykona wywołanie, nadal będąc ograniczonym.
  • Patrzenie wyłącznie na call_count. total_cputime i total_time również wliczają się do ograniczania, więc śledź wszystkie trzy procenty z nagłówka.
Z EasyCoexistence zrobisz to

Gdy Meta ogranicza wywołanie, Claude, ChatGPT lub Twój własny kod otrzymują z powrotem kod błędu i komunikat Mety. Sprawdza też każde połączone konto co 6 godzin. Od US$ 9 do US$ 0.75 za połączenie miesięcznie, spadając wraz z liczbą połączeń, z pierwszymi 3 dniami bezpłatnymi.

Najczęściej zadawane pytania

Ile wywołań API może wykonać konto Instagram dziennie?

4,800 wywołań na każde wyświetlenie treści konta w ciągu ostatnich 24 godzin, liczone dla pary aplikacja – konto, więc konto oglądane częściej dostaje więcej wywołań.

Czym jest błąd 80002 API Instagrama?

Limitem Business Use Case Instagrama: aplikacja wyczerpała budżet wywołań dla tego konta. Przestań wywoływać i poczekaj czas podany w nagłówku wykorzystania.

Czy DM liczą się do wzoru 4,800?

Nie. Wiadomości są z niego wyłączone i mają własne limity dla każdego konta, na przykład 100 wiadomości tekstowych na sekundę przez Send API.

Czy prywatne odpowiedzi dzielą limit DM?

Nie. Meta przyznaje im własne limity: 750 na godzinę dla konta przy komentarzach pod postami i Reelsami oraz 100 na sekundę przy komentarzach pod Live, niezależnie od limitów Send API dla DM.

Czytaj dalej

Połącz pierwszy kanał w dwie minuty.

Bez czekania na weryfikację przez platformy. Połącz WhatsApp, Instagram, TikTok lub inny kanał, a potem poproś swoją AI o opublikowanie posta, odpowiedź lub raport i zobacz, jak działa.

  • 3 dni za darmo
  • Rezygnacja w każdej chwili
  • Tylko oficjalne API
  • Monitorowanie 24/7

Zweryfikowano w