Log inStart Free Trial
easyCoexistence Official APIs

TikTok hashtag suggestions and trending hashtags through the API

TikTok's API for Business suggests hashtags through GET /business/hashtag/suggestion/, which takes a keyword in one of 35 languages and returns 10 hashtags, each with the number of posts using it, for a TikTok account's own token. Popular ones come from GET /discovery/trending_list/, which ranks the top 200 by country, industry and period for an advertiser's token.

easyCoexistence connects TikTok accounts through TikTok's API for Business, so your own code fetches hashtag suggestions with the token from get_social_credentials, and Claude, ChatGPT or that code writes them into the caption and publishes or schedules the post with publish_tiktok_post, with each connection monitored 24/7.

35

Languages the suggestion endpoint's language parameter takes, en by default; suggestions come back in the keyword's language.

40 a minute

Requests one authorized account can send to a single Accounts API endpoint, hashtag suggestions included.

NEW

rank_change value for a popular hashtag that was not in the previous period's top 200.

30 days

Longest span of trending_history, the daily rank and views TikTok returns for each popular hashtag.

10

Most hashtag_ids /discovery/video_list/ takes in one call, returning the top 20 trending videos for each.

Which TikTok endpoints return hashtags?

Five endpoints on TikTok's API for Business return hashtags for organic posts, and they split by the token they take: a TikTok account's own, or an advertiser's from an authorized ad account. A sixth, among the Marketing API's tools, recommends hashtags for ad targeting instead:

/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

How do you call the suggestion endpoint?

With a GET carrying the account's business_id, a keyword and, optionally, language, whose 35 values run from en, the default, through es, pt-BR and ja-JP to zh-Hant-TW; TikTok matches the suggestions to the keyword's language. The Access-Token header holds the TikTok account's token, and TikTok's API reference files the endpoint under the Video Publish permission of TikTok Accounts, the same one video publishing uses:

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 }
    ]
  }
}

What does each suggestion contain?

A name, the hashtag to use, and post_count, the total number of posts that have used it. TikTok returns 10 suggestions, exact matches to the keyword first and the rest by number of posts. The list carries no trend data: a high post_count shows a hashtag that many posts already use, which is a different signal from the rising ranks /discovery/trending_list/ reports.

Which tokens and permissions does each endpoint need?

They differ more than the paths suggest, so check them before building:

  • /business/hashtag/suggestion/: a TikTok account's access token and business_id, with the app holding Video Publish under TikTok Accounts.
  • /discovery/trending_list/, /discovery/detail/ and /discovery/video_list/: an advertiser access token and advertiser_id from an ad account's authorization, with the app holding Discovery under Creative Management.
  • /business/mention/top_hashtag/list/: the biz.brand.insights scope, on an account with Advanced Access or a Verified Business Account.
  • /tool/hashtag/recommend/: an advertiser's token and advertiser_id; TikTok's reference lists no permission for it.

What do trending hashtags return?

GET /discovery/trending_list/ takes discovery_type set to HASHTAG, its only value, with an optional country_code, category_name and date_range; category_name accepts a level-1 or level-2 industry such as FOOD_AND_BEVERAGE or COOKING. For each hashtag it returns:

  • rank_position within the category, and rank_change against the previous period: positive when it rose, negative when it fell, NEW when it was not in the top 200.
  • views and posts in the chosen country and period, beside views_global_lifetime and posts_global_lifetime.
  • top_country_list: the five locations where the hashtag is most popular.
  • trending_history: up to 30 days of rank_position_daily and views_daily, null when the hashtag did not trend or drew under 1,000 views that day.

How do you dig into one popular hashtag?

With two more calls on the same advertiser token. /discovery/detail/ takes a hashtag_id from the list, with the same country_code and date_range as the list call, and adds hashtag_status, ONLINE when the hashtag is available for ad creation, and viewer ages in three groups, 18-24, 25-34 and 35+, left empty when the status is OFFLINE or the expected audience is under 1,000. /discovery/video_list/ takes up to 10 hashtag_ids and returns the top 20 trending videos for each, ranked by a score that combines views, comments, likes and shares.

How does an AI assistant caption a post with suggestions?

With a first step in your own code. easyCoexistence's tools do not fetch suggestions, so your code asks TikTok for them with the token from get_social_credentials; the assistant then keeps the ones that fit the post, writes them into the caption with the # sign and publishes through publish_tiktok_post, now or at a set time. TikTok's publish references note that hashtags in a caption sent through the API render as plain text in the 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

What can easyCoexistence reach, and what is out of its reach?

get_social_credentials gives your own code the account's token and business_id for TikTok paths under business/, so hashtag suggestions work, and so does /business/mention/top_hashtag/list/ where TikTok opens the Mentions API to the account. The Discovery endpoints are out of reach: they take an advertiser's token and advertiser_id rather than the account's. Its dedicated tools return no 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"
}

Common mistakes

  • Pasting name values into a caption as they are. TikTok's example returns names without the # sign, so add it before each one.
  • Ranking suggestions by view_count. TikTok set that field for deprecation by October 9, 2026, so rank by post_count.
  • Taking a suggestion with a post_count of 0 for a hashtag in use. TikTok returns the keyword itself that way when it has nothing to suggest.
  • Asking /discovery/detail/ with a country_code or date_range other than the list call's. TikTok answers with an error, and a hashtag outside the list gets an empty answer.
Doing this with EasyCoexistence

US$ 9 to US$ 0.75 per connection per month, falling as you add connections, with the first 3 days free.

easyCoexistence is a multichannel API and MCP server that connects AI agents such as Claude and ChatGPT to WhatsApp, Instagram, TikTok, Facebook and more. On WhatsApp it uses Coexistence: the business keeps using its number in the WhatsApp Business app while the AI works through Meta's official API.

Frequently asked questions

How many hashtags can a TikTok caption have through the API?

TikTok's publish references set no separate limit for hashtags: they count toward the caption, up to 2,200 UTF-16 characters on a video post and 4,000 on a photo post, where @mentions stop at 30.

Can I get hashtag suggestions in other languages?

Yes. Pass language with the keyword, for example pt-BR, es or ja-JP; the suggestions follow the keyword's language, and English is the default.

Can a TikTok account get trending hashtags without an ad account?

Not from /discovery/trending_list/, which takes an advertiser's token. An account with Advanced Access or a Verified Business Account can read the 20 hashtags used most in posts that mention it.

How much does easyCoexistence cost for a TikTok account?

US$ 9 to US$ 0.75 per connection per month, falling as you add connections, with the first 3 days free; each TikTok account is one connection.

Keep reading

Connect your first channel in two minutes.

No platform reviews to wait for. Connect WhatsApp, Instagram, TikTok or another channel, then ask your AI to post, reply or report, and watch it work.

  • 3 days free
  • Cancel any time
  • Official APIs only
  • Monitored 24/7

Verified on