クイックスタート

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

このガイドでは、キーワードで Spaces を検索する方法を説明します。

前提条件

開始する前に、次のものが必要です。

• 承認済みの App がある開発者アカウント
• App のベアラートークン

---

​

スペースを検索する

キーワードに一致するスペースを検索します：

cURL

shellscript

curl "https://api.x.com/2/spaces/search?\
query=AI&\
space.fields=title,host_ids,participant_count,state&\
state=live" \
  -H "Authorization: Bearer $BEARER_TOKEN"

​

レスポンス

{
  "data": [
    {
      "id": "1DXxyRYNejbKM",
      "state": "live",
      "title": "Discussing AI and the Future",
      "host_ids": ["2244994945"],
      "participant_count": 245
    },
    {
      "id": "1YqJDqWYNQDGW",
      "state": "live",
      "title": "AI in Healthcare",
      "host_ids": ["783214"],
      "participant_count": 89
    }
  ],
  "meta": {
    "result_count": 2
  }
}

---

​

状態で絞り込む

ライブ中またはスケジュール済みのスペースのみを検索します：

​

ライブ中のSpacesのみ

cURL

shellscript

curl "https://api.x.com/2/spaces/search?query=tech&state=live" \
  -H "Authorization: Bearer $BEARER_TOKEN"

​

予約済みの Spaces のみ

cURL

shellscript

curl "https://api.x.com/2/spaces/search?query=tech&state=scheduled" \
  -H "Authorization: Bearer $BEARER_TOKEN"

---

​

ホスト情報を含める

ホストユーザーのデータを展開します:

cURL

shellscript

curl "https://api.x.com/2/spaces/search?\
query=AI&\
space.fields=title,host_ids,state&\
expansions=host_ids&\
user.fields=username,verified" \
  -H "Authorization: Bearer $BEARER_TOKEN"

---

​

共通パラメーター

パラメーター	説明
query	検索クエリ (必須)
state	フィルター：live、scheduled、または all
max_results	返す結果数 (1〜100)
space.fields	レスポンスに含める Space のフィールド
expansions	レスポンスに含める関連オブジェクト
user.fields	レスポンスに含める User のフィールド

---

​

次のステップ

Space ルックアップ

id で Space を取得する

APIリファレンス

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