TikTok Hashtags
TikTokハッシュタグは、共通のフレーズ、キャンペーン、イベント、関心事を軸に公開動画を結び付けるトピックラベルで、クリエイター、コンテンツ、メディア、サウンド、エンゲージメントの情報を伴います。これらのレコードは、トレンドの発見、トピックのモニタリング、キャンペーン調査、オーディエンス分析に活用できます。
TikTok Hashtags API の主な機能
- 複数ハッシュタグの並行収集キャンペーン、ブランド、コミュニティの複数のハッシュタグを並行して送信できます。
- ハッシュタグ入力の正規化#campaign と campaign を一貫したタグ形式に正規化します。
- ハッシュタグごとの結果上限results_limit をタグごとに適用し、サンプル数を明確に計画できます。
- 一致したハッシュタグの情報すべての動画に matched_hashtag を付与し、送信したグループを保持します。
- 比較しやすい動画レコードハッシュタグの再生数、クリエイター、クリエイティブ要素、動画のエンゲージメントを同じデータ形式で比較できます。
TikTok Hashtags API のパラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
hashtags | 必須 | 必須。明示的なハッシュタグ値のリストです。先頭の # は任意です。 |
results_limit | 任意 | ハッシュタグごとに取得する動画の上限数(正の数)です。デフォルトは100です。 |
TikTok Hashtags API の使い方
追跡したいタグを洗い出し、タグごとの動画サンプル数を決めて、グループ比較にすぐ使えるデータセットを作成します。
- キャンペーン、ブランド、コミュニティのタグを集め、space と #space のような表記を正規化して重複を排除します。
- hashtags と results_limit を /v1/tiktok/hashtags に POST し、返された task_id を保存します。
- タスクが成功または失敗するまで /v1/tasks/{task_id} をポーリングします。
- data.results.items を読み取ります。has_more が true の場合は next_cursor で続きを取得します。
curl -X POST "https://api.socq.ai/v1/tiktok/hashtags" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"hashtags":["space","#astronomy"],"results_limit":100}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueTikTok Hashtags API の主なユースケース
- UGCキャンペーンの追跡: 公式キャンペーンタグへの参加投稿を収集し、クリエイターのリーチ、コンテンツの方向性、エンゲージメントの分布を調べます。
- ブランドタグのアセット一覧: ブランドや商品のハッシュタグが付いた動画を、マーケティングチームやソーシャルチーム向けの検索可能なライブラリにまとめます。
- 関心コミュニティのプロファイリング: クリエイター、キャプション、音楽、エンゲージメントから、関心タグを取り巻くコンテンツ文化を把握します。
- ハッシュタググループの比較: 複数のタグを並行して収集し、グループ間でクリエイターの構成、クリエイティブ要素、パフォーマンスを比較します。
TikTok Hashtags API 活用のヒント
- 先頭の # を取り除き、大文字・小文字を統一して重複を排除し、各タグのサンプルグループを明確にしてください。
- タグ数×results_limit はリクエスト上の最大値として扱い、保証される結果件数とは考えないでください。
- matched_hashtag を保持しておくと、複数のグループで収集された動画でも出どころを完全に追跡できます。
- ハッシュタググループを比較する際は、同じ results_limit と取得タイミングを使用してください。
- ハッシュタグの再生数と各動画のエンゲージメント指標は、それぞれ別の特定時点の値として扱ってください。
- 頻出するクリエイターを Profiles のデータで補完すると、各タグに集まるクリエイターの構成を把握できます。
関連API
TikTok Hashtags API 以外に別の種類の公開TikTokデータが必要な場合は、これらのAPIをご利用ください。
- TikTok Comments API — 公開トップレベルコメント、投稿者、エンゲージメント、メンション、クリエイターとのやり取りを示すフラグを取得します。
- TikTok Videos API — 動画URLから、クリエイター、キャプション、メディア、音楽、タグ、メンション、エンゲージメントを取得します。
- TikTok Search API — キーワードで公開動画を検索します。対応する並び順と公開日のフィルターを指定できます。
- TikTok Live Room Info API — ルームIDと配信者IDの組み合わせで既知のライブ配信ルーム1件を検索し、ステータス、配信者情報、カバーメディア、視聴者数を返します。
- TikTok Search Users API — キーワードで公開TikTokアカウントを検索します。
- TikTok Hashtag Views API — 最大20個のハッシュタグについて、動画の総数と総再生数をまとめて照会します。
- TikTok Profiles 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 Top Search 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 Trending Searches API
- TikTok Creator Search Insights API
- TikTok Live Ranking API
- TikTok Live Shopping API
- TikTok Fake Views Checker API
- TikTok Comment Keywords API