tiktok-creative-center/
trending-hashtags

TikTok Creative Centerで国ごとにトレンド入りしているハッシュタグのランキングを取得できます。投稿数と再生回数、7日・30日・90日の日別の人気度カーブが付きます。

TikTok Creative Center Trending Hashtags API

国別ランキング
7日・30日・90日
日別の人気度カーブ
結果1件あたり0.5クレジット
準備完了
README

SocQ 編集 · 更新

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 の使い方

国と期間を選んで、ランキングを読み取ります。

  1. {"country": "US", "time_range": "7d", "results_limit": 20} を /v1/tiktok-creative-center/trending-hashtags に POST します。
  2. status が succeeded になるまで GET /v1/tasks/{task_id} をポーリングします。
  3. 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回取得してローカルで絞り込んでください。リクエストは返された行数に応じて課金されます。

TikTok Creative Center Trending Hashtags API 以外に別の種類の公開TikTok Creative Centerデータが必要な場合は、これらのAPIをご利用ください。

他のプラットフォームを見る

TikTok Creative Centerのデータを、対応する他のソーシャルプラットフォームの公開データと組み合わせられます。

TikTok Creative Center Trending Hashtags API — よくある質問

TikTok Creative Center Trending Hashtags APIは、TikTok Creative Centerで国ごとにトレンドとして順位づけされているハッシュタグを、7日、30日、90日の期間で取得するためのプログラムインターフェースです。各ハッシュタグの順位、投稿数、再生回数、日別の人気度カーブを返します。

country に US、GB、JP のような2文字のコードを指定します。デフォルトは US で、市場ごとに別のランキングがあります。ランキングが公開されていない市場では結果が0件になり、課金されません。

いま上り調子のものを見たいなら 7d、数か月にわたって注目を保っているタグを見たいなら 90d を使います。期間ごとに別のリストなので、同じハッシュタグでも順位は期間によって変わります。

国と期間ごとに最大100件で、results_limit(デフォルトは20)で指定します。課金は返された行数に応じて1行0.5クレジットなので、100件のフルリストなら50クレジットです。

popularity_curve の末尾を見てください。値は1日に1つ、0〜100で並びます。最終日にも上がり続けていれば勢いがあり、以前のピークから下がっていれば、順位にかかわらず落ち着きつつあります。

できません。リクエストで指定できるのは country、time_range、results_limit だけです。新規ランクインを見つけるには、毎日のリストを保存して、前回のリストとハッシュタグの id を比べてください。

TikTokは更新スケジュールを公開していません。人気度カーブは日単位で動き、すべてのレコードに collected_at が付くので、国ごとに1日1回リクエストすれば推移を追えます。

いいえ。必要な認証情報はSocQのAPIキーだけです。