TikTok Creative Center Trending Hashtags
Creative Centerのトレンドハッシュタグは、過去7日、30日、90日のあいだに国内で最も注目を集めたタグを順位づけしたもので、各タグに順位、投稿数、再生回数、日ごとの人気度カーブが付きます。このランキングを見ると、その市場でどんな話題が伸びているか、各タグがどれだけ急上昇したか、まだ上り調子のうちに乗る価値のあるトレンドはどれかがわかります。
TikTok Creative Center Trending Hashtags API の主な機能
- 国ごとに1つのランキングcountry には US、GB、JP のような2文字のコードを指定でき、市場ごとに別の順位が返ります。
- 7日・30日・90日のリストtime_range でランキングの集計期間を選びます。期間ごとに別のリストになります。
- 投稿数と再生回数metrics.posts_count と metrics.views_count で、Creative Centerが報告するタグごとのボリュームがわかります。
- 日別の人気度カーブpopularity_curve は1日ごとの日付つきの値を0〜100の尺度で返すので、タグの推移がランキングの行と一緒に届きます。
- タグ名、リンク、ID各行には # なしの name、tiktok.com/tag の url、Hashtag Insights が hashtag_id として受け取る id が入ります。
TikTok Creative Center Trending Hashtags API のパラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
country | 任意 | 市場の2文字の国コードです(US、GB、JP など)。デフォルトは US です。 |
time_range | 任意 | ランキングが対象とする期間です。7d(デフォルト)、30d、90d から指定します。 |
results_limit | 任意 | 取得するハッシュタグの件数です。1〜100の範囲で指定し、デフォルトは20です。 |
TikTok Creative Center Trending Hashtags API の使い方
国と期間を選んで、ランキングを読み取ります。
- {"country": "US", "time_range": "7d", "results_limit": 20} を /v1/tiktok-creative-center/trending-hashtags に POST します。
- status が succeeded になるまで GET /v1/tasks/{task_id} をポーリングします。
- results.items から順位順にハッシュタグを読み取り、has_more が true の間は results.next_cursor を渡して続きを取得します。
curl -X POST "https://api.socq.ai/v1/tiktok-creative-center/trending-hashtags" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"country":"US","time_range":"7d","results_limit":20}'
# Each item has rank, metrics and a dated popularity_curve.TikTok Creative Center Trending Hashtags API の主なユースケース
- 毎日の新規ランクイン追跡: 毎日のリストを collected_at とともに保存し、前回のスナップショットと id を突き合わせて、どのハッシュタグが国のランキングに入った、あるいは外れたかを見ます。
- 市場別のハッシュタグ候補リスト: 対象の国ごとに同じ time_range で取得し、リストを並べて、ローカライズしたキャンペーンごとに使うタグを選びます。
- 一時的な急上昇か定着かの見極め: 同じ国の 7d と 90d のリストを比べます。短い期間のリストにしか出ないタグは1週間限りの急上昇で、両方で上位のタグは数か月にわたって注目を保っています。
TikTok Creative Center Trending Hashtags API 活用のヒント
- スナップショットは country、time_range、collected_at とあわせて保存してください。順位は、その順位が出たリストの中でしか意味を持ちません。
- id を Hashtag Insights に渡すときは、同じ country と time_range を使ってください。
- results_limit を変えて何度もリクエストするのではなく、100件を1回取得してローカルで絞り込んでください。リクエストは返された行数に応じて課金されます。
関連API
TikTok Creative Center Trending Hashtags API 以外に別の種類の公開TikTok Creative Centerデータが必要な場合は、これらのAPIをご利用ください。
- TikTok Creative Center Top Ads API — 成果の高い広告をキーワードと期間で閲覧し、キャプション、CTR、いいね数、広告動画を返します。
- TikTok Creative Center Ad Analysis API — トップ広告1件を、クリックスルーと視聴維持率のカーブで1秒ごとに分析します。
- TikTok Creative Center Hashtag Insights API — トレンドハッシュタグ1つについて、人気度カーブ、上位の国、サンプル動画を詳しく調べます。
- TikTok Creative Center Top Videos API — 国別の成果の高い動画のチャートを、再生数とエンゲージメント率とともに取得します。
- TikTok Creator Marketplace API — Creator Marketplace のカードを、フォロワーの属性、再生数の中央値、最低料金とともに取得します。