Quickstart

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")

# Search for Spaces
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" });

// Search for Spaces
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`);
});

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")

# Search live Spaces only
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" });

// Search live Spaces only
const response = await client.spaces.search({
  query: "tech",
  state: "live",
});

response.data?.forEach((space) => {
  console.log(`LIVE: ${space.title}`);
});

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")

# Search scheduled Spaces only
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" });

// Search scheduled Spaces only
const response = await client.spaces.search({
  query: "tech",
  state: "scheduled",
});

response.data?.forEach((space) => {
  console.log(`SCHEDULED: ${space.title}`);
});

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")

# Search with host info
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}")
# Host info is in response.includes.users

import { Client } from "@xdevplatform/xdk";

const client = new Client({ bearerToken: "YOUR_BEARER_TOKEN" });

// Search with host info
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);
});
// Host info is in response.includes?.users