TikTok のハッシュタグ API:候補とトレンドのハッシュタグ
TikTok の API for Business は、GET /business/hashtag/suggestion/ を通じてハッシュタグを提案します。35 言語のいずれかのキーワードを受け取り、各ハッシュタグの投稿数とともに 10 件を返します。TikTok アカウント自身のトークンを使用します。人気のハッシュタグは GET /discovery/trending_list/ から取得できます。このエンドポイントは、広告主のトークンを使い、国、業界、期間別の上位 200 件をランク付けします。
easyCoexistence は、TikTok の API for Business を通じて TikTok アカウントを接続します。
ハッシュタグ候補エンドポイントの language パラメータが受け付ける言語です。既定値は en で、候補はキーワードと同じ言語で返されます。
認可済みの 1 アカウントが、Accounts API の単一のエンドポイントに送信できるリクエストの数。ハッシュタグ候補も対象です。
前の期間の上位 200 件に含まれていなかった人気のハッシュタグの rank_change の値。
trending_history の最長期間。TikTok が人気のハッシュタグごとに返す日別の順位と再生数です。
/discovery/video_list/ が 1 回の呼び出しで受け取れる hashtag_id の最大数。それぞれについて上位 20 件のトレンド動画を返します。
どの TikTok のエンドポイントが、ハッシュタグを返しますか?
TikTok の API for Business には、投稿のハッシュタグを返す 5 つのエンドポイントがあります。それらは受け取るトークンによって分かれます。TikTok アカウント自身のトークンか、認可された広告アカウントからの広告主のトークンのいずれかです。6 つ目は Marketing API のツールの一つで、代わりに広告ターゲティング用のハッシュタグを推奨します:
候補エンドポイントは、どう呼び出しますか?
アカウントの business_id、キーワード、任意で language を含む GET リクエストで呼び出します。language の 35 個の値は、既定値である en から始まり、es、pt-BR、ja-JP を経て zh-Hant-TW まで並びます。TikTok は候補をキーワードの言語に合わせます。Access-Token ヘッダーには TikTok アカウントのトークンを入れます。TikTok の API リファレンスでは、このエンドポイントは TikTok Accounts の Video Publish 権限の下にあります。動画投稿にも使われるのと同じ権限です:
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 }
]
}
}各候補には何が含まれますか?
各候補には、name(使用するハッシュタグ)と post_count が含まれます。post_count は、そのハッシュタグを使用した投稿の総数です。TikTok は 10 件の候補を返します。キーワードと完全一致するものを先頭に、残りは投稿数順に並びます。この一覧にはトレンドのデータは含まれません。post_count が高いことは、多くの投稿がすでに使っているハッシュタグであることを示します。これは /discovery/trending_list/ が報告する上昇中の順位とは別の指標です。
各エンドポイントには、どのトークンと権限が必要ですか?
パスから想像するより差があるため、構築前に確認してください:
- /business/hashtag/suggestion/:TikTok アカウントのアクセストークンと
business_id。アプリには TikTok Accounts の下の Video Publish が必要です。 - /discovery/
trending_list/、/discovery/detail/、/discovery/video_list/:広告アカウントの認可から得た広告主のアクセストークンとadvertiser_id。アプリには Creative Management の下の Discovery が必要です。 - /business/mention/
top_hashtag/list/:biz.brand.insights スコープ。Advanced Access または Verified Business Account を持つアカウントで使用します。 - /tool/hashtag/recommend/:広告主のトークンと
advertiser_id。TikTok のリファレンスには、このエンドポイントの権限は記載されていません。
トレンドのハッシュタグは何を返しますか?
GET /discovery/trending_list/ では、discovery_type に HASHTAG を指定します。これは唯一の値です。任意で country_code、category_name、date_range を受け付けます。category_name は、FOOD_AND_BEVERAGE や COOKING のような、レベル 1 またはレベル 2 の業界を受け付けます。ハッシュタグごとに次を返します:
- カテゴリー内の
rank_positionと、前の期間に対するrank_change。上昇したときは正の値、下落したときは負の値、上位 200 件に入っていなかった場合は NEW です。 - 選んだ国と期間での再生数と投稿数。
views_global_lifetimeとposts_global_lifetimeを併せて返します。 top_country_list:そのハッシュタグが最も人気のある上位 5 つの地域。trending_history:最大 30 日分のrank_position_dailyとviews_daily。ハッシュタグがトレンド入りしなかった日、または 1,000 回未満しか再生されなかった日は null です。
人気のハッシュタグを一つ掘り下げるには、どうしますか?
同じ広告主のトークンで、さらに 2 つの呼び出しを行います。/discovery/detail/ は、一覧から hashtag_id を受け取り、一覧の呼び出しと同じ country_code と date_range を指定します。さらに hashtag_status を返します。広告作成で利用可能なときは ONLINE です。また視聴者の年齢を、18-24、25-34、35+ の 3 つの区分で返します。hashtag_status が OFFLINE の場合、または推定オーディエンスが 1,000 未満の場合は空欄になります。/discovery/video_list/ は最大 10 個の hashtag_id を受け取り、それぞれについて上位 20 本のトレンド動画を返します。動画は、再生数、コメント、いいね、シェアを組み合わせたスコアで順位付けされます。
AI アシスタントは、候補を使って投稿のキャプションをどう作りますか?
最初のステップをご自身のコードで行います。easyCoexistence のツールは候補を取得しないため、コードが get_social_credentials のトークンを使って TikTok に問い合わせます。その後、アシスタントが投稿に合うものを残し、# 記号を付けてキャプションに書き込み、publish_tiktok_post を通じて、今すぐ、または指定した時刻に投稿します。TikTok の公開に関するリファレンスでは、API で送信されたキャプション内のハッシュタグはアプリ上でプレーンテキストとして表示される、と記されています:
easyCoexistence が届く範囲と、届かない範囲は?
get_social_credentials は、business/ 配下の TikTok パス用のアカウントのトークンと business_id を、ご自身のコードに渡します。そのため、ハッシュタグ候補は機能します。TikTok が Mentions API をそのアカウントに開放している場合は、/business/mention/top_hashtag/list/ も機能します。Discovery のエンドポイントは届きません。これらはアカウント自身のトークンではなく、広告主のトークンと advertiser_id を受け取るためです。専用ツールは、ハッシュタグを返しません。
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"
}よくある間違い
- 名前の値をそのままキャプションに貼り付けること。TikTok の例では、name の値に # 記号が付いていません。各値の前に # を付けてください。
- view_count で候補を並べ替えること。TikTok はこのフィールドを 2026 年 10 月 9 日までに廃止する予定です。そのため、post_count で並べ替えてください。
- すでに使われているハッシュタグとして、post_count が 0 の候補を採用すること。TikTok は提案できるものがないとき、キーワード自体をこの形式で返します。
- /discovery/detail/ に、一覧の呼び出しとは異なる country_code や date_range を指定すること。TikTok はエラーを返し、一覧にないハッシュタグは空の応答になります。
ご自身のコードが get_social_credentials のトークンを使ってハッシュタグ候補を取得し、Claude、ChatGPT、またはそのコードが、キャプションに書き込んで、publish_tiktok_post で投稿を公開またはスケジュールします。各接続は 24 時間体制で監視されます。料金は接続 1 件あたり月額 US$ 9 から、接続を増やすほど下がり US$ 0.75 まで。最初の 3 日間は無料です。
よくある質問
API 経由で、TikTok のキャプションに付けられるハッシュタグは何個までですか?
TikTok の公開に関するリファレンスでは、ハッシュタグに個別の上限は設けられていません。ハッシュタグはキャプションの文字数に含まれ、動画投稿では最大 2,200 UTF-16 文字、写真投稿では 4,000 文字です。@メンションは 30 件が上限です。
他の言語でハッシュタグ候補を取得できますか?
はい。language をキーワードと一緒に渡します。例:pt-BR、es、ja-JP。候補はキーワードの言語に従い、既定値は英語(en)です。
広告アカウントがなくても、TikTok アカウントはトレンドのハッシュタグを取得できますか?
/discovery/trending_list/ からは取得できません。このエンドポイントは広告主のトークンを必要とします。Advanced Access または Verified Business Account を持つアカウントは、そのアカウントに言及した投稿で最もよく使われた 20 件のハッシュタグを読み取れます。
easyCoexistence の料金は、TikTok アカウント 1 件あたりいくらですか?
接続 1 件あたり月額 US$ 9 から、接続を増やすほど下がり US$ 0.75 まで。最初の 3 日間は無料です。TikTok アカウント 1 件が接続 1 件に相当します。
続きを読む
最初のチャンネルを 2 分で接続しましょう。
プラットフォームの審査を待つ必要はありません。WhatsApp、Instagram、TikTok などのチャンネルを接続して、AI に投稿、返信、レポートを任せてみてください。
- 3 日間無料
- いつでも解約可能
- 公式 API のみ使用
- 24/7 監視
確認日