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 の使い方
調査対象の動画と動画ごとのコメントサンプル数を決めて、オーディエンスのフィードバック収集を始めます。
- 対象コンテンツを選び、動画ごとの results_limit を決めます。
- urls と results_limit を /v1/tiktok/comments に POST し、返された task_id を保存します。
- タスクが成功または失敗するまで /v1/tasks/{task_id} をポーリングします。
- 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 trueTikTok Comments API の主なユースケース
- 顧客の声(VoC)調査: オーディエンス自身の言葉から、繰り返し現れるニーズ、質問、称賛、提案を見つけます。
- ディスカッションの確認キュー: コメント本文、表示中のいいね数、返信数を使って、サポート、調査、ソーシャルリスニングで確認するコメントを整理します。
- クリエイティブへの反応分析: 動画ごとの反応を比較し、共感、議論、会話を生み出すアイデアを見つけます。
- クリエイターの反応の分析: ピン留め、クリエイターによるいいね、返信数を調べ、クリエイターがコメント欄をどのように形成しているかを把握します。
TikTok Comments API 活用のヒント
- 動画の重要度に応じて results_limit を割り当て、URL数を掛けてバッチの規模を見積もってください。
- likes_count は支持の度合い、replies_count は議論の深さとして、別々に分析してください。
- is_pinned と creator_liked は、クリエイターが積極的に取り上げたフィードバックの指標として活用してください。
- コメントの id で重複を排除し、出どころを明確にするため動画URLと collected_at を保持してください。
- ダッシュボード、チケット、レポートに表示する前にコメント本文をエスケープし、確認用に元のテキストも保持してください。
- 反応の指標で確認の順序を決めてから、元のコメント本文をテーマや感情で分類してください。
関連API
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 Followers List API
- TikTok Following List API
- TikTok User Videos API
- TikTok Live Room Info API
- TikTok Trending Feed API
- TikTok Video Transcript API
- TikTok Search Users 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 Hashtag Views 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