跳转到主要内容
POST
X Spaces 详情

X Spaces 详情

通过链接查询 X Spaces,也就是 X 上的语音直播间。每个 Space 返回标题、当前状态(预约中、直播中或已结束)、预约开始时间、主持人和联合主持人、上台发言的嘉宾、直播期间的收听人数、录音的回放次数,以及是否可以回放。可以用来汇报自己主办或赞助的 Spaces 效果,跟踪竞品的语音直播,或者整理你所在领域里活跃的发言人名单。
通过 urls 提供 X Space 链接,路径格式为 /i/spaces/。支持预约中、直播中和已结束的 Space。每个 Space 返回一条结果。

标准结果字段

任务结果使用下方稳定的 SocQ 字段。系统会统一来源特有的字段名和格式,但不会推断或补充来源未提供的数据。如需缩小返回字段集合,MCP 查询使用 fields,Typed 工具使用 _result_fields,CLI 使用 --result-fields。声明字段的值为 null 时仍会保留。 以下示例展示任务完成后的响应格式,具体数据以实际查询结果为准。

任务完成响应

授权

Authorization
string
header
必填

使用 Authorization: Bearer <token> 请求头进行身份验证。

请求体

application/json

通过 urls 提供 X Space 链接,路径格式为 /i/spaces/{space_id}。支持预约中、直播中和已结束的 Space。每个 Space 返回一条结果。

urls
string[]
必填

X Space 链接,格式为 https://x.com/i/spaces/{space_id},至少提供 1 项。

Minimum array length: 1
Minimum string length: 1
callback_url
string<uri>

可选的任务完成回调 URL。

响应

任务已受理

code
integer

HTTP 业务状态码。

data
object