TL;DR, szybka odpowiedź
7 min czytaniaParametr caption w POST /<IG_ID>/media ma w dokumentacji Meta jedno zdanie o limitach: "Maximum 2200 characters, 30 hashtags, and 20 @ tags." Za długi podpis zwraca kod 36004, podkod 2207010. Ponad 20 oznaczeń @ zwraca kod 100, podkod 2207040. Meta nie publikuje błędu dla 31. hashtagu ani żadnego limitu znaków podpisu dla aplikacji Instagram.
Jaki jest limit podpisu na Instagramie w API?
Meta zapisuje limit podpisu na Instagramie w jednym zdaniu w dokumentacji punktu końcowego tworzenia mediów: "Maximum 2200 characters, 30 hashtags, and 20 @ tags." To zdanie zamyka opis parametru caption w POST /<IG_ID>/media i jest jedynym miejscem, w którym Meta podaje wszystkie trzy liczby razem.
Pełny opis parametru, w brzmieniu opublikowanym przez Meta:
A caption for the image, video, or carousel. Can include hashtags (example:
#crazywildebeest) and usernames of Instagram users (example:@natgeo). @Mentioned Instagram users receive a notification when the container is published. Maximum 2200 characters, 30 hashtags, and 20 @ tags.
W tym jednym zdaniu mieszczą się trzy osobne limity, a każdy zawodzi inaczej. Dwa zwracają udokumentowane błędy. Jeden nie.
Na którym etapie publikacji dodaje się podpis?
Podpis trafia do kontenera, a nie do publikacji. Proces publikowania na Instagramie składa się z dwóch wywołań: POST /<IG_ID>/media tworzy kontener, a POST /<IG_ID>/media_publish go publikuje. Wywołanie publikacji przyjmuje creation_id i nic więcej, co dotyczyłoby tekstu.
curl -X POST "https://graph.facebook.com/<LATEST_API_VERSION>/<IG_USER_ID>/media" \
-H "Authorization: Bearer <ACCESS_TOKEN>" \
-d "image_url=<IMAGE_URL>" \
-d "caption=<CAPTION>"Za długi podpis powoduje więc błąd przy tworzeniu kontenera, zanim cokolwiek zostanie opublikowane i zanim zużyje się limit. To łagodna wersja problemu. Nic nie trafiło do sieci, nic nie zostało zużyte, a kroczący limit publikacji raportowany przez content_publishing_limit pozostaje nienaruszony, bo ten licznik zmienia się tylko przy media_publish.
W karuzelach podpis ma określone miejsce. Meta dodaje do parametru caption ostrzeżenie: "Not supported on images or videos in carousels." Podpis należy do kontenera karuzeli utworzonego z media_type=CAROUSEL, a ustawienie go w kontenerze podrzędnym nic nie daje. To samo ostrzeżenie dotyczy location_id, więc oba pola podlegają tej samej zasadzie.
Z relacjami jest dziwniej. Składnia żądań Meta dla kontenerów relacji ze zdjęciem i wideo wymienia image_url lub video_url, media_type=STORIES, user_tags i access_token, a caption nie ma w żadnej z nich. Tabela parametrów nadal opisuje caption ogólnie jako "A caption for the image, video, or carousel", co nie mówi nic o relacjach. Meta na piśmie ani tego nie dopuszcza, ani nie zabrania.
Jaki błąd zwraca za długi podpis?
HTTP 400, kod 36004, podkod 2207010. Dokumentacja kodów błędów Meta podaje komunikat dla użytkownika ze zmiennymi w treści:
The submitted image's caption was {submitted-caption-length} characters long. The maximum number of characters permitted for a caption is {maximum-caption-length}. Please submit media with a shorter caption.
Zalecane rozwiązanie w tym samym wierszu powtarza limit: "The user exceeded the maximum amount of characters for a caption. Advise user to use a shorter caption. Maximum 2,200 characters, 30 hashtags, and 20 @ tags."
W tym błędzie warto zauważyć dwie rzeczy. Komunikat wstawia rzeczywiste maksimum w czasie działania zamiast mieć je zaszyte na stałe, więc miarodajna liczba dociera do ciebie w samym tekście błędu. A sformułowanie mówi "The submitted image's caption", choć ten sam parametr caption obsługuje wideo, Reels i karuzele. Meta nie uogólniła tego tekstu, by pasował do pola.
Różni się też zapis liczby na obu stronach. Dokumentacja parametru podaje "2200 characters", a dokumentacja kodów błędów "2,200 characters". Ta sama wartość w dwóch zapisach to pewny znak, że obu stron nie generuje jedno źródło.

Co się stanie po przekroczeniu 20 oznaczeń @?
HTTP 400, kod 100, podkod 2207040, z komunikatem "Cannot use more than {max-tag-count} tags per created media." Zalecane rozwiązanie Meta podaje liczbę, którą komunikat zostawia jako zmienną: "The app user exceeded the maximum number (20) of @ tags. Advise user to use fewer @ tags."
AdaptlyPost
Rozpocznij 7-dniowy bezpłatny okres próbny
Analityka wszystkich platform
Skrzynka społecznościowa
Asystent oparty na AI
To drugi z trzech limitów i ten, do którego można dojść niechcący. Podpis wymieniający fotografa, miejsce, stylistę, trzech współpracowników i markę ma osiem wzmianek, zanim zacznie się właściwy tekst. Limit dotyczy oznaczeń @ w treści podpisu, czyli innego mechanizmu niż parametr user_tags, który umieszcza nazwy użytkowników we współrzędnych x i y na obrazie, oraz niż collaborators, które Meta ogranicza osobno do "up to 3 instagram usernames".
| Mechanizm | Pole | Udokumentowany limit |
|---|---|---|
| Wzmianki @ w treści podpisu | caption | 20 |
| Oznaczeni użytkownicy na mediach | user_tags | Nie opublikowano |
| Współautorzy posta | collaborators | 3 |
| Oznaczenia produktów | product_tags | 5 |
| Sponsorzy treści brandowanych | branded_content_sponsor_ids | 2 |
Wzmianki nie są też tylko ozdobą. Meta zaznacza, że "@Mentioned Instagram users receive a notification when the container is published", więc limit 20 oznaczeń jest w równym stopniu limitem powiadomień, co limitem tekstu.
- 2 200 znaków
- Zwraca kod 36004, podkod 2207010
- 20 oznaczeń
- Zwraca kod 100, podkod 2207040
- 30 hashtagów
- Brak opublikowanego błędu
Czy istnieje błąd dla 31. hashtagu?
Meta żadnego nie publikuje. Limit 30 hashtagów pojawia się w opisie parametru caption i w zalecanym rozwiązaniu przy błędzie długości podpisu, ale w tabeli kodów błędów Instagrama nie ma wiersza o jego przekroczeniu. Są wiersze dla zbyt długich podpisów, zbyt wielu oznaczeń @, liczby elementów karuzeli, oznaczeń produktów, rozmiaru obrazu, proporcji i formatu wideo. Hashtagi wiersza nie mają.
To milczenie sprawia, że zachowanie jest naprawdę nieudokumentowane. Meta nie mówi, czy 31. hashtag odrzuci kontener, zostanie usunięty, czy post się opublikuje, a wyszukiwarka go zignoruje. Liczba 30 jest opublikowana. Skutek jej przekroczenia nie.
Tę lukę lepiej uwzględnić w planie, niż testować, bo uczciwa odpowiedź inżynierska to egzekwować 30 we własnym edytorze i nigdy się nie przekonać. Limit jest też znacznie wyższy niż liczba, która cokolwiek daje, bo zakres hashtagów realnie wpływający na zaangażowanie na Instagramie jest daleko od tego pułapu.
Jak limit API wypada na tle tego, co pozwala aplikacja?
Meta publikuje jeden limit podpisu i jest to limit API. Dokumentacja dla deweloperów podaje 2 200 znaków, 30 hashtagów i 20 oznaczeń @ dla parametru caption. Dokumentacja pomocy aplikacji Instagram nie podaje odpowiedniego limitu znaków podpisu, limitu wzmianek ani limitu hashtagów, które dałoby się przypisać do aktualnej strony Meta.
Porównanie, które robi większość artykułów, czyli że API „odpowiada” aplikacji przy 2 200 znakach, zestawia więc liczbę udokumentowaną z nieudokumentowaną. Wartość 2 200 jest prawdziwa i ma źródło. Jej odpowiednik w aplikacji to legenda powtarzana tak długo, że wygląda jak cytat.
Ten sam schemat widać przy sąsiednim polu. Meta dokumentuje limit 1 000 znaków parametru alt_text w API publikacji i nie podaje limitu dla pola tekstu alternatywnego w aplikacji. Jedna strona produktu jest opisana, druga nie.
Jest jedna udokumentowana różnica w działaniu i przemawia na korzyść aplikacji. Podziały wierszy i odstępy obsługuje edytor w aplikacji, a API przyjmuje dowolny wysłany tekst, dlatego zespoły budujące podpisy programowo muszą same rozwiązać problem, jak dodać odstępy w podpisie na Instagramie, zamiast dostać to od interfejsu.

Co właściwie powinien sprawdzać walidator podpisu?
Cztery kontrole obejmują wszystko, co dokumentuje Meta, i wykonuje się je przed wywołaniem kontenera, a nie po błędzie:
- Liczba znaków nie większa niż 2 200, mierzona na końcowym tekście po cofnięciu kodowania URL.
- Liczba hashtagów nie większa niż 30, egzekwowana lokalnie, bo Meta nie zwraca dla niej błędu.
- Liczba wzmianek @ nie większa niż 20, zgodnie z limitem
2207040. - Podpis przypisany do kontenera karuzeli, nigdy do jej elementu podrzędnego.
Traktuj 36004 i 2207040 jako błędy po stronie wywołującego, a nie błędy do ponowienia. Żaden nie zniknie przy drugiej próbie z tymi samymi danymi, a pętla ponawiania dla podpisu o długości 2 400 znaków będzie zużywać żądania, aż zepsuje się coś innego.
Najczęściej zadawane pytania
Jaki dokładnie limit podpisu publikuje Meta?
"Maximum 2200 characters, 30 hashtags, and 20 @ tags" przy parametrze caption w punkcie końcowym POST /<IG_ID>/media. Dokumentacja kodów błędów powtarza te wartości jako "2,200 characters, 30 hashtags, and 20 @ tags".
Który kod błędu oznacza za długi podpis?
Kod 36004, podkod 2207010, zwracany jako HTTP 400. Komunikat zawiera zarówno przesłaną długość, jak i maksimum, więc rzeczywisty limit wraca w samym błędzie.
Czy można ustawić podpis dla pojedynczego obrazu w karuzeli?
Nie. Meta oznacza parametr caption jako "Not supported on images or videos in carousels." Podpis należy do kontenera karuzeli utworzonego z media_type=CAROUSEL.
AdaptlyPost
Rozpocznij 7-dniowy bezpłatny okres próbny
Analityka wszystkich platform
Skrzynka społecznościowa
Asystent oparty na AI
Czy wzmianki @ w podpisie powiadamiają użytkownika?
Tak. Meta podaje, że "@Mentioned Instagram users receive a notification when the container is published", co wiąże limit 20 oznaczeń z powiadomieniami, a nie tylko z długością tekstu.
Co się stanie po wysłaniu 31 hashtagów?
Meta tego nie mówi. Limit 30 hashtagów jest podany w opisie parametru, a tabela kodów błędów Instagrama nie ma wiersza o jego przekroczeniu, więc zachowanie jest nieudokumentowane.
Czy aplikacja Instagram egzekwuje te same 2 200 znaków?
Meta publikuje tę liczbę tylko dla API. Dokumentacja pomocy nie podaje odpowiedniego limitu znaków podpisu dla edytora w aplikacji, więc powszechnego twierdzenia o zgodności obu wartości nie da się oprzeć na źródle od Meta.
Co się dzieje, gdy podpis powoduje błąd przy tworzeniu kontenera?
Kontener mediów nie powstaje, więc nic się nie publikuje, a kroczący limit publikacji śledzony przez content_publishing_limit pozostaje nietknięty, bo ten licznik zmienia się tylko przy media_publish. Błąd pojawia się, zanim jakiekolwiek media trafią do sieci, dzięki czemu jest tańszy niż błąd na późniejszym etapie. Poprawienie podpisu i ponowne wysłanie kosztuje tylko samą próbę.
Czy można dodać podpis do kontenera relacji na Instagramie?
Udokumentowana przez Meta składnia żądań dla kontenerów relacji wymienia image_url lub video_url, media_type=STORIES, user_tags i access_token, a caption na tej liście nie ma. Ogólny opis parametru caption obejmuje obrazy, wideo i karuzele, ale nie mówi nic o relacjach. Meta na piśmie ani nie dopuszcza podpisu w kontenerze relacji, ani go nie zabrania.
Czy limit 2 200 znaków dotyczy też wideo i Reels, a nie tylko zdjęć?
Parametr caption należy do tego samego punktu końcowego POST /<IG_ID>/media niezależnie od typu mediów, więc limity 2 200 znaków, 30 hashtagów i 20 oznaczeń obowiązują dla wideo i Reels tak samo jak dla obrazów. Komunikat błędu nadal mówi "the submitted image's caption", nawet gdy kontener zawiera wideo, bo Meta napisała ten tekst z myślą o obrazach i nigdy go nie zaktualizowała. Sformułowanie jest niespójne. Egzekwowanie nie.
Czy wzmianki @ w podpisie to to samo co oznaczeni użytkownicy na obrazie?
To dwa osobne mechanizmy z dwoma osobnymi limitami. Wzmianki @ znajdują się w treści podpisu i mają limit 20, a user_tags umieszcza nazwy użytkowników we współrzędnych x i y na obrazie i nie ma żadnego opublikowanego limitu. Collaborators to trzeci, osobny mechanizm z limitem 3.
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


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.


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.


Co zwraca endpoint content_publishing_limit na Instagramie
Endpoint content_publishing_limit na Instagramie zwraca quota_usage oraz blok config z wartościami quota_total 50 i quota_duration 86400 sekund.
Powiązane artykuły


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.


Meta ustala limit znaków alt_text w API Instagrama na 1 000
Meta ogranicza alt_text w API Instagrama do 1 000 znaków i tylko do obrazów statycznych. Reels i relacje w ogóle nie przyjmują tekstu alternatywnego.

