빠른 시작

ID 또는 생성자를 기준으로 Space 상세 정보를 조회합니다

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

사전 준비 사항

시작하기 전에 다음이 필요합니다.

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

---

​

ID로 Space 조회하기

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

cURL

shellscript

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"

​

응답

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

shellscript

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

---

​

생성자 기준으로 Spaces 조회

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

cURL

shellscript

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"

---

​

호스트 정보 포함하기

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

cURL

shellscript

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"

​

확장 필드가 포함된 응답

{
  "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 검색

키워드로 Spaces 찾기

API 참조 문서

전체 엔드포인트 문서 보기