Iniciar sessãoIniciar teste gratuito
easyCoexistence APIs oficiais

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.

35

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.

40 a minute

Pedidos que uma conta autorizada pode enviar a um único endpoint da Accounts API, incluindo as sugestões de hashtags.

NEW

Valor de rank_change de uma hashtag popular que não estava entre as 200 principais do período anterior.

30 days

Duração máxima do trending_history, a posição diária e as visualizações que o TikTok devolve para cada hashtag popular.

10

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:

/business/hashtag/suggestion/10 hashtags for a keyword, for captions; account token
/discovery/trending_list/Top 200 popular hashtags by country, category and period; advertiser token
/discovery/detail/One popular hashtag's numbers, ad status and viewer ages; advertiser token
/discovery/video_list/Top 20 trending videos for up to 10 popular hashtags; advertiser token
/business/mention/top_hashtag/list/The 20 hashtags used most in posts that @mention the business; account token
/tool/hashtag/recommend/Hashtags to target ads at, under an advertiser_id; not for captions

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:

Hashtag suggestions for a keyword, after TikTok's own example
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_id de 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 o advertiser_id da 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_position dentro da categoria e rank_change face 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_lifetime e posts_global_lifetime.
  • top_country_list: os cinco locais onde a hashtag é mais popular.
  • trending_history: até 30 dias de rank_position_daily e views_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:

1Pick keywordsFrom the post's topic, in the caption's language
2Ask TikTokbusiness/hashtag/suggestion/, from your own code
3ChooseThe names that fit, weighed by post_count
4Write#name in the caption, within 2,200 UTF-16 units on a video
5Publishpublish_tiktok_post, now or with scheduled_at

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.

Suggestions, then a scheduled post with them in the caption
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.
Fazer isto com a EasyCoexistence

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