TikTok Comment Replies
TikTokコメントの返信は、既知の動画コメントの下に付いた公開の反応で、返信本文、投稿者のアカウント情報、タイムスタンプ、表示中のいいね数と返信数、親コメントへの参照を含みます。これらの会話レコードは、スレッドの再構成、参加者の確認、反応の調査、返信単位のモニタリングに活用できます。
TikTok Comment Replies API の主な機能
- コメント単位の返信取得サポートされているTikTok動画URLと既知の comment_id を組み合わせ、動画のトップレベルコメントではなく、そのコメントに付いた公開返信を収集します。
- 返信・投稿者・エンゲージメントのフィールド返信IDと本文、公開投稿者のアカウント情報とアカウントフラグ、タイムスタンプ、表示中のいいね数と返信数、メンション、元の動画の情報を取得できます。
- 上限付き・重複排除済みの巡回利用可能な返信カーソルをたどって重複するコメントIDを除去し、指定した上限、スレッドの終端、または100ページの収集上限のいずれかで停止します。
TikTok Comment Replies API のパラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
url | 必須 | 必須。tiktok.com、www.tiktok.com、m.tiktok.com のいずれかで、/video/{numeric_id} のパスを含むTikTok動画URLです。 |
comment_id | 必須 | 必須。同じ動画で選択したトップレベルコメントの、空でない公開コメントIDです。 |
results_limit | 任意 | コメントに対して取得する返信の最大数です。デフォルトは100で、20〜2,000の整数を指定できます。 |
TikTok Comment Replies API の使い方
1本のTikTok動画のトップレベルコメントIDを用意して非同期の返信タスクを送信し、結果カーソルによるページネーションで正規化レコードを読み取ります。
- 対象動画について TikTok Comments API を実行し、返信を取得したいトップレベルコメントの id を選びます。
- 同じ動画の url、その comment_id、任意の results_limit を /v1/tiktok/comment-replies に POST します。
- status が succeeded または failed になるまで /v1/tasks/{task_id} をポーリングします。
- /v1/tasks/{task_id}?limit=50 から data.results.items を読み取り、results.has_more が true の間は results.next_cursor を渡して続きを取得します。
curl -X POST "https://api.socq.ai/v1/tiktok/comment-replies" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://www.tiktok.com/@loganpaul/video/7411198650782731563","comment_id":"7411205662439736097","results_limit":20}'
# Poll GET /v1/tasks/{task_id}, then read data.results.items and follow results.next_cursor.TikTok Comment Replies API の主なユースケース
- 既知コメントのスレッド再構成: 返信ID、extra.parent_comment_id、extra.input_url を結合し、選択した1件のトップレベルコメントの下にある公開返信スレッドを再構成します。
- 返信単位の反応の確認: 返信本文、タイムスタンプ、表示中のいいね数と返信数を使い、特定の会話内での公開の反応を確認・比較します。
- 会話参加者のマッピング: 公開投稿者のID、ユーザー名、プロフィールリンク、アバター、アカウントフラグを使い、返された返信に登場する参加者を整理します。
TikTok Comment Replies API 活用のヒント
- comment_id には TikTok Comments のトップレベルコメント結果の正規化された id を使い、その結果の動画URLを再利用してください。動画IDはコメントIDではありません。
- 短縮リンク、プロフィールリンク、動画以外のリンクで入力チェックに失敗しないよう、送信前にURLのホストと数値の /video/ パスを検証してください。
- results_limit は必要な返信数に合わせて設定してください。ただし、公開スレッドが上限より前に終わる場合があり、収集は100ソースページで停止します。
- 複数のタスクを統合する場合は、返信の id で重複を排除しつつ extra.parent_comment_id と extra.input_url を保持し、返信を正しい会話に紐付けたままにしてください。
- 返信本文、投稿者フィールド、指標、メンション、タイムスタンプは null になりうるものとして扱い、ユーザー生成テキストは下流のツールで表示する前にエスケープしてください。
関連API
TikTok Comment Replies API 以外に別の種類の公開TikTokデータが必要な場合は、これらのAPIをご利用ください。
- TikTok Profiles API — ユーザー名から、公開プロフィールのアカウント情報、プロフィール文、アカウント属性、オーディエンス数を取得します。
- TikTok Hashtags API — 指定したハッシュタグの公開動画、クリエイター、メディア、サウンド、エンゲージメントを取得します。
- TikTok Comments API — 公開トップレベルコメント、投稿者、エンゲージメント、メンション、クリエイターとのやり取りを示すフラグを取得します。
- TikTok Videos API — 動画URLから、クリエイター、キャプション、メディア、音楽、タグ、メンション、エンゲージメントを取得します。
- TikTok Search API — キーワードで公開動画を検索します。対応する並び順と公開日のフィルターを指定できます。
- 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