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を設定して非同期タスクを送信し、そのタスクに保存された正規化コメントを読み取ります。
- DOUYIN_VIDEO_URL に、/video/{numeric_id} のパスを含む douyin.com または iesdouyin.com の公開URLを設定します。
- url と任意の results_limit を /v1/douyin/video-comments に POST し、task_id を保存します。
- タスクが成功または失敗するまで、/v1/tasks/{task_id} をポーリングします。
- 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 trueDouyin 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に挿入する前にコメントテキストをエスケープしてください。
関連API
Douyin Video Comments API 以外に別の種類の公開Douyinデータが必要な場合は、これらのAPIをご利用ください。
- Douyin Live Room Detail API — 数値のルームIDから既知のDouyinライブ配信ルーム1件を取得し、正規化されたルーム情報、配信者情報、メディア、表示中の視聴者数を返します。
- Douyin User Profile API
- Douyin User Videos API
- Douyin Video Detail API
- Douyin Video Search API