Sugestões de hashtags e hashtags em tendência do TikTok, através da API
A API for Business do TikTok sugere hashtags através de GET /business/hashtag/suggestion/, que recebe uma palavra-chave num dos 35 idiomas e devolve 10 hashtags, cada uma com o número de publicações que a usam, para o token da própria conta do TikTok. As mais populares vêm de GET /discovery/trending_list/, que classifica as 200 principais por país, setor e período, para o token de um anunciante.
O easyCoexistence liga contas do TikTok através da API for Business do TikTok, para que o seu próprio código obtenha sugestões de hashtags com o token de get_social_credentials, e o Claude, o ChatGPT ou esse código as escrevam na legenda e publiquem ou agendem a publicação com publish_tiktok_post, com cada ligação monitorizada 24/7.
Idiomas que o parâmetro language do endpoint de sugestões aceita, sendo en o predefinido; as sugestões voltam no idioma da palavra-chave.
Pedidos que uma conta autorizada pode enviar a um único endpoint da Accounts API, incluindo as sugestões de hashtags.
Valor de rank_change de uma hashtag popular que não estava entre as 200 principais do período anterior.
Duração máxima do trending_history, a posição diária e as visualizações que o TikTok devolve para cada hashtag popular.
Número máximo de hashtag_ids que /discovery/video_list/ aceita numa só chamada, devolvendo os 20 vídeos em tendência mais populares de cada uma.
Que endpoints do TikTok devolvem hashtags?
Cinco endpoints da API for Business do TikTok devolvem hashtags para publicações orgânicas, e distinguem-se pelo token que recebem: o da própria conta do TikTok ou o de um anunciante, a partir de uma conta de anúncios autorizada. Um sexto, nas ferramentas da Marketing API, recomenda hashtags para segmentação de anúncios em vez disso:
Como se faz a chamada ao endpoint de sugestões?
Com um GET que leva o business_id da conta, uma palavra-chave e, opcionalmente, language, cujos 35 valores vão de en, o predefinido, passando por es, pt-BR e ja-JP até zh-Hant-TW; o TikTok faz corresponder as sugestões ao idioma da palavra-chave. O cabeçalho Access-Token leva o token da conta do TikTok, e a referência da API do TikTok associa o endpoint à permissão Video Publish de TikTok Accounts, a mesma que a publicação de vídeos usa:
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 }
]
}
}O que contém cada sugestão?
Um nome, a hashtag a usar e post_count, o número total de publicações que a utilizaram. O TikTok devolve 10 sugestões, primeiro as correspondências exatas da palavra-chave e depois as restantes por número de publicações. A lista não traz dados de tendência: um post_count elevado indica uma hashtag que já muitas publicações usam, o que é um sinal diferente das posições em alta que /discovery/trending_list/ reporta.
Que tokens e permissões exige cada endpoint?
Diferem mais do que os caminhos sugerem, por isso verifique-os antes de construir:
- /business/hashtag/suggestion/: o token de acesso e o
business_idde uma conta do TikTok, com a aplicação a ter Video Publish em TikTok Accounts. - /discovery/
trending_list/, /discovery/detail/ e /discovery/video_list/: um token de acesso de anunciante e oadvertiser_idda autorização de uma conta de anúncios, com a aplicação a ter Discovery em Creative Management. - /business/mention/
top_hashtag/list/: o âmbito biz.brand.insights, numa conta com Advanced Access ou uma Verified Business Account. - /tool/hashtag/recommend/: um token de anunciante e o
advertiser_id; a referência do TikTok não lista nenhuma permissão para este endpoint.
O que devolvem as hashtags em tendência?
GET /discovery/trending_list/ recebe discovery_type com o valor HASHTAG, o seu único valor, com country_code, category_name e date_range opcionais; category_name aceita um setor de nível 1 ou 2, como FOOD_AND_BEVERAGE ou COOKING. Para cada hashtag devolve:
rank_positiondentro da categoria erank_changeface ao período anterior: positivo quando subiu, negativo quando desceu, NEW quando não estava entre as 200 principais.- Visualizações e publicações no país e período escolhidos, ao lado de
views_global_lifetimeeposts_global_lifetime. top_country_list: os cinco locais onde a hashtag é mais popular.trending_history: até 30 dias derank_position_dailyeviews_daily, com null quando a hashtag não esteve em tendência ou teve menos de 1 000 visualizações nesse dia.
Como se aprofunda uma hashtag popular?
Com duas chamadas adicionais com o mesmo token de anunciante. /discovery/detail/ recebe um hashtag_id da lista, com o mesmo country_code e date_range da chamada à lista, e acrescenta hashtag_status, ONLINE quando a hashtag está disponível para criar anúncios, e as idades dos espectadores, em três grupos, 18-24, 25-34 e 35+, vazio quando o estado é OFFLINE ou quando o público previsto é inferior a 1 000. /discovery/video_list/ recebe até 10 hashtag_ids e devolve os 20 vídeos em tendência mais populares de cada uma, ordenados por uma pontuação que combina visualizações, comentários, gostos e partilhas.
Como é que um assistente de IA escreve a legenda de uma publicação com sugestões?
Com um primeiro passo no seu próprio código. As ferramentas do easyCoexistence não obtêm sugestões, por isso o seu código pede-as ao TikTok com o token de get_social_credentials; o assistente guarda depois as que encaixam na publicação, escreve-as na legenda com o sinal # e publica através de publish_tiktok_post, agora ou numa hora definida. As referências de publicação do TikTok indicam que as hashtags numa legenda enviada pela API aparecem como texto simples na aplicação:
O que pode o easyCoexistence alcançar e o que está fora do seu alcance?
get_social_credentials dá ao seu próprio código o token e o business_id da conta para os caminhos do TikTok sob business/, por isso as sugestões de hashtags funcionam, tal como /business/mention/top_hashtag/list/, onde o TikTok abre a Mentions API à conta. Os endpoints de Discovery estão fora de alcance: recebem o token e o advertiser_id de um anunciante em vez dos da conta. As suas ferramentas dedicadas não devolvem hashtags.
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"
}Erros comuns
- Colar os valores de name numa legenda tal como estão. O exemplo do TikTok devolve nomes sem o sinal #, por isso acrescente-o antes de cada um.
- Ordenar as sugestões por view_count. O TikTok marcou esse campo para descontinuação até 9 de outubro de 2026, por isso ordene por post_count.
- Tomar uma sugestão com post_count 0 para uma hashtag em uso. Assim o TikTok devolve a própria palavra-chave quando não tem nada a sugerir.
- Pedir a /discovery/detail/ com um country_code ou date_range diferente dos da chamada à lista. O TikTok responde com um erro, e uma hashtag fora da lista recebe uma resposta vazia.
De US$ 9 a US$ 0.75 por ligação por mês, descendo à medida que adiciona ligações, com os primeiros 3 dias grátis.
Perguntas frequentes
Quantas hashtags pode ter uma legenda do TikTok através da API?
As referências de publicação do TikTok não fixam um limite separado para hashtags: contam para a legenda, até 2 200 caracteres UTF-16 numa publicação de vídeo e 4 000 numa publicação de fotografia, e as @menções ficam limitadas a 30.
Posso obter sugestões de hashtags noutros idiomas?
Sim. Indique language com a palavra-chave, por exemplo pt-BR, es ou ja-JP; as sugestões seguem o idioma da palavra-chave, e o inglês é o predefinido.
Pode uma conta do TikTok obter hashtags em tendência sem uma conta de anúncios?
Não através de /discovery/trending_list/, que exige o token de um anunciante. Uma conta com Advanced Access ou uma Verified Business Account pode ler as 20 hashtags mais usadas em publicações que a mencionam.
Quanto custa o easyCoexistence para uma conta do TikTok?
De US$ 9 a US$ 0.75 por ligação por mês, descendo à medida que adiciona ligações, com os primeiros 3 dias grátis; cada conta do TikTok é uma ligação.
Continue a ler
Ligue o seu primeiro canal em dois minutos.
Sem revisões de plataformas para esperar. Ligue o WhatsApp, o Instagram, o TikTok ou outro canal, peça depois à sua IA que publique, responda ou faça um relatório, e veja-a trabalhar.
- 3 dias grátis
- Cancele quando quiser
- Só APIs oficiais
- Monitorizado 24/7
Verificado em