tiktok/
hashtag-detail

1回のリクエストで最大20個のTikTokハッシュタグについて、動画数と総再生回数を確認できます。ハッシュタグごとのIDとタグページのリンクも付くので、並べて比較できます。

TikTok Hashtag Views API

最大20ハッシュタグ
総再生回数
動画数
結果1件あたり0.5クレジット
準備完了
準備完了

パラメータを入力してリクエストを送信してください。タスクのステータスと正規化された結果がここに表示されます。

README

SocQ 編集 · 更新

TikTok Hashtag Views

TikTokのハッシュタグページには、そのタグを使った公開動画がすべて集計され、動画数と、それらの動画が集めた再生回数という2つの累計値が表示されます。この2つを合わせて見ると話題の大きさと混み具合がわかり、動画1本あたりの再生回数からは、そのタグの動画が平均してどのくらい見られているかの目安も得られます。

TikTok Hashtag Views API の主な機能

  • 1リクエストで最大20ハッシュタグ#の有無を問わず1〜20個の名前を送ると、存在するハッシュタグごとに1件のレコードが返ります。
  • 合計値は整数で取得metrics.posts_count と metrics.views_count は、省略表記の文字列ではなく単純な整数で返るため、そのまま並べ替えや割り算に使えます。
  • ハッシュタグIDとタグページのリンクid にはTikTokの数値のハッシュタグID、url にはタグページが入り、実行をまたいで結合できるキーになります。

TikTok Hashtag Views API のパラメータ

パラメータ必須説明
hashtags必須ハッシュタグ名を1〜20個指定します。先頭の # は付けても付けなくてもかまいません。

TikTok Hashtag Views API の使い方

ハッシュタグのリストを送信して、タグごとに1件のレコードを読み取ります。

  1. {"hashtags": ["cooking", "booktok"]} を /v1/tiktok/hashtag-detail に POST します。
  2. status が succeeded になるまで GET /v1/tasks/{task_id} をポーリングします。
  3. results.items から、各ハッシュタグの name、metrics.posts_count、metrics.views_count を読み取ります。
curl -X POST "https://api.socq.ai/v1/tiktok/hashtag-detail" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"hashtags":["cooking","booktok"]}'

# metrics.posts_count is the video count; metrics.views_count is the total views.

TikTok Hashtag Views API の主なユースケース

  • キャンペーン用ハッシュタグの絞り込み: 候補のタグを1回のリクエストにまとめ、posts_count で混み具合、views_count でリーチを比べてから、使うタグの組み合わせを決めます。
  • ブランド専用ハッシュタグの監視: キャンペーンのタグを定期的に取得して、施策のたびに動画数と総再生回数がどれだけ伸びたかをグラフにします。
  • 話題の規模のリサーチ: ジャンル、トレンド、社会的なテーマを象徴するタグを調べて合計値を比べると、そのテーマのコンテンツがどこに集中しているかがわかります。

TikTok Hashtag Views API 活用のヒント

  • 話題の規模を測るために、ハッシュタグをまたいで views_count を足し合わせないでください。複数のタグを付けた動画は、それぞれのタグで重複して数えられます。タグを並べて比べるか、最大の値を使ってください。
  • views_count を posts_count で割るのは、posts_count があり0より大きいときだけにしてください。動画1本あたりの平均再生回数で順位をつけると、規模が大きく違うタグも比べられます。
  • タグを追跡するときは、結果を collected_at の時刻とあわせて保存してください。リクエストごとに返るのは現在の合計値なので、過去のスナップショットを残しておかないと伸びは見えません。
  • 結果を入力リストと突き合わせるときは、位置ではなく name か id を使ってください。存在しないハッシュタグは結果から除かれるため、出力が入力より短くなることがあります。

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

  • TikTok Hashtags API — 指定したハッシュタグの公開動画、クリエイター、メディア、サウンド、エンゲージメントを取得します。
  • TikTok Search API — キーワードで公開動画を検索します。対応する並び順と公開日のフィルターを指定できます。
  • TikTok Live Room Info API — ルームIDと配信者IDの組み合わせで既知のライブ配信ルーム1件を検索し、ステータス、配信者情報、カバーメディア、視聴者数を返します。
  • TikTok Search Users API — キーワードで公開TikTokアカウントを検索します。
  • TikTok Top Search API — キーワードで動画と画像投稿を検索し、キャプション、クリエイター、インタラクション数を返します。
  • TikTok Trending Searches API — TikTokで今日トレンドになっている検索ワードを、ランキング順に取得します。

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

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

TikTok Hashtag Views API — よくある質問

TikTok Hashtag Views APIは、最大20個のTikTokハッシュタグの合計値を名前で調べるためのプログラムインターフェースです。ハッシュタグごとのID、ページURL、動画数、総再生回数を返します。

ハッシュタグ名を送り、総再生回数は metrics.views_count、そのタグを使った動画の数は metrics.posts_count で読み取ります。どちらもハッシュタグ全体の累計値です。

レスポンスには、ハッシュタグごとに metrics.posts_count と並んで metrics.views_count が入ります。TikTokがそのタグについて数値を公表していない場合、その項目は null で返ります。

最大20個で、#の有無は問いません。存在するハッシュタグごとにレコードが返るので、候補のリスト全体を1回の結果で比較できます。

結果から除かれ、課金されません。リクエストに含まれる他のハッシュタグは通常どおり返ります。どのハッシュタグも存在しない場合は、料金はかかりません。

このエンドポイントが返すのは collected_at の時刻つきの現在の合計値だけで、履歴はありません。定期的に実行してスナップショットを保存し、伸びをグラフにしてください。

いいえ、取得できるのはハッシュタグの合計値と識別子だけです。動画そのものは TikTok Hashtags で収集してください。

存在するハッシュタグ1つにつき0.5クレジットです。存在するタグが20個なら10クレジットで、一致するものがないリクエストは無料です。