TL;DR, szybka odpowiedź
8 min czytaniaMeta publikuje dla punktów końcowych Instagram Platform jeden wzór, "Calls within 24 hours = 4800 * Number of Impressions", gdzie wyświetlenia to liczba razy, gdy treści z konta pojawiły się na czyimś ekranie w ciągu ostatnich 24 godzin. Użycie wraca w nagłówku X-Business-Use-Case-Usage jako call_count, total_cputime i total_time, wszystkie w procentach limitu. Przy wartości 100 API zwraca kod błędu 80002, a estimated_time_to_regain_access podaje czas oczekiwania w minutach.
Jaki jest limit zapytań API Instagrama?
Limit zapytań API Instagrama określa jeden wzór, który Meta podaje w jednej linii zarówno w dokumentacji limitów Graph API, jak i w omówieniu Instagram Platform: Calls within 24 hours = 4800 * Number of Impressions.
Zdanie wokół niego jest równie ważne jak sam wzór. Meta pisze: "Calls to the Instagram Platform endpoints, excluding messaging, are counted against the calling app's call count. An app's call count is unique for each app and app user pair, and is the number of calls the app has made in a rolling 24 hour window."
Kryją się w nim trzy ograniczenia. Licznik należy do aplikacji, a nie do konta. Dotyczy pary aplikacja i użytkownik aplikacji, więc aktywny klient nie może zagłodzić spokojniejszego. Okno jest kroczące, więc nic nie resetuje się o północy. Wywołania wypadają z licznika pojedynczo, 24 godziny po wykonaniu.
Instagram Platform należy do kategorii Business Use Case, a nie starszej kategorii Platform Rate Limits. Żądania Marketing API i Instagrama podlegają limitom Business Use Case, a zwykłe żądania Graph API limitom Platform. Gdy mogłyby obowiązywać oba, Meta rozstrzyga to jednym zdaniem: "If both Platform and Business Use Case rate limits can be applied to a request, BUC rate limits will be applied."
Do czego odnosi się mnożnik 4800?
Do wyświetleń, a Meta definiuje to słowo wąsko: "The Number of Impressions is the number of times any content from the app user's Instagram professional account has entered a person's screen within the last 24 hours."
Czytaj to jako liczbę pojawień na ekranie, a nie liczbę obserwujących, postów czy zasięg. Liczą się wystąpienia, więc osoba przewijająca cztery twoje posty daje cztery wyświetlenia. Obejmuje to "any content" z konta, więc stare posty przyciągające ruch liczą się tak samo jak dzisiejsze. Pomiar dotyczy tego samego kroczącego okresu 24 godzin co finansowane nim wywołania, dlatego limit zmienia się płynnie, a nie skokowo.
W efekcie budżet rośnie wraz z uwagą odbiorców. Konto, którego posty pojawiły się na ekranach 50 000 razy w ciągu ostatniej doby, ma do dyspozycji 240 000 000 wywołań, czyli liczbę nieosiągalną dla żadnego procesu publikacji. Wzór daje się we znaki tylko na samym dole skali, bo Meta nie publikuje dolnej granicy: 4800 razy zero wyświetleń to zero wywołań, a dokumentacja limitów nigdzie nie podaje minimalnego przydziału dla konta, którego nikt nie widział.
Ta sama struktura występuje w innych miejscach tabeli Meta. Wywołania Pages API z tokenem strony lub użytkownika systemowego korzystają ze wzoru Calls within 24 hours = 4800 * Number of Engaged Users, a LeadGen z Calls within 24 hours = 4800 * Leads Generated. Mnożnik 4800 to firmowa liczba Meta dla 24-godzinnego Business Use Case, a zmienia się tylko to, co jest mnożone.

