TL;DR, szybka odpowiedź
7 min czytaniaGET /<IG_USER_ID>/content_publishing_limit pokazuje, ile kontenerów konto profesjonalne na Instagramie opublikowało w kroczącym oknie 24 godzin. Domyślnie zwraca quota_usage, a config zawiera quota_total, które dokumentacja Meta określa na 50, oraz quota_duration, określone na 86400 sekund. Przewodnik po publikowaniu treści w tym samym serwisie podaje 100. Tworzenie kontenerów się nie liczy, liczy się ich publikacja.
Co zwraca endpoint content_publishing_limit?
Endpoint content_publishing_limit od Meta zwraca liczbę kontenerów, które konto profesjonalne na Instagramie opublikowało już w kroczącym oknie 24 godzin, wraz z limitem, względem którego ta liczba jest mierzona. To endpoint tylko do odczytu. Dokumentacja mówi to wprost: "Creating: This operation is not supported", a tak samo opisuje aktualizowanie i usuwanie.
Postać żądania, skopiowana z dokumentacji Meta:
GET https://graph.facebook.com/<API_VERSION>/<IG_USER_ID>/content_publishing_limit
?fields=<LIST_OF_FIELDS>
&since=<UNIX_TIMESTAMP>
&access_token=<ACCESS_TOKEN>Aplikacje oparte na Instagram API with Instagram Login wysyłają to samo wywołanie na graph.instagram.com. Odpowiedź to tablica data z jednym obiektem:
{
"data": [
{
"quota_usage": 2,
"config": {
"quota_total": 50,
"quota_duration": 86400
}
}
]
}Co oznaczają quota_usage, quota_total i quota_duration?
Całą odpowiedź tworzą trzy pola, a Meta definiuje każde z nich jednym zdaniem.
| Pole | Definicja Meta | Wartość w dokumentacji |
|---|---|---|
quota_usage | "The number of times the app user has published an IG Container since the time specified in the since query string parameter." | Zwracane domyślnie |
config.quota_total | "The maximum number of IG Containers the app user can publish within the quota_duration time period" | "currently 50" |
config.quota_duration | "The period of time in seconds against which the quota_total is calculated" | "currently 86400 seconds, or 24 hours" |
quota_usage dostajesz bez proszenia. Uwaga Meta przy parametrze fields brzmi: "A comma-separated list of fields you want returned. If omitted, the quota_usage field will be returned by default." Jeśli nie poprosisz wprost o config, zobaczysz tylko licznik, bez limitu.
Parametr since zawęża okno. Meta opisuje go jako "A Unix timestamp no older than 24 hours" i dodaje, że "If the since parameter is omitted, this value will be the number of times the app user has published a container within the last 24 hours." Nie możesz sięgnąć dalej niż dobę wstecz, co oznacza, że endpoint nie pamięta niczego poza limitem, który egzekwuje.
W przykładowym żądaniu samej Meta jest pewna osobliwość. Odpytuje ono fields=quota_usage,rate_limit_settings, a pole rate_limit_settings nie pojawia się ani w tabeli pól na tej stronie, ani nigdzie indziej w dokumentacji Instagram Platform. Przykład prosi o pole, którego dokumentacja nigdy nie definiuje.

Limit to 50 czy 100 postów?
Meta podaje obie liczby na aktualnych stronach i nigdy ich nie uzgadnia. Przewodnik po publikowaniu treści stwierdza: "Instagram accounts are limited to 100 API-published posts within a 24-hour moving period." Dokumentacja content_publishing_limit podaje, że quota_total wynosi "currently 50." Sekcja o karuzelach w tym samym przewodniku mówi: "Accounts are limited to 50 published posts within a 24-hour period."
Przewodnik przeczy więc sam sobie, a dokumentacja staje po stronie niższej liczby. Nie jest to zapomniana, nieaktualna strona, lecz dokumentacja endpointu dotycząca dokładnie tego pola, które raportuje limit. Rozbieżność między zdaniem o 100 postach a zdaniem o 50 postach jest na tyle stara, że przetrwała kilka wersji Graph API.
W praktyce najlepiej nie opierać się na żadnej z tych liczb i odczytywać quota_total z odpowiedzi. To wartość, względem której konto jest naprawdę mierzone, przychodzi osobno dla każdego konta, a jej pobranie kosztuje jedno żądanie.
Co wlicza się do limitu, a co nie?
Publikowanie się liczy. Tworzenie nie. W sformułowaniach Meta to rozróżnienie jest precyzyjne, bo quota_usage liczy "the number of times the app user has published an IG Container", a przewodnik wskazuje endpoint, na którym limit jest egzekwowany: "This limit is enforced on the POST /<IG_ID>/media_publish endpoint when attempting to publish a media container."
| Działanie | Wlicza się do quota_usage | Co je reguluje |
|---|---|---|
POST /<IG_ID>/media tworzący kontener | Nie | Osobny limit 400 kontenerów |
POST /<IG_ID>/media_publish | Tak | quota_total |
| Publikacja karuzeli z 10 zdjęciami | Tak, jako jeden post | "Carousels count as a single post" |
| Kontener, który wygasł bez publikacji | Nie | "Containers expire after 24 hours" |
| Post opublikowany ręcznie w aplikacji Instagram | Nie | Limit dotyczy "API-published posts" |
Tworzenie kontenerów ma własny limit, do którego większość zespołów nigdy nie dochodzi. Dokumentacja endpointu mediów stwierdza: "An Instagram account can only create 400 containers within a rolling 24 hour period." Osiem kontenerów na publikację to hojna proporcja, więc proces, który agresywnie ponawia tworzenie kontenerów, może wyczerpać ten budżet, gdy quota_usage nadal wskazuje zero, a błąd nie będzie w niczym przypominał limitu publikacji.
Karuzele warto dobrze zrozumieć, jeśli publikujesz zestawy zdjęć partiami. Dziesięć zdjęć to jedna jednostka limitu, dzięki czemu planowanie karuzel na Instagramie i Facebooku obciąża limit znacznie mniej niż dziesięć pojedynczych postów z tymi samymi zdjęciami.

