tiktok/
comment-replies

動画URLとコメントIDを指定して、1件のTikTokコメントに付いた公開返信を収集し、本文、投稿者、タイムスタンプ、エンゲージメント、親コメントの情報を正規化レコードとして返します。

TikTok Comment Replies API

既知コメントへの返信
投稿者の情報
親コメントの参照
結果1件あたり0.5クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

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を用意して非同期の返信タスクを送信し、結果カーソルによるページネーションで正規化レコードを読み取ります。

  1. 対象動画について TikTok Comments API を実行し、返信を取得したいトップレベルコメントの id を選びます。
  2. 同じ動画の url、その comment_id、任意の results_limit を /v1/tiktok/comment-replies に POST します。
  3. status が succeeded または failed になるまで /v1/tasks/{task_id} をポーリングします。
  4. /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 になりうるものとして扱い、ユーザー生成テキストは下流のツールで表示する前にエスケープしてください。

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

TikTok Comment Replies API — よくある質問

TikTok Comment Replies APIは、動画URLとコメントIDを使って、既知の1件のTikTok動画コメントに付いた公開返信を収集するためのプログラムインターフェースです。正規化された返信本文、投稿者のアカウント情報、タイムスタンプ、表示中のエンゲージメント、親コメントの情報を返します。

同じ動画について TikTok Comments API を実行し、選択したトップレベルコメントの正規化された id を使用してください。返信タスクを送信する際は、その id を元の動画URLと組み合わせて指定します。

tiktok.com、www.tiktok.com、m.tiktok.com のいずれかで、パスに /video/ と数値の動画IDを含むURLを使用してください。短縮リンク、プロフィールURL、または空でない comment_id を伴わない動画URLは、リクエストの仕様を満たしません。

レコードには、返信IDと本文、元の動画URL、公開投稿者のアカウント情報とアカウントフラグ、いいね数と返信数、メンション、created_at、collected_at、extra.parent_comment_id、extra.input_url が含まれる場合があります。

results_limit は上限であり、件数を保証するものではありません。公開返信が終端に達した場合、新しい一意の返信IDが返されなくなった場合、カーソルが進まなくなった場合、または100ページの上限に達した場合に収集が終了することがあります。

保存された正規化返信1件につき0.5クレジットで、タスクの基本料金はかかりません。初期見積もりには results_limit またはデフォルトの100が使われ、最終的な使用量は実際に保存されたレコード数に基づきます。保存された返信がない場合、結果に対する課金は発生しません。