tiktok/
comments

TikTok動画の直接URLから公開トップレベルコメントを収集し、正規化されたテキスト、投稿者、いいね数、返信数、メンション、クリエイターの反応フラグを返します。

TikTok Comments API

オーディエンスの声
フィードバック調査
コメントの優先順位付け
結果1件あたり0.25クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

TikTok Comments

TikTokコメントは、動画に対する公開の反応で、テキスト、投稿者情報、表示中のいいね数、返信数、メンション、クリエイターの反応を含みます。これらの会話は、オーディエンスのフィードバック分析、繰り返し現れるテーマの調査、感情分析、コンテンツへの反応のモニタリングに活用できます。

TikTok Comments API の主な機能

  • 複数動画からのコメント収集1回のリクエストで、複数のTikTok動画の直接URLから公開トップレベルコメントを収集します。
  • 追跡可能なコメントレコードコメントID、元の動画、投稿者、投稿日時により、フィードバックの出どころを追跡できます。
  • コメント本文とメンションコメント本文とメンションを抽出し、トピック、感情、ニーズの分析に活用できます。
  • 公開されている反応の指標表示中のいいね数、返信数、ピン留めの状態、クリエイターによるいいねの状態を各コメントレコードに含めます。
  • 動画ごとの結果上限results_limit で動画ごとのサンプル数を割り当てられます。

TikTok Comments API のパラメータ

パラメータ必須説明
urls必須必須。公開トップレベルコメントの収集に使うTikTok動画の直接URLのリストです。
results_limit任意動画URLごとに取得するトップレベルコメントの上限数(正の数)です。デフォルトは100です。

TikTok Comments API の使い方

調査対象の動画と動画ごとのコメントサンプル数を決めて、オーディエンスのフィードバック収集を始めます。

  1. 対象コンテンツを選び、動画ごとの results_limit を決めます。
  2. urls と results_limit を /v1/tiktok/comments に 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/comments" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.tiktok.com/@nasa/video/7412345678901234567"],"results_limit":100}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

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

  • 顧客の声(VoC)調査: オーディエンス自身の言葉から、繰り返し現れるニーズ、質問、称賛、提案を見つけます。
  • ディスカッションの確認キュー: コメント本文、表示中のいいね数、返信数を使って、サポート、調査、ソーシャルリスニングで確認するコメントを整理します。
  • クリエイティブへの反応分析: 動画ごとの反応を比較し、共感、議論、会話を生み出すアイデアを見つけます。
  • クリエイターの反応の分析: ピン留め、クリエイターによるいいね、返信数を調べ、クリエイターがコメント欄をどのように形成しているかを把握します。

TikTok Comments API 活用のヒント

  • 動画の重要度に応じて results_limit を割り当て、URL数を掛けてバッチの規模を見積もってください。
  • likes_count は支持の度合い、replies_count は議論の深さとして、別々に分析してください。
  • is_pinned と creator_liked は、クリエイターが積極的に取り上げたフィードバックの指標として活用してください。
  • コメントの id で重複を排除し、出どころを明確にするため動画URLと collected_at を保持してください。
  • ダッシュボード、チケット、レポートに表示する前にコメント本文をエスケープし、確認用に元のテキストも保持してください。
  • 反応の指標で確認の順序を決めてから、元のコメント本文をテーマや感情で分類してください。

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

  • TikTok Profiles API — ユーザー名から、公開プロフィールのアカウント情報、プロフィール文、アカウント属性、オーディエンス数を取得します。
  • TikTok Hashtags API — 指定したハッシュタグの公開動画、クリエイター、メディア、サウンド、エンゲージメントを取得します。
  • TikTok Videos API — 動画URLから、クリエイター、キャプション、メディア、音楽、タグ、メンション、エンゲージメントを取得します。
  • TikTok Search API — キーワードで公開動画を検索します。対応する並び順と公開日のフィルターを指定できます。
  • TikTok Comment Replies API — TikTok動画のURLとコメントIDを使って既知のコメントへの公開返信を取得し、投稿者、エンゲージメント、タイムスタンプ、親コメントの情報を返します。
  • TikTok Comment Keywords API — 動画のコメントで最も多く出てくるキーワードを、その根拠となるコメントとともに探します。

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

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

TikTok Comments API — よくある質問

TikTok Comments APIは、TikTok動画の直接URLから公開表示されているトップレベルコメントを収集するAPIです。正規化されたテキスト、投稿者の詳細、いいね数と返信数、メンション、クリエイターの反応フラグを返しますが、返信の本文は含まれません。

1つ以上のTikTok動画の直接URLを urls 配列で送信し、results_limit で動画ごとに取得したいコメント数を指定してください。

できます。urls には複数の動画リンクを指定でき、同じ非同期タスク内で各動画の公開トップレベルコメントが処理されます。

results_limit は入力した動画ごとに個別に適用され、デフォルトは100です。値を100にして3本の動画を指定すると、動画ごとに最大100件のトップレベルコメントをリクエストします。

結果には、コメントID、本文、投稿日時、元の動画URLに加え、ID、ユーザー名、表示名、プロフィールURL、アバター、認証状態などの公開投稿者フィールドが含まれます。

公開されている反応の分析用に、いいね数、返信数、メンション、クリエイターによるいいねの状態、ピン留めの状態が含まれる場合があります。

表示中のいいね数と返信数で並べ替えやフィルタリングを行い、ピン留めとクリエイターによるいいねの状態を補足情報として使ってください。これらの指標は公開された反応を表すもので、それだけでコメントの感情を判定するものではありません。

返された正規化コメント結果1件につき0.25クレジットです。