Cookie Preferences
We use cookies to personalize content and analyze traffic. See our Cookie Policy.
还没有输出。提交表单以生成内容。
透明定价，无隐藏费用。按需支付。
| 规则与模式 | 渠道 | 积分 | 价格（美元） | 官方/参考价格 | 每日节省 |
|---|---|---|---|---|---|
audio-space-by-id otherTwitter | Starter | 0.01per post | $0.00005 | - | - |
twitter-api-graphql 使用完整指南
使用唯一的 Space ID，检索任意 Twitter/X Audio Space 的完整元数据、主持人详情和参与者信息。
ApiPass 上的 Twitter Graphql Audio Space By Id API 是一个强大的端点，开发者只需提供 Space ID（例如 1YpJkglaMaYJj），即可获取某个特定 Twitter/X Space 的全面数据。它会返回丰富的结构化信息，包括 Space 的标题、状态（live、scheduled、ended 或 canceled）、创建时间和计划时间戳、创建者资料、管理员、发言者、听众、回放可用性，以及总实时听众数和回放观看量等互动指标。ApiPass 基于 Twitter 的 GraphQL 基础设施构建，并将该能力封装为简单的异步任务工作流——通过 /api/v1/jobs/createTask 提交请求，再通过 /api/v1/jobs/recordInfo 获取结果——让你无需自行管理 OAuth 认证、速率限制或 GraphQL 查询构造。
跳过 Twitter Enterprise API 层级漫长的审批流程，只需一个 ApiPass API key 即可立即开始查询 Spaces 数据。
channel 参数默认值为 auto，会根据实时价格和稳定性指标，在可用提供商之间自动分配任务，以平衡最低成本和可靠性能。
可在 starter（超低成本）、regular（标准层级，价格远低于官方 API）和 official（原生 Twitter API，稳定性最高）之间选择，匹配你的预算和可靠性需求。
基于任务的设计支持可选 callback URLs，让你能够大规模发起请求而不会阻塞应用，非常适合批量处理数千个 Spaces。
通过 withReplays、withListeners 和 isMetatagsQuery 标志控制只获取所需数据，减少载荷大小和处理开销。
获取清晰、可预测的 JSON 输出，并带有明确的状态值（waiting、queuing、generating、success、fail），让你的应用逻辑保持简单。
返回标题、状态、media key、计划开始时间、创建/更新时间戳、对话控制、回放/剪辑可用性等信息。
访问详细的管理员、发言者和听众数组，包含用户 ID、显示名称、认证状态、头像和 Periscope 用户 ID。
包含深度嵌套的创建者数据，例如 screen name、粉丝数、资料图片、简介、位置、认证徽章和账号创建日期。
跨多个 Spaces 跟踪 total_live_listeners 和 total_replay_watched 等互动指标，识别热门音频内容。
构建平台，展示特定创建者主持的即将开始和历史 Spaces，并补充其完整资料数据。
为媒体情报、研究或合规用途编目历史 Spaces（标题、主持人、计划时间、回放可用性）。
创建告警系统，在目标 Spaces 开始、结束或可回放时通知用户。
将 ApiPass 对 Twitter Spaces 数据的简化、经济高效访问方式与 Twitter 官方 API 的企业级要求进行比较，了解为什么对于需要相同数据但不想承担额外复杂度的开发者来说，ApiPass 是更明智的选择。
Twitter 官方 API 需要 Enterprise 层级订阅（每月数千美元）以及通过审核的开发者账号，才能访问 Spaces 相关的 GraphQL 端点。ApiPass 通过按量付费模式提供相同数据，regular 层级价格远低于官方 API，starter 层级则提供超低成本访问。
官方端点需要 OAuth 2.0 认证、手动构造 GraphQL 查询、管理 feature flag，并严格处理速率限制。ApiPass 将这一切抽象为两步 REST 工作流（创建任务 → 查询任务），只需一个 Bearer token，并返回相同的 Twitter 响应结构，让你在保留完整数据保真度的同时，无需承担运维复杂性。
监控竞争对手或行业领袖主持的 Spaces，了解其内容策略、受众规模和互动模式。
验证 Space 元数据（创建者、时间戳、参与者），用于事实核查、调查报道或开源情报收集。
为 SaaS 产品提供能力，帮助播客主和创作者衡量其 Spaces 表现、回放互动和长期受众增长。
许多加密项目会通过 Spaces 举办 AMAs；使用此 API 记录每个项目 Space、归档参与者列表，并检测协同推广活动。
在 ApiPass 注册，并从你的仪表板生成 Bearer token，用于认证所有请求。
向 https://api.apipass.dev/api/v1/jobs/createTask 发送 POST 请求，将 model 设置为 twitter/graphql/audio-space-by-id，并提供 Space id，以及可选标志 isMetatagsQuery、withReplays 和 withListeners。你将在响应中收到 taskId，可用于跟踪任务进度。
使用返回的 taskId，通过 GET 请求访问 https://api.apipass.dev/api/v1/jobs/recordInfo 获取结果。当 state 变为 success 时，完整的 Audio Space 数据将出现在 resultJson 字段中。你也可以在 Step 2 中提供 callBackUrl，以便在任务完成时自动接收通知——无需轮询。
所有 API 都需要通过 Bearer Token 进行身份验证。
Authorization: Bearer
通过 Space ID 获取 Space 信息
该 API 接受具有以下结构的 JSON payload：
1{
2 "model": "string",
3 "callBackUrl": "string (optional)",
4 "channel": "auto",
5 "input": {
6 "variables": {
7 "id": "string",
8 "isMetatagsQuery": "boolean",
9 "withReplays": "boolean",
10 "withListeners": "boolean"
11 }
12 }
13}model可选string用于生成的模型名称
"twitter/graphql/audio-space-by-id"
callBackUrl可选string任务完成通知的回调 URL。如果省略，则不会发送回调。
"https://your-domain.com/api/callback"
channel可选string你可以通过 channel 参数指定 APIPASS 中对应的提供商；这些提供商负责处理实际的图像和视频生成任务。APIPASS 目前提供三种提供商选项：
channel 参数的默认值为 auto。启用后，APIPASS 会根据实时价格和稳定性指标，在可用提供商之间自动分配任务，以平衡最低成本与可靠性能。除非你有自定义路由需求，否则请保留默认值 auto。
可用选项：
auto
input 对象包含以下参数：
input.variables.id必填string1YpJkglaMaYJj
input.variables.isMetatagsQuery可选booleanfalse
input.variables.withReplays可选booleantrue
input.variables.withListeners可选booleantrue
1curl -X POST "https://api.apipass.dev/api/v1/jobs/createTask" \
2 -H "Content-Type: application/json" \
3 -H "Authorization: Bearer YOUR_API_KEY" \
4 -d '{
5 "model": "twitter/graphql/user-by-screen-name",
6 "callBackUrl": "https://your-domain.com/api/callback",
7 "input": {
8 "variables": {
9 "id": "1YpJkglaMaYJj",
10 "isMetatagsQuery": false,
11 "withReplays": true,
12 "withListeners": true,
13 }
14 }
15 }'1{
2 "code": 200,
3 "message": "success",
4 "data": {
5 "taskId": "task_12345678"
6 }
7}code状态码，200 表示成功，其他表示失败
message响应消息，失败时为错误描述
data.taskId用于查询任务状态和结果的任务 ID
