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 读取一条记录。
- 向 /v1/x/space 发送 {"urls": ["https://x.com/i/spaces/1OdWgBerXWvaQz"]}。
- 轮询 GET /v1/tasks/{task_id},直到 status 变成 succeeded。
- 从 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 识别发言人,即使对方改了用户名,也只会算作同一个人。
相关 API
除了 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 的方式、注册时间和改名次数。
- Twitter Search API
- X Followers List API
- X Following List API
- X Post Replies API
- X Post Retweeters API
- X Trends API
- Twitter User Search API
- X Community API
- X Community Posts API
- X Thread Context API
- X Verified Followers API
- X List Tweets API
- Twitter List Members API
- Twitter List Followers API
- X Community Members API
- X Community Moderators API
- X Communities Search API
- X Articles API
- Twitter Media Scraper API
- X User Replies API
- Twitter Follow Checker API
- Twitter Video Transcript API