スペースを検索する
cURL
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"
from xdk import Client
client = Client(bearer_token="YOUR_BEARER_TOKEN")
# スペースを検索する
response = client.spaces.search(
query="AI",
space_fields=["title", "host_ids", "participant_count", "state"],
state="live"
)
for space in response.data:
print(f"{space.title} - {space.participant_count} participants")
import { Client } from "@xdevplatform/xdk";
const client = new Client({ bearerToken: "YOUR_BEARER_TOKEN" });
// スペースを検索する
const response = await client.spaces.search({
query: "AI",
spaceFields: ["title", "host_ids", "participant_count", "state"],
state: "live",
});
response.data?.forEach((space) => {
console.log(`${space.title} - ${space.participant_count} participants`);
});
レスポンス
{
"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
curl "https://api.x.com/2/spaces/search?query=tech&state=live" \
-H "Authorization: Bearer $BEARER_TOKEN"
from xdk import Client
client = Client(bearer_token="YOUR_BEARER_TOKEN")
# ライブ中のSpacesのみを検索
response = client.spaces.search(query="tech", state="live")
for space in response.data:
print(f"LIVE: {space.title}")
import { Client } from "@xdevplatform/xdk";
const client = new Client({ bearerToken: "YOUR_BEARER_TOKEN" });
// ライブ中のSpacesのみを検索
const response = await client.spaces.search({
query: "tech",
state: "live",
});
response.data?.forEach((space) => {
console.log(`LIVE: ${space.title}`);
});
予約済みの Spaces のみ
cURL
curl "https://api.x.com/2/spaces/search?query=tech&state=scheduled" \
-H "Authorization: Bearer $BEARER_TOKEN"
from xdk import Client
client = Client(bearer_token="YOUR_BEARER_TOKEN")
# 予約済みの Spaces のみを検索
response = client.spaces.search(query="tech", state="scheduled")
for space in response.data:
print(f"SCHEDULED: {space.title}")
import { Client } from "@xdevplatform/xdk";
const client = new Client({ bearerToken: "YOUR_BEARER_TOKEN" });
// 予約済みの Spaces のみを検索
const response = await client.spaces.search({
query: "tech",
state: "scheduled",
});
response.data?.forEach((space) => {
console.log(`SCHEDULED: ${space.title}`);
});
ホスト情報を含める
cURL
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"
from xdk import Client
client = Client(bearer_token="YOUR_BEARER_TOKEN")
# ホスト情報を含めて検索
response = client.spaces.search(
query="AI",
space_fields=["title", "host_ids", "state"],
expansions=["host_ids"],
user_fields=["username", "verified"]
)
for space in response.data:
print(f"{space.title}")
# ホスト情報は response.includes.users に含まれます
import { Client } from "@xdevplatform/xdk";
const client = new Client({ bearerToken: "YOUR_BEARER_TOKEN" });
// ホスト情報を含めて検索
const response = await client.spaces.search({
query: "AI",
spaceFields: ["title", "host_ids", "state"],
expansions: ["host_ids"],
userFields: ["username", "verified"],
});
response.data?.forEach((space) => {
console.log(space.title);
});
// ホスト情報は response.includes?.users に含まれます
共通パラメーター
| パラメーター | 説明 |
|---|---|
query | 検索クエリ (必須) |
state | フィルター：live、scheduled、または all |
max_results | 返す結果数 (1〜100) |
space.fields | レスポンスに含める Space のフィールド |
expansions | レスポンスに含める関連オブジェクト |
user.fields | レスポンスに含める User のフィールド |
次のステップ
Space ルックアップ
id で Space を取得する
APIリファレンス
エンドポイントの詳細ドキュメント