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行を読み取ります。
- {"urls": ["https://x.com/i/spaces/1OdWgBerXWvaQz"]} を /v1/x/space に POST します。
- status が succeeded になるまで GET /v1/tasks/{task_id} をポーリングします。
- 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回だけ数えられます。
関連API
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への接続方法、登録日、ユーザー名の変更回数を確認します。
- Twitter Search API
- X Followers List API
- X Following List API
- X Post Replies API
- X Post Retweeters API
- X Trends API
- Twitter User Search API
- X Community API
- X Community Posts API
- X Thread Context API
- X Verified Followers API
- X List Tweets API
- Twitter List Members API
- Twitter List Followers API
- X Community Members API
- X Community Moderators API
- X Communities Search API
- X Articles API
- Twitter Media Scraper API
- X User Replies API
- Twitter Follow Checker API
- Twitter Video Transcript API