x/
space

リンクからXのスペースを調べ、タイトル、ステータス、開始時刻、ホスト、スピーカー、ライブ中のリスナー総数、録音の再生回数を取得します。予定中、ライブ中、終了済みのスペースに対応しています。

X Spaces API

スペースのリンクを入力
ホストとスピーカー
リスナー数と再生回数
結果1件あたり0.7クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

X Spaces

Xのスペース(旧Twitterスペース)は、X上のライブ音声ルームで、それぞれにタイトル、予定中からライブ中、終了へと移るステータス、メインのホストと共同ホスト、ステージに招かれたスピーカー、ライブで聴いた人数と録音が再生された回数があります。これらの情報があれば、1つのスペースのリーチを報告したり、定期番組を回ごとに追ったり、ある分野でどの声が繰り返しステージに登場しているかを確認したりできます。

X Spaces API の主な機能

  • どの段階のスペースのリンクでも予定中、ライブ中、終了済みのいずれのスペースでも https://x.com/i/spaces/<id> のリンクを送信でき、それぞれ1行が返ります。
  • ステータスと日時status は scheduled、live、ended、canceled のいずれかで、scheduled_start_at には予定開始時刻、published_at にはスペースが作成された日時が入ります。
  • ステージにいる全員author はメインのホスト、hosts はホストと共同ホスト、speakers は発言に招かれたアカウントの一覧で、それぞれに id、username、name、アイコン画像、認証フラグが付きます。
  • ライブと録音のオーディエンスmetrics.live_listeners_count はスペースのライブ中に聴いた人の総数、metrics.replay_views_count は終了後に録音が再生された回数です。
  • 録音の再生可否is_replay_available は、終了後もそのスペースをXで再生できるかどうかを示します。

X Spaces API のパラメータ

パラメータ必須説明
urls必須https://x.com/i/spaces/<space_id> 形式のXスペースのリンクで、1行に1つずつ入力します。予定中、ライブ中、終了済みのスペースをすべて受け付けます。

X Spaces API の使い方

スペースのリンクを送信し、スペースごとに1行を読み取ります。

  1. {"urls": ["https://x.com/i/spaces/1OdWgBerXWvaQz"]} を /v1/x/space に POST します。
  2. status が succeeded になるまで GET /v1/tasks/{task_id} をポーリングします。
  3. results.items から各スペースを読み取ります。大きなバッチでは、has_more が true の間 results.next_cursor を渡し続けてください。
curl -X POST "https://api.socq.ai/v1/x/space" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://x.com/i/spaces/1OdWgBerXWvaQz"]}'

# hosts repeats the main host from author and adds any co-hosts.

X Spaces API の主なユースケース

  • 主催・協賛したスペースのレポート作成: 各スペースの live_listeners_count、replay_views_count、スピーカーの顔ぶれを、クライアントやスポンサー向けのイベント後レポートにまとめます。
  • 競合の音声番組の追跡: 競合が定期開催しているスペースのリンクを集め、リスナー数、再生回数、ゲストを回ごとに比較します。
  • ニッチ分野の活発なスピーカーのリスト作成: 自分の分野のスペースのスピーカーと共同ホストを集め、各アカウントがステージに登場する頻度を数えます。
  • 予定されたスペースの顔ぶれの確認: イベント前に scheduled_start_at と hosts を読み、後でもう一度スペースを照会して、ステータスが ended と canceled のどちらになったかを確認します。

X Spaces API 活用のヒント

  • status が ended になったらもう一度収集して最終的なライブのリスナー総数を記録し、replay_views_count は collected_at とともに保存してください。is_replay_available が true の間は再生回数が増え続けます。
  • 共同ホストの数は、hosts から author の分を引いて数えてください。メインのホストは両方のフィールドに現れます。
  • 複数のスペースをまとめるときはスピーカーを id で識別すると、ユーザー名が変わっても同じ人物を1回だけ数えられます。

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

  • Twitter Tweet Scraper API — x.comまたはtwitter.comのステータスURLから、公開ポストのテキスト、投稿者、エンゲージメント、メディア、ハッシュタグ、メンション、会話の関係を取得します。
  • Twitter Profile Scraper API — ユーザー名から、公開アカウントの情報、プロフィール文、アバター、カバー画像、アカウントの状態、表示中のオーディエンス統計を取得します。
  • Twitter User Tweets Scraper API — ユーザー名から、返信を除く最近の公開ポストを、投稿者、メディア、ハッシュタグ、メンション、エンゲージメントとともに取得します。
  • X Post Quotes API — 既知のステータスURLについて公開引用ポストを取得し、コメント、投稿者、エンゲージメント、メディア、タイムスタンプ、元のポストの情報を返します。
  • Twitter Mentions API — 指定したアカウントをメンションしている公開ポストを取得します。
  • X Account Location API — アカウントの拠点となる国、Xへの接続方法、登録日、ユーザー名の変更回数を確認します。

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

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

X Spaces API — よくある質問

X Spaces APIは、X上のライブ音声ルームであるスペースを /i/spaces/ リンクから照会するためのプログラムインターフェースです。各スペースのタイトル、ステータス、予定開始時刻、メインのホスト、共同ホスト、スピーカー、ライブのリスナー総数、録音の再生回数、再生可否を返します。

はい。metrics.live_listeners_count はスペースのライブ中に聴いた人の総数で、metrics.replay_views_count はその後に録音が再生された回数です。

いいえ。リスナーは人数として返ります。結果に名前付きで含まれるアカウントは、メインのホスト、共同ホスト、スピーカーです。

いいえ。結果に含まれるのはスペースとそのオーディエンスの情報です。録音をXで再生できるかどうかは is_replay_available でわかります。

送信したスペースが1つも見つからない場合、タスクは失敗し全額返金されます。一部だけが見つからない場合は、残りが通常どおり返ります。