Jak czytać nagłówek X-Business-Use-Case-Usage?
Meta zwraca użycie w nagłówku odpowiedzi, a nie w jej treści: "All API responses made by your app that are rate limited using the BUC logic include an X-Business-Use-Case-Usage HTTP header with a JSON-formatted string that describes current application rate limit usage. This header can return up to 32 objects in one call."
Wartość nagłówka to obiekt JSON z kluczami w postaci ID firmy, a każdy wpis zawiera następujące pola.
| Pole | Co według Meta zawiera |
|---|---|
business-id | ID firmy powiązanej z tokenem wykonującym wywołania API |
call_count | Liczba całkowita oznaczająca procent dozwolonych wywołań wykonanych przez aplikację |
total_cputime | Liczba całkowita oznaczająca procent czasu CPU przydzielonego na przetwarzanie zapytań |
total_time | Liczba całkowita oznaczająca procent całkowitego czasu przydzielonego na przetwarzanie zapytań |
estimated_time_to_regain_access | Czas w minutach do chwili, gdy wywołania przestaną być ograniczane |
type | Typ zastosowanego limitu, jeden z ads_insights, ads_management, custom_audience, instagram, leadgen, messenger lub pages |
Przy pracy z Instagramem dopasowuj pole type do wartości instagram. Aplikacja korzystająca też ze stron lub reklam dostaje w tym samym nagłówku kilka obiektów, a odczyt niewłaściwego powie ci o niewłaściwym budżecie.
Wszystkie trzy wartości użycia to procenty, a nie liczby wywołań. call_count równe 62 oznacza, że wykorzystano 62 procent limitu, a Meta nigdy nie podaje mianownika, bo jest nim stale przeliczana liczba wyświetleń. Żaden punkt końcowy nie zwraca aktualnego limitu wywołań jako liczby całkowitej.
Nagłówek nie pojawia się też w każdej odpowiedzi. Meta pisze, że statystyki użycia w czasie rzeczywistym są "included with most API responses once enough calls have been made to an endpoint". Brak nagłówka traktuj jako brak informacji, a nie zerowe użycie.
Dlaczego nagłówek mówi o godzinie, a wzór o 24 godzinach?
Bo dwie części dokumentacji Meta sobie przeczą, i ta sprzeczność widnieje w tym samym dokumencie. Sekcja o Instagramie podaje "rolling 24 hour window". Tabela nagłówków, kilka ekranów niżej, definiuje call_count jako "A whole number expressing the percentage of allowed calls made by your app over a rolling one hour period."
AdaptlyPost
Rozpocznij 7-dniowy bezpłatny okres próbny
Analityka wszystkich platform
Skrzynka społecznościowa
Asystent oparty na AI
Oba zdania opisują to samo pole tego samego nagłówka w tym samym API. Jedno z nich jest błędne dla Instagrama. Sformułowanie o godzinie pasuje do wyższej sekcji Platform Rate Limits, gdzie wywołania na poziomie aplikacji faktycznie mierzone są co godzinę, i to najbardziej prawdopodobne źródło rozbieżności.
Dokumentacja tego nie rozstrzyga, więc planuj pod dłuższe okno. Jeśli założysz, że licznik czyści się po godzinie, a naprawdę trwa to 24 godziny, będziesz ponawiać żądania w ścianę. Jeśli założysz 24 godziny, a czyści się po jednej, po prostu poczekasz dłużej, niż trzeba. Tylko pierwszy z tych błędów psuje harmonogram publikacji.
Druga opublikowana luka znajduje się w tabelach błędów. Lista błędów Business Use Case Meta wymienia error code 80002 dla typu Instagram, bez podkodu. Dokumentacja kodów błędów Instagram Platform, czyli strona, którą faktycznie czytasz przy debugowaniu publikacji, nigdzie nie wymienia 80002. Musisz zmapować go samodzielnie.

