Cookie Preferences
We use cookies to personalize content and analyze traffic. See our Cookie Policy.
还没有输出。提交表单以生成内容。
透明定价，无隐藏费用。按需支付。
| 规则与模式 | 渠道 | 积分 | 价格（美元） | 官方/参考价格 | 每日节省 |
|---|---|---|---|---|---|
audio-space-search otherTwitter | Starter | 0.01per post | $0.00005 | - | - |
twitter-api-graphql 使用完整指南
通过一次 API 调用，搜索和发现 Twitter (X) Spaces 中的实时、即将开始和过往音频对话。
ApiPass 上的 Twitter Graphql Audio Space Search API 是一个托管端点，让开发者可以使用灵活的关键词查询和状态筛选，以编程方式搜索 Twitter Spaces——该平台的实时音频对话功能。该 API 构建在 Twitter 内部 GraphQL 层之上，使你无需抓取网页界面或处理 Twitter 复杂的身份验证，即可检索匹配特定主题、关键词或状态（例如 Upcoming、Live 或 Past）的 Spaces。ApiPass 将整个流程封装为简单的两步任务式系统：通过 POST /api/v1/jobs/createTask 提交搜索请求，然后通过 GET /api/v1/jobs/recordInfo 获取结构化 JSON 结果。该 API 非常适合围绕 Twitter 的音频生态构建音频内容发现工具、社交聆听仪表盘和实时监控管道。
所有 ApiPass 端点都采用一致的 create-task / query-task 模式，让集成更可预测，并便于在代码库中标准化。
默认的 auto 通道会根据实时价格和稳定性指标，在 starter、regular 和 official 提供方之间自动分配请求，在无需手动调优的情况下平衡成本与可靠性。
跳过 OAuth 流程、开发者账号审批和速率限制协调——只需使用你的 ApiPass Bearer token。
按关键词（query）搜索，并通过 Space 状态（filter）（例如 Upcoming）缩小范围，聚焦与你使用场景相关的已排期会话。
可提供可选的 callBackUrl，在任务完成时接收自动通知，从而无需在生产系统中使用轮询循环。
可选择 starter 层进行超低成本的大规模实验，或在需要按原生 API 价格获得最高稳定性时选择 official 层——全部通过同一个接口完成。
将自由文本 query 与 filter 参数（例如 Upcoming）结合使用，精确检索你关注的 Spaces。
长时间运行的搜索会通过 taskId 以异步方式处理，任务状态（waiting、queuing、generating、success、fail）让你全面了解处理进度。
结果会以清晰的 resultJson.resultObject 负载返回，可直接解析、存储，或传入下游分析流程。
提供精选信息流，展示围绕 crypto、AI 或 sports 等特定主题的即将开始 Spaces。
监控实时音频中的品牌提及和行业对话，而不只是 tweets。
帮助主持人识别热门话题，并选择安排自己 Spaces 的最佳时间。
跟踪竞争对手或行业领袖何时发起音频活动，并分析参与模式。
了解与 Twitter 官方 Spaces 搜索端点相比，ApiPass 如何简化访问、定价和可扩展性——帮助你为项目选择最合适的方案。
Twitter 的官方 API 需要通过审批的开发者账号、更高级别的访问权限和严格的速率限制，而且其付费套餐对小团队来说可能过于昂贵。ApiPass 通过简单的 Bearer-token 请求提供相同功能，无需申请流程，让你几分钟内即可开始构建。
Twitter 的官方 API 针对每个访问层级提供单一固定的定价结构。ApiPass 让你可以在 starter、regular 和 official 提供方之间动态选择，或默认使用 auto，因此你可以根据工作负载独立扩展成本和可靠性。
汇总基于关键词的 Space 搜索，在话题进入主流信息流之前发现新兴对话主题。
实时跟踪围绕会议 hashtag、产品发布或危机事件的所有 Spaces。
记者和研究人员可以发现与正在进行的报道相关的实时音频讨论。
衡量品牌或营销活动关键词在 Twitter 音频生态中的出现频率，并与传统的基于 tweet 的提及数据结合分析。
注册 ApiPass，并从你的仪表盘生成 API key。你将在每个请求的 Authorization header 中将其用作 Bearer token。
向 /api/v1/jobs/createTask 发送 POST 请求，并将 model 设置为 twitter/graphql/audio-space-search。在 input.variables 中提供搜索参数，包括 query 关键词和可选的 filter（例如 Upcoming）以缩小结果范围。你还可以包含可选的 callBackUrl，以便在任务完成时接收自动通知。响应将返回一个唯一的 taskId，你将使用它来获取结果。
向 /api/v1/jobs/recordInfo 发送 GET 请求，并将你的 taskId 作为 query parameter。监控 state 字段——一旦它返回 success，你的 Space 搜索结果就会出现在 data.resultJson.resultObject 中，可供解析并集成到你的应用中。如果你在步骤 2 中提供了 callBackUrl，ApiPass 会自动将结果推送到你的端点，因此无需轮询。
所有 API 都需要通过 Bearer Token 进行身份验证。
Authorization: Bearer
搜索 Twitter Spaces
该 API 接受具有以下结构的 JSON 负载：
1{
2 "model": "string",
3 "callBackUrl": "string (optional)",
4 "channel": "auto",
5 "input": {
6 "variables": {
7 "filter": "string",
8 "query": "string"
9 }
10 }
11}model必填string用于生成的模型名称
"twitter/graphql/audio-space-search"
callBackUrl可选string用于接收任务完成通知的回调 URL。如果省略，则不会发送回调。
"https://your-domain.com/api/callback"
channel可选string你可以通过 channel 参数指定 APIPASS 内对应的提供商；这些提供商会处理实际的图像和视频生成任务。APIPASS 目前提供三种提供商选项：
channel 参数的默认值为 auto。启用后，APIPASS 会根据实时价格和稳定性指标，在可用提供商之间自动分配任务，以平衡最低成本和可靠性能。除非你有自定义路由需求，否则请保留默认值 auto。
可用选项：
auto
input 对象包含以下参数：
input.variables.filter可选stringUpcoming
input.variables.query可选stringa
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 "filter": "Upcoming",
10 "query": "a"
11 }
12 }
13 }'1{
2 "code": 200,
3 "message": "success",
4 "data": {
5 "taskId": "task_12345678"
6 }
7}code状态码，200 表示成功，其他表示失败
message响应消息，失败时为错误描述
data.taskId任务 ID，用于查询任务状态和结果