AdaptlyPost
Rozpocznij 7-dniowy bezpłatny okres próbny
Analityka wszystkich platform
Skrzynka społecznościowa
Asystent oparty na AI
Jak odczytywać odpowiedź przed publikacją?
Wywołuj content_publishing_limit przed publikacją, a nie po błędzie, i porównuj quota_usage z config.quota_total, a nie z liczbą wpisaną na stałe w kodzie. Meta prosi o to wprost: "We recommend that your app also enforce the publishing rate limit, especially if your app allows app users to schedule posts to be published in the future."
O wartości tej kontroli decydują trzy szczegóły:
- Proś wprost o
config. Bez niego dostajesz licznik i nic, z czym można go porównać. - Traktuj okno jako kroczące, a nie dobowe.
quota_durationto 86400 sekund liczonych wstecz od teraz, więc limit odnawia się stopniowo w ciągu dnia, a nie o określonej godzinie. - Sprawdzaj przed każdą publikacją w partii, a nie raz na partię. Kolejka 20 postów, która sprawdziła limit tylko na początku, może przekroczyć go przy 14. poście.
Najbardziej odczuwają to narzędzia do planowania, bo kolejka ustala godziny publikacji z wielogodzinnym lub wielodniowym wyprzedzeniem, a limit jest zużywany w chwili obecnej. To ten sam rodzaj problemu co w przypadku każdego API do planowania w mediach społecznościowych opartego na limitach platform: harmonogram powstaje dla możliwości, których nikt jeszcze nie zmierzył.
Jaki błąd zwraca Instagram po osiągnięciu limitu?
Dokumentacja kodów błędów Meta podaje to precyzyjnie. Konto, które wyczerpało limit publikacji, otrzymuje HTTP 400, kod 9, podkod 2207042 z komunikatem: "You reached maximum number of posts that is allowed to be published by Content Publishing API."
Zalecane rozwiązanie brzmi: "The app user has reached their daily publishing limit. Advise the app's user to try again the following day." Zwróć uwagę na niespójność. Wszędzie indziej okno opisano jako kroczące 24 godziny, a tutaj rada mówi "the following day", czyli używa języka kalendarzowego dla okna kroczącego. Limit zwalnia się 24 godziny po każdej pojedynczej publikacji, a nie o północy.
Pokrewne błędy wyglądają inaczej i należy je obsługiwać osobno. Kod 4, podkod 2207051 zwraca "We restrict certain activity to protect our community. Tell us if you think we made a mistake", a Meta wiąże go z publikacjami "suspected to be spam." To nie jest problem limitu i ponowna próba następnego dnia go nie rozwiąże. Inne platformy również oddzielają limit, który można przeczekać, od ograniczenia, którego przeczekać się nie da, dlatego opublikowane limity Pinteresta i limity Instagrama wymagają osobnych ścieżek obsługi w tej samej kolejce.
Jakich uprawnień wymaga to wywołanie?
Zakresy tokenu zależą od sposobu logowania, a Meta wymienia oba warianty. Instagram API with Instagram Login wymaga instagram_business_basic i instagram_business_content_publish. Instagram API with Facebook Login wymaga instagram_basic, instagram_content_publish i pages_read_engagement, a także ads_management lub ads_read, gdy "the app user was granted a role via the Business Manager on the Page connected to the targeted IG User."
To te same zakresy, których wymaga samo wywołanie publikacji, więc token zdolny do publikowania może też odczytać limit. Nie ma tańszego zakresu tylko do odczytu, co oznacza, że sprawdzenie limitu jest dostępne dla każdej aplikacji, która mogłaby go potrzebować.
Najczęściej zadawane pytania
Jaka jest pełna ścieżka endpointu?
GET /<IG_USER_ID>/content_publishing_limit, na graph.facebook.com dla Instagram API with Facebook Login i na graph.instagram.com dla Instagram API with Instagram Login.
Czy endpoint domyślnie zwraca limit?
Nie. Domyślnie wraca tylko quota_usage. Według dokumentacji Meta obiekt config, zawierający quota_total i quota_duration, trzeba zażądać przez parametr fields.
Jak daleko wstecz może sięgać parametr since?
24 godziny. Meta opisuje tę wartość jako "A Unix timestamp no older than 24 hours", więc endpoint nie pokaże zużycia z wcześniejszego okresu.
Czy nieudane próby publikacji wliczają się do quota_usage?
Meta tego nie określa. Pole liczy sytuacje, w których użytkownik "has published an IG Container", co wskazuje na udane publikacje, ale dokumentacja nie odnosi się do publikacji, która kończy się błędem po przyjęciu.
Czy utworzenie kontenera mediów zużywa limit?
Nie. Tworzenie kontenerów podlega osobnej regule, zgodnie z którą konto "can only create 400 containers within a rolling 24 hour period", a kontenery wygasają po 24 godzinach bez względu na to, czy zostały opublikowane.
Dlaczego quota_total to 50, skoro przewodnik podaje 100?
Meta publikuje obie liczby i nigdy tego nie wyjaśnia. Dokumentacja endpointu podaje, że quota_total wynosi "currently 50", a przewodnik po publikowaniu treści mówi o 100 w sekcji o limitach i znów o 50 w sekcji o karuzelach. Odczytuj wartość z odpowiedzi, zamiast ufać którejkolwiek ze stron.
Jak często sprawdzać limit w kolejce publikacji?
Przed każdą publikacją w kolejce, a nie tylko raz na początku. Okno jest kroczące, więc partia 20 postów sprawdzona tylko na starcie może przekroczyć limit, zanim dojdzie do 14. posta. Porównywanie quota_usage z config.quota_total przy każdej wysyłce wychwytuje tę rozbieżność, zanim zrobi to Instagram.
AdaptlyPost
Rozpocznij 7-dniowy bezpłatny okres próbny
Analityka wszystkich platform
Skrzynka społecznościowa
Asystent oparty na AI
Czy karuzela liczy się do quota_usage jako jeden post, czy kilka?
Karuzela liczy się jako jeden post, niezależnie od liczby zdjęć, zgodnie ze zdaniem Meta "Carousels count as a single post." Dziesięć zdjęć opublikowanych razem zużywa tę samą jedną jednostkę quota_usage co jedno zdjęcie. Dzięki temu karuzele obciążają limit znacznie mniej niż publikowanie tych samych zdjęć pojedynczo.
Co się stanie, jeśli aplikacja zignoruje limit publikacji?
Meta zaleca, by aplikacje same egzekwowały limit, zwłaszcza gdy pozwalają planować posty z wyprzedzeniem, bo pominięcie kontroli jedynie przesuwa błąd na moment publikacji. Konto powyżej limitu otrzymuje HTTP 400, kod 9, podkod 2207042, a możliwość publikacji wraca 24 godziny po każdej publikacji, a nie po dobowym resecie. Narzędzie do planowania, które pomija wcześniejsze sprawdzenie, dowiaduje się o tym, gdy jest już związane godziną publikacji, której nie może dotrzymać.
Czy ograniczenie za spam to to samo co osiągnięcie limitu publikacji?
Ograniczenie za spam to inny błąd niż limit. Kod 4, podkod 2207051 pojawia się, gdy publikacja jest "suspected to be spam", i ponowna próba następnego dnia go nie usunie, tak jak dzieje się to po przeczekaniu limitu. Ma to znaczenie dla kolejki, bo oba błędy wymagają różnych ścieżek obsługi: jedna czeka, a druga zatrzymuje publikację i oznacza treść.
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 odczytać status_code kontenera na Instagramie przed publikacją
Wszystkie wartości status_code kontenera na Instagramie opisane przez Metę, zalecana częstotliwość odpytywania, 24-godzinny termin i co zrobić przy ERROR.


Jak działa limit 100 postów na 24 godziny w API Instagrama
Limit 100 postów na 24 godziny w API Instagrama to ruchome okno liczone przy publikacji. Karuzela liczy się raz, a zdanie o 50 postach pozostaje niewyjaśnione.


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.
Powiązane artykuły


Co liczą interakcje z treściami na Instagramie, a co odejmują
Interakcje z treściami na Instagramie w praktyce: metryka Interakcje, pole API total_interactions, powody spadku liczby i to, kiedy wliczane są reklamy.


Dlaczego narzędzie do planowania postów ciągle rozłącza konta
Narzędzie do planowania rozłącza konta, gdy token wygasa lub ginie przedwcześnie. Czas życia tokenów Meta, LinkedIna, X i TikToka oraz to, co je unieważnia.


Długoterminowy token dostępu Facebooka i jego 60-dniowy zegar
Długoterminowy token dostępu Facebooka działa około 60 dni, a uzyskany z niego token strony nie ma daty wygaśnięcia. Wywołanie wymiany i najważniejsze zastrzeżenia.

