빠른 시작

키워드로 Spaces를 검색하기

이 가이드는 키워드로 Spaces를 검색하는 방법을 단계별로 안내합니다.

사전 준비 사항

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

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

---

​

스페이스 검색

지정한 키워드와 일치하는 스페이스를 검색합니다:

cURL

shellscript

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"

​

응답

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

---

​

상태별로 필터링

라이브 또는 예정된 Space만 검색합니다:

​

진행 중인 Space만

cURL

shellscript

curl "https://api.x.com/2/spaces/search?query=tech&state=live" \
  -H "Authorization: Bearer $BEARER_TOKEN"

​

예약된 Spaces만

cURL

shellscript

curl "https://api.x.com/2/spaces/search?query=tech&state=scheduled" \
  -H "Authorization: Bearer $BEARER_TOKEN"

---

​

호스트 정보 포함하기

호스트 사용자 데이터를 확장하려면:

cURL

shellscript

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"

---

​

공통 매개변수

Parameter	설명
query	검색 쿼리 (필수)
state	필터: live, scheduled, 또는 all
max_results	반환할 결과 수 (1-100)
space.fields	포함할 Space 필드
expansions	포함할 관련 객체
user.fields	포함할 User 필드

---

​

다음 단계

Space 조회

ID로 Space 조회

API 참조 문서

전체 엔드포인트 문서