Słownik

Limit zapytań API Instagrama to 4800 razy liczba wyświetleń

Taras Shynkarenko
Taras Shynkarenko
•Zaktualizowano: •8 min czytania
Wzór na limit zapytań API Instagrama: 4800 razy liczba wyświetleńWzór na limit zapytań API Instagrama: 4800 razy liczba wyświetleń

TL;DR, szybka odpowiedź

8 min czytania

Meta 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.

Osoba czyta powiadomienie na telefonie, co symbolizuje sprawdzanie nagłówków użycia API po wywołaniu.

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.

PoleCo według Meta zawiera
business-idID firmy powiązanej z tokenem wykonującym wywołania API
call_countLiczba całkowita oznaczająca procent dozwolonych wywołań wykonanych przez aplikację
total_cputimeLiczba całkowita oznaczająca procent czasu CPU przydzielonego na przetwarzanie zapytań
total_timeLiczba całkowita oznaczająca procent całkowitego czasu przydzielonego na przetwarzanie zapytań
estimated_time_to_regain_accessCzas w minutach do chwili, gdy wywołania przestaną być ograniczane
typeTyp 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
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.

Zegar ścienny w biurze odmierza czas, co symbolizuje czekanie na koniec limitu przed ponowną próbą.

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.

Dwie reakcje na błąd 80002
Zatrzymaj kolejkę
  • call_count przestaje rosnąć
  • estimated_time_to_regain_access odlicza w dół
  • po upływie czasu wywołania znów działają
Ponawiaj dalej
  • 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
Meta ostrzega, że dalsze wywołania po błędzie 80002 wydłużają oczekiwanie, zamiast je skracać.

Które punkty końcowe Instagrama są poza tym limitem?

Dwie grupy, które Meta wymienia wprost.

ObszarObowiązujący limit
Publikacja, media, statystyki, komentarze4800 * Number of Impressions na 24 godziny
Business Discovery, Hashtag SearchPlatform Rate Limits, a nie Business Use Case
Conversations API2 wywołania na sekundę na konto profesjonalne
Send API, tekst i linki100 wywołań na sekundę na konto profesjonalne
Send API, audio lub wideo10 wywołań na sekundę na konto profesjonalne
Private Replies, komentarze na żywo100 wywołań na sekundę na konto profesjonalne
Private Replies, posty i Reels750 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
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ń.

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

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

Powiązane artykuły