Sugestie hashtagów i trendujące hashtagi w TikTok przez API
API for Business TikTok sugeruje hashtagi przez GET /business/hashtag/suggestion/, który przyjmuje słowo kluczowe w jednym z 35 języków i zwraca 10 hashtagów, każdy z liczbą postów, które go użyły, dla własnego tokenu konta TikTok. Popularne hashtagi pochodzą z GET /discovery/trending_list/, który zestawia 200 najlepszych według kraju, branży i okresu dla tokenu reklamodawcy.
easyCoexistence łączy konta TikTok przez API for Business TikTok, więc własny kod pobiera sugestie hashtagów z tokenem z get_social_credentials, a Claude, ChatGPT albo ten kod wpisuje je do podpisu i publikuje lub planuje post narzędziem publish_tiktok_post.
Języki, jakie przyjmuje parametr language endpointu sugestii, domyślnie en; sugestie wracają w języku słowa kluczowego.
Liczba żądań, jakie jedno autoryzowane konto może wysłać do jednego endpointu Accounts API, łącznie z sugestiami hashtagów.
Wartość rank_change dla popularnego hashtagu, którego nie było w górnej 200 z poprzedniego okresu.
Najdłuższy okres trending_history, czyli dzienna pozycja i wyświetlenia, jakie TikTok zwraca dla każdego popularnego hashtagu.
Maksymalna liczba hashtag_ids, jaką /discovery/video_list/ przyjmuje w jednym wywołaniu, zwracając dla każdego 20 najpopularniejszych filmów.
Które endpointy TikTok zwracają hashtagi?
Pięć endpointów w API for Business TikTok zwraca hashtagi dla postów organicznych i dzieli się je według tokenu, jaki przyjmują: własnego tokenu konta TikTok albo tokenu reklamodawcy z autoryzowanego konta reklamowego. Szósty, wśród narzędzi Marketing API, zamiast tego rekomenduje hashtagi do kierowania reklam:
Jak wywołać endpoint sugestii?
Za pomocą GET z business_id konta, słowem kluczowym i opcjonalnie parametrem language, który przyjmuje 35 wartości: od en (domyślnej), przez es, pt-BR i ja-JP, po zh-Hant-TW. TikTok dopasowuje sugestie do języka słowa kluczowego. Nagłówek Access-Token zawiera token konta TikTok, a dokumentacja API TikTok przypisuje endpoint do uprawnienia Video Publish w TikTok Accounts, tego samego, którego używa publikowanie wideo:
curl -G 'https://business-api.tiktok.com/open_api/v1.3/business/hashtag/suggestion/' \
-H 'Access-Token: <ACCESS_TOKEN>' \
--data-urlencode 'business_id=<OPEN_ID>' \
--data-urlencode 'keyword=summer' \
--data-urlencode 'language=en'
{
"code": 0,
"message": "OK",
"request_id": "<REQUEST_ID>",
"data": {
"suggestions": [
{ "name": "summer", "post_count": 65296335 },
{ "name": "summertime", "post_count": 4787632 },
{ "name": "summeroutfit", "post_count": 2245117 }
]
}
}Co zawiera każda sugestia?
Nazwę, hashtag do użycia oraz post_count, czyli łączną liczbę postów, które go użyły. TikTok zwraca 10 sugestii: najpierw dokładne dopasowania do słowa kluczowego, a resztę według liczby postów. Lista nie zawiera danych o trendach: wysoki post_count pokazuje hashtag, którego używa już wiele postów, co jest innym sygnałem niż rosnące pozycje, jakie raportuje /discovery/trending_list/.
Jakich tokenów i uprawnień wymaga każdy endpoint?
Różnią się bardziej, niż sugerują ścieżki, więc sprawdź je przed budową:
- /business/hashtag/suggestion/: token dostępu konta TikTok i
business_id, a aplikacja z uprawnieniem Video Publish w TikTok Accounts. - /discovery/
trending_list/, /discovery/detail/ i /discovery/video_list/: token dostępu reklamodawcy iadvertiser_idz autoryzacji konta reklamowego, a aplikacja z uprawnieniem Discovery w Creative Management. - /business/mention/
top_hashtag/list/: zakres biz.brand.insights, na koncie z Advanced Access lub Verified Business Account. - /tool/hashtag/recommend/: token reklamodawcy i
advertiser_id; dokumentacja TikTok nie podaje dla niego żadnego uprawnienia.
Co zwracają trendujące hashtagi?
GET /discovery/trending_list/ przyjmuje discovery_type ustawiony na HASHTAG, jedyną dostępną wartość, z opcjonalnymi country_code, category_name i date_range. Parametr category_name przyjmuje branżę pierwszego lub drugiego poziomu, na przykład FOOD_AND_BEVERAGE lub COOKING. Dla każdego hashtagu zwraca:
rank_positionw kategorii orazrank_changewzględem poprzedniego okresu: wartość dodatnia, gdy wzrosła, ujemna, gdy spadła, NEW, gdy nie było jej w górnej 200.- Wyświetlenia i posty w wybranym kraju i okresie, obok
views_global_lifetimeiposts_global_lifetime. top_country_list: pięć lokalizacji, w których hashtag jest najpopularniejszy.trending_history: do 30 dnirank_position_dailyiviews_daily, wartość null, gdy hashtag nie był w trendach lub zebrał poniżej 1 000 wyświetleń tego dnia.
Jak sięgnąć głębiej w jeden popularny hashtag?
Dwoma kolejnymi wywołaniami na tym samym tokenie reklamodawcy. /discovery/detail/ przyjmuje hashtag_id z listy, z takim samym country_code i date_range jak wywołanie listy, i dodaje hashtag_status, ONLINE, gdy hashtag jest dostępny do tworzenia reklam, oraz wiek odbiorców w trzech grupach: 18-24, 25-34 i 35+. Pola są puste, gdy status to OFFLINE lub przewidywana widownia jest poniżej 1 000. /discovery/video_list/ przyjmuje do 10 hashtag_ids i zwraca dla każdego 20 najpopularniejszych filmów, uszeregowanych według wyniku łączącego wyświetlenia, komentarze, polubienia i udostępnienia.
Jak asystent AI opisuje post sugestiami?
Z pierwszym krokiem w Twoim własnym kodzie. Narzędzia easyCoexistence nie pobierają sugestii, więc Twój kod pyta o nie TikTok z tokenem z get_social_credentials; asystent zachowuje potem te, które pasują do posta, wpisuje je do podpisu ze znakiem # i publikuje przez publish_tiktok_post od razu albo o wskazanej godzinie. Dokumentacja publikowania TikTok zaznacza, że hashtagi w podpisie wysłanym przez API wyświetlają się w aplikacji jako zwykły tekst:
Do czego easyCoexistence ma dostęp, a czego nie obejmuje?
get_social_credentials daje własnemu kodowi token i business_id konta do ścieżek TikTok w business/, więc sugestie hashtagów działają, podobnie jak /business/mention/top_hashtag/list/, gdy TikTok otwiera Mentions API dla konta. Endpointy Discovery są poza zasięgiem: wymagają tokenu reklamodawcy i advertiser_id zamiast tokenu konta. Jego dedykowane narzędzia nie zwracają hashtagów.
GET https://business-api.tiktok.com/open_api/v1.3/business/hashtag/suggestion/
?business_id=<BUSINESS_ID>&keyword=recetas&language=es
Access-Token: <ACCESS_TOKEN>
publish_tiktok_post {
"account_id": "<ACCOUNT_ID>",
"video_url": "https://media.example.com/tiktok/tortilla.mp4",
"caption": "Tortilla en 10 minutos #recetas #recetasfaciles #cocina",
"scheduled_at": "2026-11-12T19:30:00+01:00"
}Typowe błędy
- Wklejanie wartości name do podpisu bez zmian. TikTok zwraca nazwy bez znaku #, więc dodaj go przed każdą z nich.
- Sortowanie sugestii według view_count. TikTok oznaczył to pole do wycofania do 9 października 2026, więc sortuj według post_count.
- Wybieranie sugestii z post_count równym 0 dla hashtagu w użyciu. TikTok tak zwraca samo słowo kluczowe, gdy nie ma nic do zasugerowania.
- Wywoływanie /discovery/detail/ z country_code lub date_range innym niż w wywołaniu listy. TikTok odpowiada błędem, a hashtag spoza listy daje pustą odpowiedź.
Każde połączenie jest monitorowane 24/7. Od US$ 9 do US$ 0,75 za połączenie miesięcznie, mniej w miarę dodawania połączeń, z pierwszymi 3 dniami za darmo.
Najczęściej zadawane pytania
Ile hashtagów może mieć podpis TikTok przez API?
Dokumentacja publikowania TikTok nie ustala osobnego limitu dla hashtagów: liczą się one do podpisu, do 2 200 znaków UTF-16 w poście wideo i 4 000 w poście ze zdjęciem, przy czym wzmianek @ może być najwyżej 30.
Czy mogę dostać sugestie hashtagów w innych językach?
Tak. Podaj parametr language razem ze słowem kluczowym, na przykład pt-BR, es lub ja-JP. Sugestie idą za językiem słowa kluczowego, a domyślnie jest angielski.
Czy konto TikTok może dostać trendujące hashtagi bez konta reklamowego?
Nie z /discovery/trending_list/, który wymaga tokenu reklamodawcy. Konto z Advanced Access lub Verified Business Account może odczytać 20 hashtagów najczęściej używanych w postach, które je wspominają.
Ile kosztuje easyCoexistence dla konta TikTok?
Od US$ 9 do US$ 0,75 za połączenie miesięcznie, mniej w miarę dodawania połączeń, z pierwszymi 3 dniami za darmo. Każde konto TikTok to jedno połączenie.
Czytaj dalej
Połącz pierwszy kanał w dwie minuty.
Bez czekania na weryfikację przez platformy. Połącz WhatsApp, Instagram, TikTok lub inny kanał, a potem poproś swoją AI o opublikowanie posta, odpowiedź lub raport i zobacz, jak działa.
- 3 dni za darmo
- Rezygnacja w każdej chwili
- Tylko oficjalne API
- Monitorowanie 24/7
Zweryfikowano w