tiktok/
hashtags

1つ以上のハッシュタグから公開TikTok動画を収集し、正規化されたクリエイター、キャプション、メディア、サウンド、エンゲージメント、一致したハッシュタグの情報を返します。

TikTok Hashtags API

キャンペーンの追跡
コミュニティのコンテンツ
ハッシュタグの比較
結果1件あたり0.7クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

TikTok Hashtags

TikTokハッシュタグは、共通のフレーズ、キャンペーン、イベント、関心事を軸に公開動画を結び付けるトピックラベルで、クリエイター、コンテンツ、メディア、サウンド、エンゲージメントの情報を伴います。これらのレコードは、トレンドの発見、トピックのモニタリング、キャンペーン調査、オーディエンス分析に活用できます。

TikTok Hashtags API の主な機能

  • 複数ハッシュタグの並行収集キャンペーン、ブランド、コミュニティの複数のハッシュタグを並行して送信できます。
  • ハッシュタグ入力の正規化#campaign と campaign を一貫したタグ形式に正規化します。
  • ハッシュタグごとの結果上限results_limit をタグごとに適用し、サンプル数を明確に計画できます。
  • 一致したハッシュタグの情報すべての動画に matched_hashtag を付与し、送信したグループを保持します。
  • 比較しやすい動画レコードハッシュタグの再生数、クリエイター、クリエイティブ要素、動画のエンゲージメントを同じデータ形式で比較できます。

TikTok Hashtags API のパラメータ

パラメータ必須説明
hashtags必須必須。明示的なハッシュタグ値のリストです。先頭の # は任意です。
results_limit任意ハッシュタグごとに取得する動画の上限数(正の数)です。デフォルトは100です。

TikTok Hashtags API の使い方

追跡したいタグを洗い出し、タグごとの動画サンプル数を決めて、グループ比較にすぐ使えるデータセットを作成します。

  1. キャンペーン、ブランド、コミュニティのタグを集め、space と #space のような表記を正規化して重複を排除します。
  2. hashtags と results_limit を /v1/tiktok/hashtags に POST し、返された task_id を保存します。
  3. タスクが成功または失敗するまで /v1/tasks/{task_id} をポーリングします。
  4. 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 true

TikTok Hashtags API の主なユースケース

  • UGCキャンペーンの追跡: 公式キャンペーンタグへの参加投稿を収集し、クリエイターのリーチ、コンテンツの方向性、エンゲージメントの分布を調べます。
  • ブランドタグのアセット一覧: ブランドや商品のハッシュタグが付いた動画を、マーケティングチームやソーシャルチーム向けの検索可能なライブラリにまとめます。
  • 関心コミュニティのプロファイリング: クリエイター、キャプション、音楽、エンゲージメントから、関心タグを取り巻くコンテンツ文化を把握します。
  • ハッシュタググループの比較: 複数のタグを並行して収集し、グループ間でクリエイターの構成、クリエイティブ要素、パフォーマンスを比較します。

TikTok Hashtags API 活用のヒント

  • 先頭の # を取り除き、大文字・小文字を統一して重複を排除し、各タグのサンプルグループを明確にしてください。
  • タグ数×results_limit はリクエスト上の最大値として扱い、保証される結果件数とは考えないでください。
  • matched_hashtag を保持しておくと、複数のグループで収集された動画でも出どころを完全に追跡できます。
  • ハッシュタググループを比較する際は、同じ results_limit と取得タイミングを使用してください。
  • ハッシュタグの再生数と各動画のエンゲージメント指標は、それぞれ別の特定時点の値として扱ってください。
  • 頻出するクリエイターを Profiles のデータで補完すると、各タグに集まるクリエイターの構成を把握できます。

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のデータを、対応する他のソーシャルプラットフォームの公開データと組み合わせられます。

TikTok Hashtags API — よくある質問

TikTok Hashtags APIは、指定した1つ以上のTikTokハッシュタグについて、公開アクセス可能な動画を収集するAPIです。正規化された動画、クリエイター、キャプション、メディア、サウンド、エンゲージメント、一致したハッシュタグのデータを返します。

タグ名を hashtags 配列に入れてください。fyp と #fyp のどちらの形式も受け付け、先頭の # は収集前に正規化されます。

できます。hashtags には複数のタグ名を指定でき、同じ非同期タスク内でタグごとに収集されます。

results_limit は入力したタグごとに個別に適用され、デフォルトは100です。値を100にして3つのタグを指定すると、タグごとに最大100件の動画をリクエストします。

matched_hashtag には動画を取得したときの入力タグが記録されます。公開されているハッシュタグの再生数と組み合わせて、出どころの特定やグループ別の分析に使えます。

結果には、動画ID、URL、キャプション、公開日時、クリエイター、公開エンゲージメント、ハッシュタグ、メンション、メディア、音楽、取得日時が含まれます。

結果を matched_hashtag でグループ化し、クリエイターの構成、キャプション、音楽、ハッシュタグの再生数、動画のエンゲージメントをグループ間で比較してください。

返された正規化ハッシュタグ動画結果1件につき0.7クレジットです。