tiktok-creative-center/
trending-hashtag-detail

Creative CenterのIDを指定して、トレンドのTikTokハッシュタグ1件を調べます。投稿数と再生回数、日別の人気度カーブ、スコア順の人気の国、サンプル動画のIDを取得できます。

TikTok Creative Center Hashtag Insights API

ハッシュタグIDを入力
人気の国
サンプル動画
1リクエストあたり0.5クレジット
準備完了
README

SocQ 編集 · 更新

TikTok Creative Center Hashtag Insights

Creative Centerのハッシュタグインサイトは、ある市場でトレンド入りした1つのタグを詳しく見るもので、投稿数と再生回数、日別の人気度カーブ、国の規模に対して最も人気のある国、そのタグを使ったサンプル動画が含まれます。これらを合わせると、トレンドがどう動いているか、ほかのどこで反響があるか、どんなコンテンツが支えているかがわかります。

TikTok Creative Center Hashtag Insights API の主な機能

  • IDで1つのタグを照会hashtag_id に Trending Hashtags の結果の id を渡すと、指定した country と time_range でのそのタグ1件のレコードが返ります。
  • 期間内のカーブと件数popularity_curve は1日ごとの日付つきの値を0〜100で返し、横に metrics.posts_count と metrics.views_count が並びます。
  • スコア順の国top_countries は country_code と score をスコアの高い順に並べたもので、スコアは国の規模に対する人気を表します。
  • サンプル動画のIDvideo_ids にそのタグを使った動画が並び、トレンドがどんなコンテンツの上に成り立っているかがわかります。

TikTok Creative Center Hashtag Insights API のパラメータ

パラメータ必須説明
hashtag_id必須TikTok Creative Center Trending Hashtags の結果にあるハッシュタグIDです。
country任意市場の2文字の国コードです(US、GB、JP など)。デフォルトは US です。
time_range任意分析する期間です。7d(デフォルト)、30d、90d から指定します。

TikTok Creative Center Hashtag Insights API の使い方

トレンドランキングからハッシュタグIDを取り、そのインサイトを読み取ります。

  1. TikTok Creative Center Trending Hashtags でハッシュタグを集め、id をコピーします。
  2. {"hashtag_id": "7155204034885287979", "country": "US", "time_range": "7d"} を /v1/tiktok-creative-center/trending-hashtag-detail に POST します。
  3. status が succeeded になるまで GET /v1/tasks/{task_id} をポーリングし、results.items の1件のレコードを読み取ります。
curl -X POST "https://api.socq.ai/v1/tiktok-creative-center/trending-hashtag-detail" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"hashtag_id":"7155204034885287979","country":"US","time_range":"7d"}'

# top_countries lists {country_code, score}; video_ids lists example videos.

TikTok Creative Center Hashtag Insights API の主なユースケース

  • トレンドに乗るか見送るかの判断: タグにキャンペーンを賭ける前に、popularity_curve と metrics の件数を読み、カーブが最終日にもまだ上がっているかを確かめます。
  • 展開先の市場の選定: 自国でトレンド入りしているタグについて、top_countries でほかにどの国のスコアが高いかを調べ、ローカライズ投稿の候補に挙げます。

TikTok Creative Center Hashtag Insights API 活用のヒント

  • id の取得元のランキングと同じ country と time_range を渡してください。そうすれば、タグを選んだリストと同じ条件の数値になります。
  • top_countries をボリューム順の順位として読まないでください。スコアは国の規模に対する相対値なので、小さな市場が大きな市場より上に来ることがあります。

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

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

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

TikTok Creative Center Hashtag Insights API — よくある質問

TikTok Creative Center Hashtag Insights APIは、Creative CenterのID、国、期間で指定したトレンドのTikTokハッシュタグ1件のインサイトレコードを取得するためのプログラムインターフェースです。投稿数と再生回数、日別の人気度カーブ、スコア順の人気の国、サンプル動画のIDを返します。

Trending Hashtags の結果の id フィールドから、照会する国のランキングで取得します。5〜32桁の数字の文字列で、それ以外の形式は400エラーで拒否されます。

ここではできません。このエンドポイントが受け付けるのは数値IDだけです。名前でタグの動画数と総再生回数を調べるには、TikTok Hashtag Views API を使ってください。

ランキングの行では null の top_countries と video_ids です。順位はランキングに属するものなので、ここでは rank は null になります。順位は Trending Hashtags の結果から控えておいてください。

そのハッシュタグがその国でどれだけ人気かを、国の規模に対する相対値で表したもので、リストはスコアの高い順です。そのため、小さな市場が大きな市場より上に来ることがあります。

タスクは失敗し、全額が返金されます。成功したリクエストは、返ってくる video_ids の数にかかわらず、1回につき0.5クレジットです。