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を取り、そのインサイトを読み取ります。
- TikTok Creative Center Trending Hashtags でハッシュタグを集め、id をコピーします。
- {"hashtag_id": "7155204034885287979", "country": "US", "time_range": "7d"} を /v1/tiktok-creative-center/trending-hashtag-detail に POST します。
- 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 をボリューム順の順位として読まないでください。スコアは国の規模に対する相対値なので、小さな市場が大きな市場より上に来ることがあります。
関連API
TikTok Creative Center Hashtag Insights API 以外に別の種類の公開TikTok Creative Centerデータが必要な場合は、これらのAPIをご利用ください。
- TikTok Creative Center Top Ads API — 成果の高い広告をキーワードと期間で閲覧し、キャプション、CTR、いいね数、広告動画を返します。
- TikTok Creative Center Ad Analysis API — トップ広告1件を、クリックスルーと視聴維持率のカーブで1秒ごとに分析します。
- TikTok Creative Center Trending Hashtags API — 国別のトレンドハッシュタグのランキングを、投稿数、再生数、人気度カーブとともに取得します。
- TikTok Creative Center Top Videos API — 国別の成果の高い動画のチャートを、再生数とエンゲージメント率とともに取得します。
- TikTok Creator Marketplace API — Creator Marketplace のカードを、フォロワーの属性、再生数の中央値、最低料金とともに取得します。