tiktok/
live-room-info

ルームIDと配信者IDの組み合わせで公開TikTokライブ配信ルームを1件取得し、タイトル、ステータス、配信者情報、カバー画像、視聴者数、いいね数、取得日時を返します。

TikTok Live Room Info API

既知のライブ配信ルーム
視聴者のスナップショット
配信者の情報
結果1件あたり0.5クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

TikTok Live Room Info

TikTokライブ配信ルーム情報は、配信中の公開ルーム1件を特定時点で捉えたもので、タイトル、ステータス、配信者のアカウント情報、カバー画像、表示中の視聴者数といいね数を含みます。これらのフィールドは、既知のルームについて、配信状況の確認、視聴者のスナップショット、ルーム情報の補完、タイムスタンプ付きのレポートに活用できます。

TikTok Live Room Info API の主な機能

  • ルームIDと配信者IDによる検索room_id と対応する配信者の user_id から既知のライブ配信ルームを1件特定し、正規化された live_room レコードを最大1件返します。
  • ルームと配信者の情報現在のルームのタイトルとステータスに加え、配信者の公開ID、ユーザー名、表示名を返します。
  • 視聴者とカバー画像のスナップショット表示中の視聴者数、いいね数、公開カバー画像、取得時のタイムスタンプを取得し、特定時点の値として解釈できるようにします。

TikTok Live Room Info API のパラメータ

パラメータ必須説明
room_id必須必須。空でないライブ配信ルームの識別子です。現在のTikTokライブ配信セッションを公開しているソースから取得した数値の識別子を、文字列として指定してください。
user_id必須必須。ルームの配信者を表す、空でない数値のTikTokユーザー識別子です。文字列として指定し、同じルームと組み合わせて使用します。

TikTok Live Room Info API の使い方

配信中の既知のルーム1件の識別子を組み合わせて非同期の検索を送信し、タスク結果から正規化されたスナップショットを読み取ります。

  1. 現在のTikTokライブ配信セッションを公開しているソースから room_id を取得し、同じ情報源または TikTok Profiles の結果から対応する配信者の user_id を取得します。
  2. 空でない文字列の識別子を両方とも /v1/tiktok/live-room-info に POST します。
  3. status が succeeded または failed になるまで /v1/tasks/{task_id} をポーリングします。
  4. /v1/tasks/{task_id}?limit=50 から data.results.items を読み取ります。特定できたルームのレコードは最大1件で、通常の next_cursor は results.has_more が true の場合にのみ使用します。
curl -X POST "https://api.socq.ai/v1/tiktok/live-room-info" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"room_id":"7523685855395842871","user_id":"6742945285876515845"}'

# Poll GET /v1/tasks/{task_id}, then read data.results.items from /v1/tasks/{task_id}?limit=50.

TikTok Live Room Info API の主なユースケース

  • 特定時点の配信状況の確認: 返された status、タイトル、ルームID、collected_at の値を使い、既知のルームについて取得できたスナップショットを確認します。
  • 視聴者スナップショットのレポート: viewers_count と likes_count を collected_at とともに記録し、既知の配信中に異なる時点で得られた観測値を比較します。
  • ライブ配信ルームの情報補完: 既存のライブ配信ルームのレコードに、配信者のID、ユーザー名、表示名、ルームのタイトル、ステータス、カバー画像を追加します。

TikTok Live Room Info API 活用のヒント

  • room_id は、同じ配信中セッションの配信者の user_id と組み合わせてください。ルームとユーザーが一致しない場合、レコードが返されないか、入力に起因するソースエラーが返されることがあります。
  • 大きな数値のTikTok IDがクライアントやデータベースで丸められないよう、両方の識別子を文字列のまま保持してください。
  • 検索はルームが配信中と見込まれる間に実行し、結果が空の場合はオフラインのルームのレコードとしてではなく、終了、利用不可、無効、または不一致として扱ってください。
  • ステータスと指標の観測時刻には collected_at を使用してください。正規化レコードでは created_at は null、url は空になります。

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

  • TikTok Profiles API — ユーザー名から、公開プロフィールのアカウント情報、プロフィール文、アカウント属性、オーディエンス数を取得します。
  • TikTok Hashtags API — 指定したハッシュタグの公開動画、クリエイター、メディア、サウンド、エンゲージメントを取得します。
  • TikTok Search API — キーワードで公開動画を検索します。対応する並び順と公開日のフィルターを指定できます。
  • TikTok User Videos API — ユーザー名から、プロフィールフィードの公開動画をキャプション、クリエイター、メディア、タイムスタンプ、エンゲージメント、元のアカウント情報とともに取得します。
  • TikTok Search Users API — キーワードで公開TikTokアカウントを検索します。
  • TikTok Top Search API — キーワードで動画と画像投稿を検索し、キャプション、クリエイター、インタラクション数を返します。

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

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

TikTok Live Room Info API — よくある質問

TikTok Live Room Info APIは、room_id と配信者の user_id を使って、既知の公開ライブ配信ルームを1件取得するためのプログラムインターフェースです。ルームのタイトルとステータス、配信者のアカウント情報、カバー画像、視聴者数といいね数、取得日時を特定時点のスナップショットとして返します。

room_id を公開しているライブ配信セッションのソースを使用し、ルームの配信者の数値の user_id と組み合わせてください。user_id は TikTok Profiles の結果の正規化された id フィールドから取得できますが、現在のSocQのTikTokカタログには room_id を探す機能はありません。

ルームの配信が終了した、利用できなくなった、送信した配信者と一致しなくなった、またはいずれかの識別子が無効である可能性があります。SocQは、ソースが空でない room_id を特定できた場合にのみ結果を保存します。

できません。すでにわかっているルームについて1回の検索を行うもので、トレンドのルームの検索、アカウントの配信開始の待機、動画の録画、ライブイベントの収集、継続的な監視の作成は行いません。

リクエストの取得時点で公開されている特定時点の値で、すぐに変化する可能性があります。継続的なフィードとして扱うのではなく、各数値とあわせて collected_at を保存してください。

保存された正規化ルームレコード1件につき0.5クレジットで、タスクの基本料金はかかりません。見積もりは結果1件を想定しており、結果が空の場合は結果に対する課金は発生しません。