Słownik

Jak limit 500 znaków w Threads API traktuje topic_tag

Taras Shynkarenko
Taras Shynkarenko
•Zaktualizowano: •8 min czytania
Jak limit 500 znaków w Threads API traktuje topic_tagJak limit 500 znaków w Threads API traktuje topic_tag

TL;DR, szybka odpowiedź

8 min czytania

Meta ogranicza posty tekstowe w Threads do 500 znaków i liczy emoji jako bajty UTF-8. Temat można dodać na dwa sposoby: parametrem topic_tag, który jest poza polem text i ma od 1 do 50 znaków, albo tagiem w tekście zaczynającym się od znaku krzyżyka, który należy do text i zużywa pulę 500. Meta nie podaje, czy wartość topic_tag wlicza się do limitu posta.

Czego dotyczy limit 500 znaków w Threads API?

Meta odnosi limit 500 znaków w Threads API do parametru text kontenera multimediów, a topic_tag traktuje jako osobny parametr z własnym pułapem 50 znaków. Limit pojawia się jako jednowierszowy punkt w części Limitations sekcji Single Thread Posts: "Text posts are limited to 500 characters." Strona przeglądu Threads powtarza to samo zdanie słowo w słowo w części Other Limitations.

Żadna z tych stron nie wiąże tego zdania z nazwą pola. Endpoint kontenera przyjmuje text dla typów multimediów TEXT, IMAGE, VIDEO i CAROUSEL, a punkt o 500 znakach znajduje się pod nagłówkiem o postach tekstowych, więc Meta nie rozstrzyga, czy opis posta ze zdjęciem ma ten sam pułap. W dokumentacji Threads nie pojawia się żadna inna liczba, dlatego 500 to jedyny limit, na jakim integracja może się oprzeć przy każdej wartości text.

Reguła liczenia dołączona do tego punktu to element, który większość liczników znaków robi źle: "Emojis are counted as the number of UTF-8 bytes." Emoji czteroosobowej rodziny kosztuje 25 z puli 500, a nie 1. Szczegóły znajdziesz w artykule o tym, dlaczego limit znaków w Threads liczy emoji jako bajty UTF-8.

Czy topic_tag wlicza się do 500 znaków?

Meta tego nie mówi. Parametr topic_tag ma własną podsekcję z własnym ograniczeniem, "Topic tags must be at least 1 character and no more than 50 characters long", a ani przewodnik po postach, ani dokumentacja publikowania nie wiążą tej wartości z limitem znaków posta.

Dokumentacja ustala natomiast, gdzie co się znajduje. topic_tag to osobne pole formularza w POST /{threads-user-id}/threads, wysyłane obok text:

curl -i -X POST \
  -d "media_type=TEXT" \
  -d "text=<TEXT>" \
  -d "access_token=<ACCESS_TOKEN>" \
  -d "topic_tag=<TAG>" \
"https://graph.threads.net/v1.0/<THREADS_USER_ID>/threads"

Tag w tekście to przypadek odwrotny i nie wymaga żadnego rozstrzygnięcia ze strony Meta, bo jest częścią ciągu wpisanego w text. Każdy znak #socialmedia to znak posta, więc tag w tekście z definicji zużywa pulę 500. Ta asymetria to praktyczny powód, by wybierać parametr: droga przez tekst na pewno obciąża 500 znaków, a droga przez parametr pozostaje otwartym pytaniem.

Zbliżenie dłoni wpisującej hashtag na telefonie, co ilustruje tag w tekście umieszczony bezpośrednio w poście.

Czym różni się topic_tag od tagu w tekście?

Meta obsługuje oba rozwiązania, ale jedno oznacza jako przestarzałe. Metoda z tagiem w tekście ma w dokumentacji wyraźne ostrzeżenie: "This method is not preferred but is kept for backwards compatability."

Parametr topic_tagTag w tekście
Gdzie się znajdujeWe własnym polu formularzaWewnątrz text
Reguła długościOd 1 do 50 znakówOd 1 do 50 znaków
Znak krzyżykaNieużywanyWymagany na początku tagu
Zużywa pulę 500Meta tego nie podajeTak, każdy znak
Status w dokumentacji MetaAktualny"not preferred but is kept for backwards compatability"

Jedna reguła dotyczy obu dróg: "Only one topic tag is allowed per post, so the first valid tag included in a post of any type (text-only, image, video, carousel) via the API is treated as the tag for that post." Kolejne słowa z krzyżykiem w treści nie stają się dodatkowymi tematami, a mimo to kosztują znaki.

Dwie strony dokumentacji różnią się też zakresem informacji. Przewodnik po postach podaje zakres od 1 do 50 znaków dla tagów tematycznych. Dokumentacja POST /{threads-user-id}/threads wymienia topic_tag tylko z zakazanymi znakami, bez żadnej reguły długości, więc deweloper czytający wyłącznie ją nigdy nie zobaczy liczby 50.

