Spaces ルックアップ

ID で Space の詳細を取得するか、作成者ごとに Space を検索します

Spaces lookup エンドポイントを使用すると、ライブ中またはスケジュール済みの Spaces に関する情報を取得できます。Spaces をその ID で検索したり、特定のユーザーが作成した Spaces を検索したりできます。

​

概要

ID で取得

特定の Space の詳細を取得します

複数の Space

複数の Space を同時に取得します

ホスト別

ホストを指定して Space を取得します

チケット購入者

チケットを購入したユーザーを取得します

---

​

エンドポイント

Method	Endpoint	Description
GET	/2/spaces/:id	ID を指定してスペースを取得
GET	/2/spaces	複数の ID を指定してスペースを取得
GET	/2/spaces/by/creator_ids	クリエイターのユーザー ID を指定してスペースを取得
GET	/2/spaces/:id/buyers	スペースのチケット購入者を取得
GET	/2/spaces/:id/tweets	スペース内で共有された投稿を取得

---

​

レスポンスフィールド

デフォルトでは、レスポンスには id と state が含まれます。追加のフィールドをリクエストするには、次を指定します:

Field	Description
title	Space のタイトル
host_ids	ホストユーザーの ID
speaker_ids	スピーカーユーザーの ID
participant_count	参加者数
scheduled_start	予定開始時刻
started_at	実際の開始時刻
ended_at	終了時刻
is_ticketed	Space にチケットが設定されているかどうか

​

Space の状態

State	説明
live	現在アクティブ
scheduled	今後の開催がスケジュール済み
ended	すでに終了

---

​

リクエスト例

curl "https://api.x.com/2/spaces/1DXxyRYNejbKM?\
space.fields=title,host_ids,participant_count,scheduled_start,state" \
  -H "Authorization: Bearer $BEARER_TOKEN"

---

​

はじめに

前提条件

• 承認済みの開発者アカウント
• 開発者コンソール内のプロジェクトとApp
• App のキーとトークン

クイックスタート

最初の Spaces ルックアップリクエストを実行する

Spaces を検索

キーワードで Spaces を検索する

APIリファレンス

エンドポイントの詳細ドキュメント

サンプルコード

実行可能なコードサンプル