EntrarComeçar teste grátis
easyCoexistence APIs oficiais

Sugestões de hashtag e hashtags em alta do TikTok pela API

A API for Business do TikTok sugere hashtags pelo GET /business/hashtag/suggestion/, que recebe uma palavra-chave em um dos 35 idiomas e devolve 10 hashtags, cada uma com o número de publicações que a usam, com o token da própria conta do TikTok. As populares vêm de GET /discovery/trending_list/, que ranqueia as 200 principais por país, setor e período com o token de um anunciante.

A easyCoexistence conecta contas do TikTok pela API for Business do TikTok, então o seu próprio código busca sugestões de hashtag com o token de get_social_credentials, e Claude, ChatGPT ou esse código as escrevem na legenda e publicam ou agendam a publicação com publish_tiktok_post, com cada conexão monitorada 24/7.

35

Idiomas que o parâmetro language do endpoint de sugestões aceita, com en como padrão; as sugestões voltam no idioma da palavra-chave.

40 a minute

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

NEW

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

30 days

Maior intervalo de trending_history, o rank diário e as visualizações que o TikTok devolve para cada hashtag popular.

10

Maior número de hashtag_ids que /discovery/video_list/ aceita em uma chamada, devolvendo os 20 vídeos em alta de cada uma.

Quais endpoints do TikTok devolvem hashtags?

Cinco endpoints da API for Business do TikTok devolvem hashtags para publicações orgânicas, separados pelo token que recebem: o da própria conta do TikTok ou o de um anunciante, de uma conta de anúncios autorizada. Um sexto, entre as ferramentas da Marketing API, recomenda hashtags para segmentação de anúncios:

/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 chamar o 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 padrão, passando por es, pt-BR e ja-JP até zh-Hant-TW; o TikTok combina as sugestões com o idioma da palavra-chave. O cabeçalho Access-Token leva o token da conta do TikTok, e a referência de API do TikTok classifica o endpoint sob a 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 cada sugestão contém?

Um name, a hashtag a ser usada e post_count, o número total de publicações que a usaram. O TikTok devolve 10 sugestões, primeiro as correspondências exatas da palavra-chave e depois as demais por número de publicações. A lista não traz dados de tendência: um post_count alto mostra uma hashtag que muitas publicações já usam, sinal diferente das posições em alta que /discovery/trending_list/ informa.

Quais tokens e permissões cada endpoint exige?

Eles diferem mais do que os caminhos sugerem, então confira antes de montar a integração:

  • /business/hashtag/suggestion/: o token de acesso de uma conta do TikTok e o business_id, com o app com a permissão 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 o app com a permissão Discovery em Creative Management.
  • /business/mention/top_hashtag/list/: o escopo biz.brand.insights, em uma conta com Advanced Access ou uma Verified Business Account.
  • /tool/hashtag/recommend/: um token de anunciante e advertiser_id; a referência do TikTok não lista permissão para ele.

O que retornam as hashtags em alta?

GET /discovery/trending_list/ recebe discovery_type com o valor HASHTAG, 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 ele devolve:

  • rank_position dentro da categoria, e rank_change em relação ao período anterior: positivo quando subiu, negativo quando caiu, NEW quando não estava entre as 200 principais.
  • views 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, null quando a hashtag não entrou em alta ou teve menos de 1,000 visualizações naquele dia.

Como aprofundar em uma hashtag popular?

Com duas chamadas a mais, com o mesmo token de anunciante. /discovery/detail/ recebe um hashtag_id da lista, com o mesmo country_code e date_range da chamada de lista, e acrescenta hashtag_status, ONLINE quando a hashtag está disponível para criação de anúncio, e as idades dos espectadores em três grupos, 18-24, 25-34 e 35+, vazias quando o status é OFFLINE ou o público esperado é menor que 1,000. /discovery/video_list/ recebe até 10 hashtag_ids e devolve os 20 vídeos em alta de cada um, ranqueados por uma pontuação que combina visualizações, comentários, curtidas e compartilhamentos.

Como um assistente de IA legenda uma publicação com sugestões?

Com um primeiro passo no seu próprio código. As ferramentas da easyCoexistence não buscam sugestões, então o seu código as pede ao TikTok com o token de get_social_credentials; o assistente então mantém as que combinam com a publicação, escreve-as na legenda com o sinal # e publica por publish_tiktok_post, agora ou em um horário definido. As referências de publicação do TikTok observam que hashtags em uma legenda enviada pela API aparecem como texto simples no app:

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 a easyCoexistence alcança e o que está fora do seu alcance?

get_social_credentials entrega ao seu próprio código o token e o business_id da conta para caminhos do TikTok sob business/; por isso as sugestões de hashtag funcionam, assim como /business/mention/top_hashtag/list/, já que o TikTok abre a Mentions API para a conta. Os endpoints de Discovery estão fora do alcance: eles recebem o token de um anunciante e advertiser_id em vez do da conta. 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 na legenda sem alterações. O exemplo do TikTok devolve nomes sem o sinal #; acrescente-o antes de cada um.
  • Ordenar sugestões por view_count. O TikTok marcou esse campo para descontinuação até 9 de outubro de 2026, então ordene por post_count.
  • Tratar como hashtag em uso uma sugestão com post_count 0. O TikTok devolve a própria palavra-chave assim quando não tem o que sugerir.
  • Pedir /discovery/detail/ com country_code ou date_range diferentes da chamada de lista. O TikTok responde com erro, e uma hashtag fora da lista recebe uma resposta vazia.
Fazendo isso com o EasyCoexistence

De US$ 9 a US$ 0.75 por conexão por mês, caindo conforme você adiciona conexões, com os 3 primeiros dias grátis.

O easyCoexistence é uma API e um servidor MCP multicanal que conecta agentes de IA, como o Claude e o ChatGPT, ao WhatsApp, Instagram, TikTok, Facebook e mais. No WhatsApp, ele usa o Coexistence: a empresa continua usando o número no app WhatsApp Business enquanto a IA trabalha pela API oficial da Meta.

Perguntas frequentes

Quantas hashtags uma legenda do TikTok pode ter pela API?

As referências de publicação do TikTok não fixam limite separado para hashtags: elas contam para a legenda, até 2,200 caracteres UTF-16 em uma publicação de vídeo e 4,000 em uma de foto, e as menções com @ se limitam a 30.

Posso obter sugestões de hashtag em outros idiomas?

Sim. Passe language junto 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 padrão.

Uma conta do TikTok pode obter hashtags em alta sem uma conta de anúncios?

Não por /discovery/trending_list/, que recebe 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 a easyCoexistence para uma conta do TikTok?

De US$ 9 a US$ 0.75 por conexão por mês, caindo conforme você adiciona conexões, com os 3 primeiros dias grátis; cada conta do TikTok é uma conexão.

Continue lendo

Conecte seu primeiro canal em dois minutos.

Sem esperar aprovação das plataformas. Conecte o WhatsApp, o Instagram, o TikTok ou outro canal, peça para a sua IA publicar, responder ou trazer os números, e veja funcionando.

  • 3 dias grátis
  • Cancele quando quiser
  • Só APIs oficiais
  • Monitorado 24/7

Verificado em