Jakie znaki są zakazane w tagu tematycznym Threads?

Obie drogi mają różne listy zakazanych znaków, a lista dla tagu w tekście jest znacznie dłuższa. W parametrze Meta zakazuje dwóch znaków: kropek i znaków &. W przypadku tagu w tekście Meta pisze "any in-text tag that starts with a hash sign will end just before these characters" i podaje pełny zestaw.

DrogaNiedozwolone znaki
Parametr topic_tagKropki (.), znaki & (&)
Tag w tekścieSpacje, tabulatory, znaki nowego wiersza, kropki (.), znaki & (&), małpy (@), wykrzykniki (!), znaki zapytania (?), przecinki (,), średniki (;), dwukropki (:)

Osobna reguła wyklucza tagi liczbowe: "Whole numbers that are preceded by a hash sign (i.e., #1) will not be converted into a tag. This is because it is assumed that # is signifying a number sign in this scenario." Meta zaznacza też, że "The text is also configured in the app without the hash sign", więc krzyżyk jest dla API znacznikiem, a nie częścią tematu.

W praktyce oznacza to ciche ucinanie. Wpisanie #social media w text tworzy temat „social", a słowo „media" zostaje zwykłym tekstem, bez błędu i ostrzeżenia. Wysłanie social media jako topic_tag zachowuje całą frazę.

Gdzie umieścić temat
1
Zmierz tekst w bajtach UTF-8. Emoji liczą się jako bajty, a nie znaki.
2
Sprawdź, ile zostało z 500. Bieżąca liczba bajtów wyznacza budżet.
3
Wpisanie tematu w text. Kończy się na pierwszym zakazanym znaku, także na spacji.
4
Lepiej wyślij go jako topic_tag. Do 50 znaków, we własnym parametrze.
Lista zakazanych znaków i budżet liczony w bajtach przemawiają za parametrem topic_tag.

Jakie inne pola tekstowe ogranicza Threads API?

Zawartość jednego posta w Threads podlega czterem różnym limitom, a tylko jeden z nich to 500. Mylenie ich to częsta przyczyna kontenerów, które nie powstają z powodów niewidocznych dla licznika znaków.

PoleLimitGdzie podaje to Meta
text500 znaków, emoji liczone jako bajty UTF-8Przewodnik po postach, Limitations w Single Thread Posts
topic_tagOd 1 do 50 znakówPrzewodnik po postach, Topic Tags
alt_text1 000 znakówDokumentacja publikowania, POST /{threads-user-id}/threads
Linki w pościeMaksymalnie 5Przewodnik po postach, Links

Reguła linków jako jedyna ma udokumentowany komunikat błędu. Od 22 grudnia 2025 r. Meta podaje, że "Threads posts containing more than 5 links will fail to post during the media creation step (POST /{threads-user-id}/threads) with the error code: THREADS_API__LINK_LIMIT_EXCEEDED." Linki liczone są po usunięciu duplikatów: adres URL powtórzony w text liczy się raz, a link_attachment zgodny z adresem już obecnym w text "is only counted once, rather than twice".

AdaptlyPost
AdaptlyPost

Rozpocznij 7-dniowy bezpłatny okres próbny

Analityka wszystkich platform

Skrzynka społecznościowa

Asystent oparty na AI

Dla limitu 500 nie ma niczego podobnego. Indeks dokumentacji Threads API nie zawiera strony z kodami błędów, a strona rozwiązywania problemów opisuje tylko wartości status kontenera i wartości error_message dla filmów, więc dla zbyt długiego text nie ma opublikowanej stałej błędu, którą można by przechwycić.

Co się dzieje, gdy tekst przekroczy 500 znaków?

Meta dokumentuje limit, ale nie odpowiedź, więc jedyne pewne rozwiązanie to pomiar przed wysłaniem. Emoji liczą się jako bajty UTF-8, a nie znaki, dlatego mierzyć trzeba zakodowany ciąg. String.length w JavaScripcie równe 475 może po dodaniu kilku emoji oznaczać 517 bajtów, a to dokładnie ten błąd, który opisuje strona o limicie znaków w Threads.

To samo pytanie o liczenie bajtów pojawia się w każdej sieci przechowującej tekst posta w UTF-8, także w sposobie, w jaki fasety Bluesky indeksują linki przez byteStart i byteEnd zamiast pozycji znaku. Każda integracja publikująca w więcej niż jednej sieci potrzebuje jednego licznika dokładnego co do bajta, a nie osobnego dla każdej platformy.

Osoba przegląda kalendarz treści na laptopie obok telefonu, co pokazuje, że zaplanowany post powstaje na długo przed publikacją.

Co to oznacza dla zaplanowanych postów w Threads?

