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件のレコードを読み取ります。
- {"hashtags": ["cooking", "booktok"]} を /v1/tiktok/hashtag-detail に POST します。
- status が succeeded になるまで GET /v1/tasks/{task_id} をポーリングします。
- 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 を使ってください。存在しないハッシュタグは結果から除かれるため、出力が入力より短くなることがあります。
関連API
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 Profiles API
- TikTok Comments API
- TikTok Videos API
- TikTok Comment Replies API
- TikTok Followers List API
- TikTok Following List API
- TikTok User Videos API
- TikTok Trending Feed API
- TikTok Video Transcript API
- TikTok Song API
- TikTok Song Videos API
- TikTok Popular Songs API
- TikTok User Live API
- TikTok Audience Demographics API
- TikTok Similar Accounts API
- TikTok Reposts API
- TikTok Playlists API
- TikTok Sound Search API
- TikTok Live Search API
- TikTok Photo Search API
- TikTok Creator Search Insights API
- TikTok Live Ranking API
- TikTok Live Shopping API
- TikTok Fake Views Checker API
- TikTok Comment Keywords API