빠른 시작

이 가이드는 Spaces 조회 엔드포인트를 사용해 Space 정보를 조회하는 방법을 설명합니다.

사전 준비 사항시작하기 전에 다음이 필요합니다.

승인이 완료된 App이 연결된 개발자 계정
App의 Bearer 토큰

ID로 Space 조회하기

특정 Space의 상세 정보를 조회합니다:

cURL

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

from xdk import Client

client = Client(bearer_token="YOUR_BEARER_TOKEN")

# ID로 Space 조회하기
response = client.spaces.get(
    "1DXxyRYNejbKM",
    space_fields=["title", "host_ids", "participant_count", "scheduled_start", "state", "created_at"]
)

print(f"Space: {response.data.title}")
print(f"State: {response.data.state}")
print(f"Participants: {response.data.participant_count}")

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

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

// ID로 Space 조회하기
const response = await client.spaces.get("1DXxyRYNejbKM", {
  spaceFields: ["title", "host_ids", "participant_count", "scheduled_start", "state", "created_at"],
});

console.log(`Space: ${response.data?.title}`);
console.log(`State: ${response.data?.state}`);
console.log(`Participants: ${response.data?.participant_count}`);

응답

{
  "data": {
    "id": "1DXxyRYNejbKM",
    "state": "live",
    "title": "Discussing AI and the Future",
    "host_ids": ["2244994945"],
    "participant_count": 245,
    "created_at": "2024-01-15T09:00:00.000Z"
  }
}

여러 Space 조회하기

여러 Space를 한 번에 조회하려면:

cURL

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

from xdk import Client

client = Client(bearer_token="YOUR_BEARER_TOKEN")

# 여러 Space 조회하기
response = client.spaces.get_spaces(
    ids=["1DXxyRYNejbKM", "1YqJDqWYNQDGW"],
    space_fields=["title", "state", "participant_count"]
)

for space in response.data:
    print(f"{space.title} - {space.state}")

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

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

// 여러 Space 조회하기
const response = await client.spaces.getSpaces({
  ids: ["1DXxyRYNejbKM", "1YqJDqWYNQDGW"],
  spaceFields: ["title", "state", "participant_count"],
});

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

생성자 기준으로 Spaces 조회

특정 사용자가 호스팅한 Spaces를 조회합니다:

cURL

curl "https://api.x.com/2/spaces/by/creator_ids?\
user_ids=2244994945,783214&\
space.fields=title,state,scheduled_start" \
  -H "Authorization: Bearer $BEARER_TOKEN"

from xdk import Client

client = Client(bearer_token="YOUR_BEARER_TOKEN")

# 생성자 기준으로 Spaces 조회
response = client.spaces.get_by_creator_ids(
    user_ids=["2244994945", "783214"],
    space_fields=["title", "state", "scheduled_start"]
)

for space in response.data:
    print(f"{space.title} - {space.state}")

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

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

// 생성자 기준으로 Spaces 조회
const response = await client.spaces.getByCreatorIds({
  userIds: ["2244994945", "783214"],
  spaceFields: ["title", "state", "scheduled_start"],
});

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

호스트 정보 포함하기

호스트 사용자 데이터를 확장해 포함합니다:

cURL

curl "https://api.x.com/2/spaces/1DXxyRYNejbKM?\
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")

# 호스트 정보가 포함된 Space 가져오기
response = client.spaces.get(
    "1DXxyRYNejbKM",
    space_fields=["title", "host_ids", "state"],
    expansions=["host_ids"],
    user_fields=["username", "verified"]
)

print(f"Space: {response.data.title}")
# 호스트 정보는 response.includes.users에 있습니다

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

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

// 호스트 정보가 포함된 Space 가져오기
const response = await client.spaces.get("1DXxyRYNejbKM", {
  spaceFields: ["title", "host_ids", "state"],
  expansions: ["host_ids"],
  userFields: ["username", "verified"],
});

console.log(`Space: ${response.data?.title}`);
// 호스트 정보는 response.includes?.users에 있습니다

확장 필드가 포함된 응답

{
  "data": {
    "id": "1DXxyRYNejbKM",
    "state": "live",
    "title": "Discussing AI and the Future",
    "host_ids": ["2244994945"]
  },
  "includes": {
    "users": [
      {
        "id": "2244994945",
        "username": "XDevelopers",
        "verified": true
      }
    ]
  }
}

Space 상태

State	Description
`live`	현재 진행 중
`scheduled`	예약됨
`ended`	종료됨

사용 가능한 필드

Field	Description
`title`	Space의 제목
`host_ids`	호스트 사용자 ID
`speaker_ids`	스피커 사용자 ID
`participant_count`	현재 참여자 수
`scheduled_start`	예정된 시작 시간
`started_at`	실제 시작 시간
`ended_at`	종료 시간
`is_ticketed`	티켓이 제공되는 Space인지 여부
`state`	현재 상태

개요

포스트

사용자

다이렉트 메시지

좋아요

리스트

Spaces

커뮤니티

커뮤니티 노트

트렌드

뉴스

미디어

X 활동

사용량

스트림 연결

규정 준수

Enterprise v2

좋아요 스트림

GNIP 2.0

ID로 Space 조회하기

응답

여러 Space 조회하기

생성자 기준으로 Spaces 조회

호스트 정보 포함하기

확장 필드가 포함된 응답

Space 상태

사용 가능한 필드

다음 단계

Spaces 검색

API 참조 문서

​ID로 Space 조회하기

​응답

​여러 Space 조회하기

​생성자 기준으로 Spaces 조회

​호스트 정보 포함하기

​확장 필드가 포함된 응답

​Space 상태

​사용 가능한 필드

​다음 단계

Spaces 검색

API 참조 문서

ID로 Space 조회하기

응답

여러 Space 조회하기

생성자 기준으로 Spaces 조회

호스트 정보 포함하기

확장 필드가 포함된 응답

Space 상태

사용 가능한 필드

다음 단계