Co się dzieje, gdy call_count osiągnie 100?
Żądania kończą się błędem z osobnym kodem. Meta pisze: "When your app reaches its Business Use Case rate limit, subsequent requests made by your app will fail and the API will respond with an error code." Dla typu Instagram jest to kod 80002.
Czas CPU i czas rzeczywisty są ograniczane niezależnie od liczby wywołań. Meta powtarza te same dwie linie przy każdym Business Use Case: "When total_cputime reaches 100, calls may be throttled" oraz "When total_time reaches 100, calls may be throttled." Wystarczy, że którakolwiek z trzech wartości osiągnie 100. Niewielka liczba ciężkich zapytań może wyczerpać total_cputime, gdy call_count jest jeszcze jednocyfrowe.
Po nałożeniu ograniczenia estimated_time_to_regain_access podaje czas oczekiwania w minutach, a najważniejsza jest dalsza instrukcja: "When the limit has been reached, stop making API calls. Continuing to make calls will continue to increase your call count, which will increase the time before calls will be successful again."
Ponawianie wydłuża blokadę. To na tyle nietypowe, że warto to uwzględnić w projekcie, bo standardowy wykładniczy backoff nadal wysyła żądania, a każde z nich przedłuża karę. Właściwą reakcją na 80002 jest wstrzymanie kolejki, dopóki nagłówek nie pokaże czegoś innego. Ta sama dyscyplina opłaca się przy dziennym limicie publikacji, który jest osobnym pułapem z własnym błędem.
Pozostałe rady Meta dotyczą rozkładania ruchu, a nie jego wielkości: "Spread out queries evenly to avoid traffic spikes" oraz "Use filters to limit the data response size and avoid calls that request overlapping data." Jest też zasada liczenia, która zaskakuje osoby grupujące identyfikatory. Meta podaje, że "each ID counts as one API call", i pokazuje to na przykładzie: trzy osobne żądania z jednym ID to trzy wywołania, a jedno żądanie z ids=4,5,6 również liczy się jako trzy.
- call_count przestaje rosnąć
- estimated_time_to_regain_access odlicza w dół
- po upływie czasu wywołania znów działają
- każda próba dalej podnosi call_count
- estimated_time_to_regain_access rośnie
- czas do powrotu działania wywołań się wydłuża
Które punkty końcowe Instagrama są poza tym limitem?
Dwie grupy, które Meta wymienia wprost.
| Obszar | Obowiązujący limit |
|---|---|
| Publikacja, media, statystyki, komentarze | 4800 * Number of Impressions na 24 godziny |
| Business Discovery, Hashtag Search | Platform Rate Limits, a nie Business Use Case |
| Conversations API | 2 wywołania na sekundę na konto profesjonalne |
| Send API, tekst i linki | 100 wywołań na sekundę na konto profesjonalne |
| Send API, audio lub wideo | 10 wywołań na sekundę na konto profesjonalne |
| Private Replies, komentarze na żywo | 100 wywołań na sekundę na konto profesjonalne |
| Private Replies, posty i Reels | 750 wywołań na godzinę na konto profesjonalne |
Wiadomości są całkowicie wyłączone ze wzoru opartego na wyświetleniach i mają limity na sekundę i na godzinę. Business Discovery i Hashtag Search podlegają Platform Rate Limits, gdzie wzór na poziomie aplikacji to Calls within one hour = 200 * Number of Users.
Limit zapytań to też nie limit publikacji. To osobne systemy z osobnymi błędami, a ich mylenie marnuje czas na debugowanie: publikacja zablokowana przez liczbę wywołań zwraca 80002, a zablokowana przez limit publikowania treści zwraca kod 9, podkod 2207042. Inne sieci dzielą to podobnie, czy to limity żądań Bluesky publikowane dla każdego punktu końcowego, czy dzienny budżet jednostek YouTube, o którego zwiększenie można wnioskować.
Najczęściej zadawane pytania
Jaki jest wzór na limit zapytań API Instagrama?
Calls within 24 hours = 4800 * Number of Impressions. Meta publikuje go w dokumentacji limitów Graph API i powtarza w omówieniu Instagram Platform.
Co liczy się jako wyświetlenie w limicie zapytań Instagrama?
Meta definiuje to jako "the number of times any content from the app user's Instagram professional account has entered a person's screen within the last 24 hours." Liczą się pojawienia dowolnych treści, a nie obserwujący ani posty.
Który kod błędu oznacza przekroczenie limitu zapytań API Instagrama?
Kod błędu 80002. Meta przypisuje go do typu Instagram w Business Use Case, bez podkodu, i nie powtarza w dokumentacji kodów błędów Instagram Platform.
AdaptlyPost
Rozpocznij 7-dniowy bezpłatny okres próbny
Analityka wszystkich platform
Skrzynka społecznościowa
Asystent oparty na AI
Jak sprawdzić bieżące wykorzystanie limitu API Instagrama?
Odczytaj nagłówek odpowiedzi X-Business-Use-Case-Usage, znajdź obiekt, w którym type ma wartość instagram, i sprawdź call_count, total_cputime oraz total_time. Wszystkie trzy są procentami limitu.
Czy ponawianie po błędzie limitu pogarsza sytuację?
Tak. Meta pisze, że dalsze wywołania "will continue to increase your call count, which will increase the time before calls will be successful again." Zatrzymaj kolejkę i odczytaj estimated_time_to_regain_access.
Czy punkty końcowe wiadomości na Instagramie podlegają wzorowi 4800?
Nie. Meta wyłącza wiadomości ze wzoru opartego na wyświetleniach i publikuje limity na sekundę i na godzinę dla Conversations API, Send API i Private Replies.
Czy limit zapytań API Instagrama resetuje się o stałej porze?
Nie resetuje się ani o północy, ani o żadnej innej stałej godzinie. Meta liczy wywołania w kroczącym oknie 24 godzin, więc każde wypada z licznika dokładnie 24 godziny po wykonaniu. Limit jest stale w ruchu, zamiast wracać do zera według harmonogramu.
Czy licznik wywołań API Instagrama jest wspólny dla wszystkich aplikacji połączonych z kontem?
Każda aplikacja ma własny licznik. Meta przypisuje go do pary aplikacja i użytkownik aplikacji, więc aktywna aplikacja nie zużyje limitu należącego do innej aplikacji korzystającej z tego samego konta.
Czym limit zapytań API Instagrama różni się od dziennego limitu publikacji?
To osobne systemy z osobnymi błędami. Opisany tu limit blokuje kodem błędu 80002, gdy call_count, total_cputime lub total_time osiągnie 100. Dzienny limit publikacji to zupełnie inny pułap, który kończy się kodem 9, podkod 2207042, więc blokada jednego nigdy nie wyjaśnia blokady drugiego.
Czy wywołania Business Discovery i Hashtag Search liczą się do wzoru 4800?
Nie, są poza nim. Oba punkty końcowe działają w starszej kategorii Platform Rate Limits zamiast Business Use Case, gdzie obowiązuje wzór 200 razy liczba użytkowników na godzinę, a nie 4800 razy liczba wyświetleń.
Wykorzystaj to w praktyce z AdaptlyPost
Czy ten artykuł był pomocny?
Chętnie poznamy opinię!
Więcej naszych treści w Google
Jedno kliknięcie oznacza AdaptlyPost jako preferowane źródło, dzięki czemu nasze artykuły pojawiają się wyżej w Najważniejszych wiadomościach, trybie AI i Podsumowaniach AI.
Jeszcze chwila...
AdaptlyPost
Planowanie treści na wszystkich platformach
Wszystkie konta społecznościowe w jednym miejscu dzięki AdaptlyPost.
Analityka wszystkich platform
Skrzynka społecznościowa
Asystent oparty na AI
Powiązane hasła ze słownika


