x/
space

링크로 X 스페이스를 조회해 예약됨, 라이브, 종료 상태의 스페이스마다 제목, 상태, 시작 시각, 호스트, 스피커, 라이브 청취자 총수, 다시 듣기 재생수를 가져옵니다.

X Spaces API

스페이스 링크 입력
호스트와 스피커
청취자 수와 다시 듣기 재생수
결과당 0.7 크레딧
준비됨
준비됨

매개변수를 입력하고 요청을 전송하세요. 작업 상태와 정규화된 결과가 여기에 표시됩니다.

README

SocQ 작성 · 업데이트

X Spaces

X 스페이스(구 트위터 스페이스)는 X의 라이브 오디오 방으로, 스페이스마다 제목, 예약됨에서 라이브를 거쳐 종료로 바뀌는 상태, 메인 호스트와 공동 호스트, 무대에 오른 스피커, 그리고 라이브로 들은 사람 수와 녹음이 다시 재생된 횟수가 있습니다. 이 정보로 스페이스 하나의 도달 범위를 보고하고, 정기 방송을 회차별로 추적하고, 한 분야에서 어떤 목소리가 계속 무대에 오르는지 확인할 수 있습니다.

X Spaces API 주요 기능

  • 어떤 단계의 스페이스 링크든예약됨, 라이브, 이미 종료된 스페이스의 https://x.com/i/spaces/<id> 링크를 제출하면 스페이스마다 행 하나가 반환됩니다.
  • 상태와 시각status 값은 scheduled, live, ended, canceled 중 하나이며, 예정된 시작 시각은 scheduled_start_at, 스페이스가 만들어진 시각은 published_at 값에 들어 있습니다.
  • 무대에 오른 모든 사람author는 메인 호스트, hosts는 호스트와 공동 호스트, speakers는 발언에 초대된 계정 목록이며, 각각 id, username, 이름, 프로필 사진, 인증 여부가 함께 제공됩니다.
  • 라이브 청취자와 다시 듣기 청취metrics.live_listeners_count 값은 스페이스가 라이브인 동안 들은 사람의 총수, metrics.replay_views_count 값은 이후 녹음이 재생된 횟수입니다.
  • 다시 듣기 가능 여부is_replay_available 값은 종료된 스페이스를 X에서 계속 다시 들을 수 있는지 보여 줍니다.

X Spaces API 매개변수

매개변수필수설명
urls필수https://x.com/i/spaces/<space_id> 형식의 X 스페이스 링크이며 한 줄에 하나씩 입력합니다. 예약됨, 라이브, 종료된 스페이스를 모두 받습니다.

X Spaces API 사용 방법

스페이스 링크를 제출하고 스페이스마다 행 하나를 읽습니다.

  1. {"urls": ["https://x.com/i/spaces/1OdWgBerXWvaQz"]}을 /v1/x/space로 POST합니다.
  2. status가 succeeded가 될 때까지 GET /v1/tasks/{task_id}를 폴링합니다.
  3. results.items에서 스페이스를 하나씩 읽고, 배치가 길면 has_more가 true인 동안 results.next_cursor를 계속 넘깁니다.
curl -X POST "https://api.socq.ai/v1/x/space" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://x.com/i/spaces/1OdWgBerXWvaQz"]}'

# hosts repeats the main host from author and adds any co-hosts.

X Spaces API 추천 활용 사례

  • 직접 진행하거나 후원한 스페이스 보고: 스페이스마다 live_listeners_count, replay_views_count 값과 스피커 구성을 클라이언트나 후원사에 전달할 행사 후 보고서에 넣습니다.
  • 경쟁사 오디오 방송 추적: 경쟁사의 정기 스페이스 링크를 모아 회차마다 청취자, 다시 듣기 재생수, 게스트를 비교합니다.
  • 분야별 활발한 스피커 목록 만들기: 내 분야 스페이스의 스피커와 공동 호스트를 모아 계정마다 무대에 오른 횟수를 셉니다.
  • 예약된 스페이스의 출연진 확인: 행사 전에 scheduled_start_at과 hosts 값을 읽고, 나중에 다시 조회해 status 값이 ended나 canceled로 바뀌었는지 확인합니다.

X Spaces API 활용 팁

  • status 값이 ended가 되면 스페이스를 다시 수집해 최종 라이브 청취자 총수를 기록하고, replay_views_count 값은 collected_at 값과 함께 저장하세요. is_replay_available 값이 true인 동안 다시 듣기 재생수는 계속 늘어납니다.
  • 공동 호스트 수는 hosts 목록에서 author 항목을 뺀 수로 세세요. 메인 호스트는 두 필드에 모두 나옵니다.
  • 여러 스페이스를 합칠 때는 스피커를 id 기준으로 묶으세요. 사용자 이름이 바뀌어도 같은 사람이 한 번만 집계됩니다.

X Spaces API 외에 X의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.

  • Twitter Tweet Scraper API — x.com 또는 twitter.com 게시물 URL에서 공개 게시물 텍스트, 작성자, 참여도, 미디어, 해시태그, 멘션, 대화 관계를 가져옵니다.
  • Twitter Profile Scraper API — 사용자 이름으로 공개 계정 정보, 소개글, 프로필 이미지, 커버 이미지, 계정 상태, 공개된 오디언스 통계를 가져옵니다.
  • Twitter User Tweets Scraper API — 사용자 이름으로 최근 공개 게시물, 작성자, 미디어, 해시태그, 멘션, 참여도를 수집하며 답글은 제외합니다.
  • X Post Quotes API — 알고 있는 게시물 URL에 대한 공개 인용 게시물을 수집하며, 코멘트, 작성자, 참여도, 미디어, 타임스탬프, 원본 게시물 맥락을 포함합니다.
  • Twitter Mentions API — 지정한 계정을 멘션한 공개 게시물을 수집합니다.
  • X Account Location API — 계정의 기반 국가, X 접속 방식, 가입일, 사용자 이름 변경 횟수를 확인합니다.

다른 플랫폼 둘러보기

X 데이터를 지원되는 다른 소셜 플랫폼의 공개 데이터와 함께 활용하세요.

X Spaces API — 자주 묻는 질문

X Spaces API는 X의 라이브 오디오 방인 X 스페이스를 /i/spaces/ 링크로 조회하는 프로그래밍 인터페이스입니다. 스페이스마다 제목, 상태, 예정 시작 시각, 메인 호스트, 공동 호스트, 스피커, 라이브 청취자 총수, 다시 듣기 재생수, 다시 듣기 가능 여부를 반환합니다.

네. metrics.live_listeners_count 값은 스페이스가 라이브인 동안 들은 사람의 총수이고, metrics.replay_views_count 값은 이후 녹음이 재생된 횟수입니다.

아니요. 청취자는 수치로만 제공됩니다. 결과에 이름이 나오는 계정은 메인 호스트, 공동 호스트, 스피커입니다.

아니요. 결과는 스페이스와 청취자 규모를 설명하며, is_replay_available 값으로 X에서 녹음을 재생할 수 있는지 알 수 있습니다.

제출한 스페이스를 하나도 찾을 수 없으면 작업이 실패하고 전액 환불됩니다. 일부만 찾을 수 없으면 나머지는 평소처럼 반환됩니다.