douyin/
live-room-detail

既知の数値 room_id から公開Douyinライブ配信ルームを1件取得し、タイトル、ステータス、配信者情報、メディア、表示中の視聴者数といいね数、取得日時を返します。

Douyin Live Room Detail API

既知のルームを照会
配信者のコンテキスト
視聴者のスナップショット
1リクエストあたり0.1クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

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を用意して非同期の詳細タスクを送信し、保存された正規化結果を読み取ります。

  1. 数値の識別子が表示されるライブ配信ルームのコンテキストから room_id を取得します。このエンドポイントはルームIDの探索を行いません。
  2. 識別子を数字のみからなる空でない文字列として /v1/douyin/live-room-detail に POST します。
  3. status が succeeded または failed になるまで /v1/tasks/{task_id} をポーリングします。
  4. /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に保存された結果アイテムをページ送りするものです。

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

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

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

Douyin Live Room Detail API — よくある質問

Douyin Live Room Detail APIは、数値の room_id から既知の公開ライブ配信ルームを1件取得するAPIです。取得可能なルーム、配信者、メディア、視聴者、取得日時の各フィールドを、正規化された特定時点のレコードとして返します。

ルームの数値識別子が表示される公開ライブ配信ルームのコンテキストを使用し、その値を自身のレコードとともに保持してください。このエンドポイントは、ライブ配信ルームの検索やルームIDの探索は行いません。

ランタイムのバリデーターは、数字のみのルームID形式に一致する文字列を必須としています。値をテキストのまま扱うことで、数値型のクライアントによって長いIDが丸められるのも防げます。

正規化されたレコードには、title、status、author、URL、media、表示中の viewers_count と likes_count、created_at、collected_at が含まれる場合があります。任意のソースフィールドは、null になるか含まれないことがあります。

対応していません。詳細リクエストを1回実行し、最大1件の正規化レコードを生成します。タスク結果の next_cursor は、SocQにすでに保存されたアイテム用の標準カーソルにすぎません。

成功したタスク1件につき固定で0.10 SocQクレジットです。料金は結果の件数やページネーションの設定によって変わりません。