x/
space

通过链接查询 X Spaces,返回标题、状态、开始时间、主持人、发言人、直播收听总人数和回放次数,预约中、直播中和已结束的 Space 都能查。

X Spaces API

Space 链接输入
主持人与发言人
收听与回放次数
每条结果 0.7 积分
等待提交
等待提交

填写参数并发送请求,任务状态和标准化结果会显示在这里。

README

由 SocQ 维护 · 更新于

X Spaces

X Spaces(原 Twitter Spaces)是 X 上的语音直播间,每个 Space 都有标题、从预约到直播再到结束的状态、一位主持人和若干联合主持人、被请上台的发言人,以及直播时的收听人数和录音的回放次数。有了这些信息,就能汇报单场 Space 的覆盖面,按期追踪一档固定节目,也能看出某个领域里哪些人经常上台发言。

X Spaces API 主要特性

  • 任何阶段的 Space 链接都能查提交 https://x.com/i/spaces/<id> 链接,不论 Space 是预约中、直播中还是已经结束,每个都返回一条记录。
  • 状态与时间status 的取值是 scheduled、live、ended 或 canceled,scheduled_start_at 是计划开始时间,published_at 是 Space 的创建时间。
  • 台上的每一个人author 是主持人,hosts 列出主持人和联合主持人,speakers 列出受邀发言的账号,每人都带有 id、用户名、名称、头像和认证标记。
  • 直播与回放的听众metrics.live_listeners_count 是直播期间收听的总人数,metrics.replay_views_count 是之后录音被播放的次数。
  • 能否回放is_replay_available 表示 Space 结束后是否还能在 X 上回放。

X Spaces API 参数

参数必填描述
urls必填X Space 链接,格式为 https://x.com/i/spaces/<space_id>,每行一个;预约中、直播中和已结束的 Space 都可以提交。

如何使用 X Spaces API

提交 Space 链接,每个 Space 读取一条记录。

  1. 向 /v1/x/space 发送 {"urls": ["https://x.com/i/spaces/1OdWgBerXWvaQz"]}。
  2. 轮询 GET /v1/tasks/{task_id},直到 status 变成 succeeded。
  3. 从 results.items 读取每个 Space;批量较大时,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 里会重复 author 中的主持人,并加上联合主持人。

X Spaces API 最佳使用场景

  • 汇报自己主办或赞助的 Space: 把每场 Space 的 live_listeners_count、replay_views_count 和发言嘉宾整理成活动复盘,交给客户或赞助方。
  • 追踪竞品的语音节目: 收集竞品固定 Space 的链接,逐期比较收听人数、回放次数和嘉宾。
  • 整理细分领域的活跃发言人: 汇总你所在领域各场 Space 的发言人和联合主持人,统计每个账号上台的次数。
  • 核对预约 Space 的阵容: 活动开始前读取 scheduled_start_at 和 hosts,之后再查一次,看 status 变成了 ended 还是 canceled。

X Spaces API 使用建议

  • 等 status 变成 ended 后再采集一次,记录最终的直播收听总人数;replay_views_count 要和 collected_at 一起保存,因为 is_replay_available 为 true 期间回放次数还会继续增加。
  • 统计联合主持人时,用 hosts 减去 author 那一条,主持人在两个字段里都会出现。
  • 合并多场 Space 时按 id 识别发言人,即使对方改了用户名,也只会算作同一个人。

除了 X Spaces API,需要其他类型的 X 公开数据时,可以使用以下 API。

  • Twitter Tweet Scraper API — 从 x.com 或 twitter.com status URL 获取公开帖子正文、作者、互动、媒体、标签、提及和会话关系。
  • Twitter Profile Scraper API — 按 username 获取公开账号身份、简介、头像、封面、账号状态和可见受众统计。
  • Twitter User Tweets Scraper API — 按 username 采集近期公开帖子、作者、媒体、标签、提及和互动指标,并排除回复。
  • X Post Quotes API — 按已知 status URL 采集公开引用帖,返回评论正文、作者、互动、媒体、时间和来源帖子上下文。
  • Twitter Mentions API — 采集提及指定账号的公开帖子。
  • X Account Location API — 查询账号所在的国家或地区、连接 X 的方式、注册时间和改名次数。

探索其他平台

还可以将 X 数据与其他已支持社交平台的公开数据结合使用。

X Spaces API — 常见问题

X Spaces API 是一个用于通过 /i/spaces/ 链接查询 X Spaces(X 上的语音直播间)的 API。它返回每个 Space 的标题、状态、预约开始时间、主持人、联合主持人、发言人、直播收听总人数、回放次数以及能否回放。

能。metrics.live_listeners_count 是直播期间收听的总人数,metrics.replay_views_count 是之后录音被播放的次数。

不能。听众只以人数形式返回,结果里有名字的账号是主持人、联合主持人和发言人。

不会。结果描述的是 Space 本身和听众数据;is_replay_available 会告诉你录音能否在 X 上回放。

提交的 Space 全都找不到时,任务失败并全额退款;只有部分找不到时,其余 Space 照常返回。