Jak limit business use case Mety rozlicza Strony na Facebooku
Limit business use case Mety dla Stron daje 4 800 wywołań na zaangażowanego użytkownika co 24 godziny przy tokenach Strony i użytkownika systemowego, a po przekroczeniu zwraca kod 80001.


Wymagania API Instagrama dla obrazów egzekwowane przez Meta przy przesyłaniu
Wymagania API Instagrama dla obrazów to tylko JPEG, maksymalnie 8 MB i proporcje od 4:5 do 1.91:1, a każde z nich ma własny kod błędu.


Co naprawdę daje zakres instagram_business_content_publish
Zakres instagram_business_content_publish pozwala aplikacji tworzyć organiczne posty na Instagramie i przy każdym wywołaniu zależy od instagram_business_basic.
Powiązane artykuły


Sesja wznawianego przesyłania na Instagramie i host rupload
Wznawiane przesyłanie na Instagramie zaczyna się od upload_type=resumable w /media, po czym następuje POST na rupload.facebook.com z nagłówkami offset i file_size.


Nagłówek x-app-usage od Meta to trzy procenty i żadnego zegara
Nagłówek x-app-usage od Meta podaje call_count, total_time i total_cputime jako procent godzinnego limitu Graph API aplikacji, bez czasu resetu.


Dlaczego dzienny limit postów na Instagramie to w dokumentacji Mety 100 i 50
Instagram nie podaje dziennego limitu postów dla aplikacji. Dokumentacja API Mety mówi raz o 100 postach na 24 godziny, a dwa razy o 50. Sprawdź, co obowiązuje.

