douyin/
video-comments

Douyin動画の直接URLから公開コメントを1ページ分取得し、正規化されたテキスト、投稿者、関係、日時、表示中のエンゲージメントの各フィールドを返します。

Douyin Video Comments API

動画の直接URL
ソース1ページ分
CommentItem 1.0
1リクエストあたり0.1クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

Douyin Video Comments

Douyinの動画コメントは、動画に付けられた公開の反応で、テキスト、投稿者情報、投稿時のコンテキスト、表示中のいいね数や返信数を含みます。これらのレコードは、視聴者の反応の確認、会話のマッピング、特定時点のエンゲージメント比較に活用できます。

Douyin Video Comments API の主な機能

  • 動画を直接指定パスに /video/{numeric_id} を含む douyin.com または iesdouyin.com の公開URLを1つ指定し、数値の動画IDを解決します。
  • 範囲を限定した1ページ分の取得ソースの1ページ目から最大20行のコメントを要求し、results_limit で保存するサブセットを1〜20の範囲で制御します。
  • 標準化されたコメントのコンテキストテキスト、投稿者情報、動画と親コメントとの関係、公開日時と取得日時、表示中のいいね数や返信数を含む CommentItem 1.0 レコードを返します。

Douyin Video Comments API のパラメータ

パラメータ必須説明
url必須必須。douyin.com、iesdouyin.com、またはそのサブドメイン上の公開URLです。パスには /video/ とそれに続く数値の動画IDを含める必要があります。
results_limit任意任意。1〜20の整数です。省略した場合のデフォルトは20で、連携処理ではソースの1ページ目のみを要求します。

Douyin Video Comments API の使い方

公開Douyin動画の直接URLを設定して非同期タスクを送信し、そのタスクに保存された正規化コメントを読み取ります。

  1. DOUYIN_VIDEO_URL に、/video/{numeric_id} のパスを含む douyin.com または iesdouyin.com の公開URLを設定します。
  2. url と任意の results_limit を /v1/douyin/video-comments に POST し、task_id を保存します。
  3. タスクが成功または失敗するまで、/v1/tasks/{task_id} をポーリングします。
  4. data.results.items を読み取り、SocQにすでに保存されたレコードを続けて読む場合は、has_more が true の間だけ next_cursor をたどります。
curl -X POST "https://api.socq.ai/v1/douyin/video-comments" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"url\":\"${DOUYIN_VIDEO_URL}\",\"results_limit\":20}"

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

Douyin Video Comments API の主なユースケース

  • 視聴者の反応の確認: コメントのテキスト、投稿者情報、表示中のいいね数や返信数を使い、既知の公開動画に寄せられた反応を確認します。
  • コメントの関係マッピング: post_id と parent_id を使い、返されたコメントをソースの動画や、提供されている場合は親コメントの参照と結び付けます。
  • エンゲージメントのスナップショット比較: collected_at を観測時のタイムスタンプとして保持しながら、選んだ動画間や取得時点間で表示中のコメント指標を比較します。

Douyin Video Comments API 活用のヒント

  • ホストとパスの検証を通過できるよう、共有リンクやリダイレクトされるリンクは、送信前に受け付けられる最終的な /video/{numeric_id} のURLに解決してください。
  • 20行を要求する場合は results_limit を省略し、返されるソース1ページのうち一部だけが必要な場合はより小さい整数を指定してください。
  • 元の task_id を再利用し、has_more が true の場合にのみ next_cursor をたどってください。このカーソルは保存済みの行を読み取るもので、ソースの別ページを取得することはありません。
  • コメントの id を主な重複排除キーとして使用し、ソースの行に関係が含まれない場合は parent_id や post_id が null のままになることを許容してください。
  • 投稿者の詳細、published_at、個々の指標は任意項目として扱い、各結果のスナップショットには collected_at でタイムスタンプを付けてください。
  • 公開コメントはユーザー生成コンテンツのため、HTMLに挿入する前にコメントテキストをエスケープしてください。

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

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

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

Douyin Video Comments API — よくある質問

Douyin Video Comments APIは、数値の動画パスを含むDouyin動画URLから公開コメントを1ページ分取得し、正規化されたテキスト、投稿者、関係、日時、表示中のいいね数・返信数の各フィールドを返します。

url は douyin.com、iesdouyin.com、またはそのサブドメインを使用し、パスに /video/ とそれに続く数値IDを含む必要があります。プロフィール、検索、動画以外のパスは拒否されます。

results_limit は1〜20の整数を受け付け、デフォルトは20です。タスクはソースの1ページ分を要求するため、追加のソースページに続けて取得することはできません。

CommentItem 1.0 には、基本の識別情報と日時のフィールドに加え、text、author、parent_id、post_id、そして likes_count と replies_count を含む metrics が含まれます。任意のソースフィールドは、取得できない場合 null のままになります。

返信ページへの個別のリクエストは行いません。ソースから提供される場合、返された行に replies_count や parent_id が含まれることがありますが、それらのフィールドは返信テキストが取得されたことを意味するものではありません。

next_cursor は GET /v1/tasks/{task_id} に属するもので、成功後にSocQがすでに保存したレコードをページ送りします。Douyinの次のソースページを要求することはありません。

成功したタスク1件につき固定で0.10 SocQクレジットです。results_limit や返されるアイテム数には左右されません。失敗したタスクは、ランタイムの返金処理に従います。