介绍

以下页面介绍了 X API 中的 Spaces 端点。要了解有关 Spaces 的更多信息，请访问 help.x.com。

Spaces 通过实时音频对话实现表达与互动。Spaces 端点提供用于围绕 Spaces 构建新功能的工具。你可以使用这些端点查询正在进行或已排期的 Spaces，或构建发现功能，帮助你的用户找到他们可能感兴趣的 Spaces。

我们鼓励你发挥创造力，在我们原有的基础上进一步拓展 Spaces 的玩法。借助这些端点，你可以基于标题中的关键词向听众推荐 Spaces，或呈现用户所关注账号正在进行或即将开始的 Spaces；你还可以帮助主持人更好地了解其 Spaces 的表现，并获得更多受众洞察。

​

重要资源

以下资源可帮助你开始并集成 Spaces 端点：

• 获取 X API v2 的访问权限

• Spaces 数据字典

• 向 Spaces 端点发出你的首个请求

   

​

当前可用功能

Spaces 查询	按单个 Spaces ID 查询 按多个 Spaces ID 查询 按创建者 ID 查询 查询已购票用户列表
搜索 Spaces	按关键字搜索 Spaces

​

了解 Spaces 的生命周期

与 X Developer Platform 的其他资源不同，Spaces 具有固定的生命周期。Spaces 最多可在计划开始日期前 14 天预约，并在结束后不再可用。主持人也可以在开始前的任何时间取消先前已排期的 Space。

Spaces 在直播期间可访问；一旦结束，将无法再通过 Spaces 端点检索，并会返回错误消息以表明这种情况。

当你的应用处理 Spaces 的 data 时，你有责任返回最新信息，并移除平台上已不再可用的 data。Spaces 查询端点 可以帮助你确保符合用户的期望与意图。  

​

Spaces 中的角色

这些端点反映了 Spaces 在 X 应用中的运作方式。在 Spaces 中，X 用户可根据他们在某个 Space 中的互动方式被分配不同的角色。  

​

创建者（或主要 Host）

主要 Host 是创建了 Space 的用户，也是该 Space 的所有者。目前，Space 只能有一个 Host，因此主要 Host 就是唯一的 Host。在 Spaces 数据字典 中，主要 Host 信息位于 creator_id 字段，该字段可展开为一个 user 对象。  

​

主持人

主要主持人可以将一个或多个用户设为联合主持人。在 Spaces 数据字典中，这些主持人会以 host_ids 显示，并可展开为用户对象列表。主持人身份可在单个 Space 的进行期间发生变化，这些端点返回的元数据将反映发起请求时的状态。

你的应用可以通过检查 creator_id 值识别主要主持人，并通过检查 host_ids 值确定联合主持人。  

​

发言者

发言者是获准在 Space 中发言的用户。任意时刻可有零名或多名发言者，且每个 Space 最多可有 10 名发言者（包含主持人）。在 Space 的数据字典中，发言者会以 speaker_ids 列表返回，您可以将其展开为用户对象列表。  

​

听众

听众可以收听 Space，随时使用预设反应，并申请成为发言者（如果主持人在 Space 设置中启用了该选项）。听众信息只会以参与者（包括主持人）的总数形式返回，显示在 participant_count 字段中。