Narzędzie do planowania tworzy treść kontenera na długo przed wywołaniem publikacji, więc limit 500 trzeba egzekwować już na etapie szkicu, a nie przy wysyłce. Większość przypadków załatwiają dwa sprawdzenia: licz text w bajtach UTF-8 i przenoś tematy do topic_tag zamiast do treści, gdy post zbliża się do pułapu.

Ograniczenie po stronie publikacji to osobna sprawa, bo Threads ogranicza też profil do 250 postów publikowanych przez API w ruchomym okresie 24 godzin. Limity znaków odrzucają kontener przy tworzeniu, a limity puli przy publikacji, więc trzeba zaprojektować obsługę dwóch różnych błędów. Zespołom planującym Threads obok innych sieci przyda się strona narzędzia do planowania w Threads, która opisuje, jak AdaptlyPost łączy się przez oficjalne API.

Najczęściej zadawane pytania

Czy limit 500 znaków w Threads API jest taki sam jak w aplikacji Threads?

Liczba 500 podawana przez Meta dla API odpowiada tej, którą Threads pokazuje we własnym edytorze, a regułę liczenia emoji w bajtach Meta opisuje tylko w dokumentacji API. To strony API formułują tę regułę precyzyjnie, więc traktuj je jako specyfikację wszystkiego, co budujesz.

Czy post w Threads może mieć więcej niż jeden tag tematyczny?

Nie. Meta podaje, że "Only one topic tag is allowed per post", a użyty zostaje pierwszy prawidłowy tag w poście dowolnego typu. Kolejne słowa z krzyżykiem pozostają zwykłym tekstem w text i nadal wliczają się do 500.

Czy znak krzyżyka liczy się jako znak w tagu w tekście?

Tag w tekście jest częścią wartości text, więc liczy się każdy jego znak, także krzyżyk. Meta zaznacza, że sam temat zapisywany jest bez krzyżyka: "The text is also configured in the app without the hash sign."

Dlaczego mój tag tematyczny urywa się w połowie?

Tag w tekście kończy się na pierwszym znaku z listy zakazanych przez Meta, do której należą spacje, kropki, znaki &, małpy, wykrzykniki, znaki zapytania, przecinki, średniki i dwukropki. Wielowyrazowy temat wpisany w treści staje się więc tagiem jednowyrazowym. Wyślij go parametrem topic_tag, bo tam spacje nie są zakazane.

Jak długi może być tekst alternatywny w Threads?

1 000 znaków. Meta podaje tę liczbę w dokumentacji POST /{threads-user-id}/threads: "The maximum length of alt_text is 1,000 characters." Ta pula jest niezależna od 500 znaków w text.

Gdzie Meta dokumentuje limit 500 znaków?

W dwóch miejscach, tymi samymi słowami. Przewodnik po postach pod adresem developers.facebook.com/documentation/threads/posts zawiera zdanie "Text posts are limited to 500 characters." w części Limitations sekcji Single Thread Posts, a strona przeglądu pod adresem developers.facebook.com/documentation/threads/overview powtarza je w części Other Limitations. Reguła liczenia emoji w bajtach znajduje się obok niego w przewodniku po postach.

Czy topic_tag jest liczony w bajtach UTF-8 tak jak text?

Meta podaje regułę bajtów UTF-8 tylko dla pola text, w powiązaniu z limitem 500. Podsekcja o topic_tag określa zakres od 1 do 50 znaków bez wzmianki o bajtach, więc nie ma dokumentacji mówiącej, czy tag pełen emoji liczy się w bajtach, czy w znakach. Dopóki Meta nie powie inaczej, traktuj 50 jako znaki, bo tej jednostki używa dokumentacja.

Co się stanie, gdy post w Threads ma więcej niż 5 linków?

Tworzenie kontenera się nie powiedzie. Meta podaje, że błąd pojawia się na etapie tworzenia multimediów, POST /{threads-user-id}/threads, z kodem THREADS_API__LINK_LIMIT_EXCEEDED. To jedyny limit na tej liście z udokumentowanym komunikatem błędu, w odróżnieniu od 500 znaków w text.

Liczy się raz. Meta liczy linki po usunięciu duplikatów, więc ten sam adres URL użyty w tekście dwa razy to jeden link, a link_attachment zgodny z adresem obecnym już w text jest "only counted once, rather than twice." Pułapem pozostaje pięć unikalnych linków.

AdaptlyPost
AdaptlyPost

Rozpocznij 7-dniowy bezpłatny okres próbny

Analityka wszystkich platform

Skrzynka społecznościowa

Asystent oparty na AI

Czy topic_tag działa w postach ze zdjęciem lub filmem, a nie tylko tekstowych?

Tak, reguła obejmuje każdy typ multimediów. Meta podaje, że tagiem posta staje się pierwszy prawidłowy tag w "a post of any type (text-only, image, video, carousel)", więc topic_tag działa tak samo, niezależnie od tego, czy kontener zawiera zdjęcie, film czy karuzelę.

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