Spaces 조회

ID로 Space 세부 정보를 조회하거나 생성자를 기준으로 Spaces를 검색합니다

Spaces 조회 endpoint를 사용하면 진행 중이거나 예약된 Spaces 정보를 조회할 수 있습니다. Space id로 Spaces를 조회하거나 특정 사용자가 생성한 Spaces를 찾을 수 있습니다.

​

개요

ID로 조회

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

여러 Space 조회

여러 Space를 한 번에 조회합니다

호스트로 조회

호스트별로 Space를 찾습니다

구매자

티켓을 구매한 사용자를 조회합니다

---

​

엔드포인트

Method	Endpoint	Description
GET	/2/spaces/:id	ID로 Space 조회
GET	/2/spaces	ID로 여러 개의 Space 조회
GET	/2/spaces/by/creator_ids	Space를 생성한 사용자 ID로 Space 조회
GET	/2/spaces/:id/buyers	Space의 티켓 구매자 조회
GET	/2/spaces/:id/tweets	Space에서 공유된 포스트 조회

---

​

응답 필드

기본적으로 응답에는 id와 state가 포함됩니다. 추가 필드를 요청하려면 다음을 사용하세요:

필드	설명
title	Space 제목
host_ids	호스트 사용자 ID
speaker_ids	스피커 사용자 ID
participant_count	참가자 수
scheduled_start	예정된 시작 시각
started_at	실제 시작 시각
ended_at	종료 시각
is_ticketed	티켓이 있는 Space인지 여부

​

Space 상태

State	Description
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"

---

​

시작하기

사전 준비 사항

• 승인된 개발자 계정
• 개발자 콘솔의 Project 및 App
• App의 키와 토큰

빠른 시작

첫 Spaces 조회 요청을 보내 보세요

Spaces 검색

키워드로 Spaces를 찾으세요

API 참조 문서

전체 엔드포인트 문서를 확인하세요

샘플 코드

실행 가능한 코드 예제를 살펴보세요