Douyin Live Room Detail
Douyinのライブ配信ルームは、タイトル、現在のステータス、配信者情報、メディア、表示中の視聴者数といいね数を持つ公開の配信セッションです。これらのフィールドは、ルームカタログの情報補完、セッション状態の追跡、特定時点の比較に活用できます。
Douyin Live Room Detail API の主な機能
- 既知ルームの詳細照会既知の数値 room_id を1つ、ソースへの1回のリクエストで最大1件の正規化された live_room レコードに解決します。ソースのページネーションは行いません。
- ルームと配信者のコンテキスト取得可能なルームタイトル、ステータス、配信者情報、ソースURL、取得日時を、一貫した1つの形式にまとめて保持します。
- 表示中のセッションのスナップショット取得可能な視聴者数といいね数を公開メディアとあわせて記録し、タイムスタンプ付きでルームの状態を把握できます。
Douyin Live Room Detail API のパラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
room_id | 必須 | 必須。数字のみからなるDouyinライブ配信ルームの識別子です。長い識別子がクライアント側で丸められないよう、文字列として送信してください。 |
Douyin Live Room Detail API の使い方
既知の数値ルームIDを用意して非同期の詳細タスクを送信し、保存された正規化結果を読み取ります。
- 数値の識別子が表示されるライブ配信ルームのコンテキストから room_id を取得します。このエンドポイントはルームIDの探索を行いません。
- 識別子を数字のみからなる空でない文字列として /v1/douyin/live-room-detail に POST します。
- status が succeeded または failed になるまで /v1/tasks/{task_id} をポーリングします。
- /v1/tasks/{task_id}?limit=50 から data.results.items を読み取ります。解決されたルームから生成されるアイテムは最大1件で、next_cursor はSocQの保存済み結果のページネーション専用です。
# Set DOUYIN_ROOM_ID to a known numeric room_id before sending.
curl -X POST "https://api.socq.ai/v1/douyin/live-room-detail" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d "{\"room_id\":\"${DOUYIN_ROOM_ID}\"}"
# Poll GET /v1/tasks/{task_id}, then read data.results.items from /v1/tasks/{task_id}?limit=50.Douyin Live Room Detail API の主なユースケース
- ライブ配信ルームのカタログ補完: ルームIDをすでに保存しているカタログに、取得可能なタイトル、ステータス、配信者、メディア、表示中の指標、取得日時を追加します。
- セッション状態のスナップショット追跡: 個別に取得したレコードを collected_at とともに保持し、特定時点のルームのステータスと視聴者の観測結果を区別します。
- 配信者とルームのコンテキスト確認: 取得可能な配信者情報を、ルームタイトル、ステータス、メディア、表示中のセッション数値とあわせて、1つの正規化レコードで確認します。
Douyin Live Room Detail API 活用のヒント
- 長い識別子のすべての桁を保持できるよう、room_id はJavaScriptの数値ではなく、引用符で囲んだ数字のみの文字列として送信してください。
- このリクエストはライブ配信ルームの探索ではなく詳細の取得を行うため、エンドポイントを呼び出す前に既知の room_id を用意してください。
- 送信した room_id は自身のレコードに保持してください。正規化されたライブ配信ルームの結果で、ソースがそれを id として返すとは限りません。
- ソースが個々の公開フィールドを省略する場合があるため、title、status、author、metrics、media、URL、タイムスタンプは null になり得るものとして扱ってください。
- results_limit やソースのカーソルは送信しないでください。next_cursor が存在する場合、それはプロバイダーへのリクエストではなく、SocQに保存された結果アイテムをページ送りするものです。
関連API
Douyin Live Room Detail API 以外に別の種類の公開Douyinデータが必要な場合は、これらのAPIをご利用ください。