一个简单的 API
获取推特公开数据

搜索公开推文、获取用户资料和粉丝、追踪互动数据,一个 REST API 全部搞定。所有接口均已包含。先用 100 次免费请求。

100 次免费请求 · 无需绑卡 · 永不过期

POST/v3/search-tweetsv3
{"query": "AI agents min_faves:100", "order": "latest"}
合成响应 · 部分字段
{
  "tweets": [
    {
      "id": "1782368585664626774",
      "full_text": "The future of AI agents is multi-modal...",
      "created_at": "2026-04-28T14:30:00Z",
      "likes_count": 2847,
      "retweet_count": 891,
      "reply_count": 42,
      "user": {
        "username": "techfounder",
        "verified": true
      }
    }
  ],
  "next_cursor": "eyJhbGciOiJIUzI1..."
}
产品

用 100 次免费请求试用 API

在 Playground 中发起真实请求、追踪用量、管理 API 密钥,全部在同一控制台完成。

api.sorsa.io/playground
Sorsa API Playground 中已完成的用户资料请求及 JSON 响应 Sorsa API Playground 中已完成的用户资料请求及 JSON 响应(深色主题)

接入之前,先看响应

选择接口,填写参数,查看 JSON 响应。无需写代码。

免费试用 API
api.sorsa.io/overview
Sorsa API 控制台界面预览 Sorsa API 控制台界面预览(深色主题)

剩余请求数一目了然

查看剩余额度,追踪请求量的变化,按 API 密钥查看用量。

免费试用 API
api.sorsa.io/overview/keys
Sorsa 控制台的 API 密钥页面,显示遮盖后的密钥及各密钥的操作 Sorsa 控制台的 API 密钥页面,显示遮盖后的密钥及各密钥的操作(深色主题)

在一处管理所有 API 密钥

查看并管理用于把你的应用接入 Sorsa 的 API 密钥。

免费试用 API
docs.sorsa.io/quickstart
Sorsa API 文档:快速上手指南,含 cURL 请求示例和 JSON 响应 Sorsa API 文档:快速上手指南,含 cURL 请求示例和 JSON 响应(深色主题)

清晰的文档,最快跑通第一个请求

每个接口都用通俗的语言讲清楚,附 cURL、Python 和 JavaScript 的可复制示例。另有供 AI 智能体读取的 LLM 版文档。

阅读文档
对比

更多 X 数据,更低成本

数据成本更低。所有接口统一按请求计费。
先用 100 次免费请求。

对比项Sorsa API官方 X API其他服务商
每 1,000 条推文成本$0.02 起$5.00$0.15
每 1,000 份用户资料成本$0.02 起$10.00$0.10 起
免费试用100 次免费请求无免费试用$0.10 试用额度
速率限制20 次/秒约 0.3 次/秒不一定
延迟(P50)300 毫秒约 1 秒500 毫秒
AI 可读文档有无部分
计费模式固定:1 次请求 = 1 次调用按资源付费点数制
付款方式银行卡与加密货币仅银行卡不一定
AI 原生

把 AI 开发工具接入 Sorsa API

在兼容的开发流程中使用 API 参考文档、MCP 服务器或 Sorsa 技能。

把 API 文档地址交给你的编程助手,让它帮你写接入代码。

api.sorsa.io/v3/static/sorsa_api_v3_documentation_en.txt

用你的 Sorsa API 密钥连接兼容的 MCP 客户端。请按所用客户端的说明完成配置。

启动命令示例 $npx sorsa-mcp 配置 MCP 服务器

在支持的智能体环境中使用 Sorsa API 技能。配置方法和要求见代码仓库。

在 GitHub 获取技能
Codex · Claude · Cursor
找出点赞超过 100 的 AI 智能体相关推文。
正在调用 POST /v3/search-tweets
import os, requests

key = os.environ["SORSA_API_KEY"]
r = requests.post(
    "https://api.sorsa.io/v3/search-tweets",
    headers={"ApiKey": key},
    json={"query": "AI agents min_faves:100"},
)
print(r.json())
接口

41 个接口,获取 X(Twitter)公开数据

搜索、用户资料、粉丝、时间线和验证。按任务选择接口,查看请求和响应字段。

查找最新的品牌提及
POST/v3/search-tweets
每页搜索结果最多 20 条推文,可按热门或最新排序。
获取账号的粉丝
GET/v3/followers
每页最多返回 200 份可获取的粉丝资料。
核验用户是否转发
POST/v3/check-retweet
查看验证结果,以及可能返回的续查 cursor。
拉取账号时间线
POST/v3/user-tweets
用返回的 cursor 逐页获取结果。
一次调用按 ID 取 100 条推文
POST/v3/tweet-info-bulk
每次批量请求最多按 ID 或链接获取 100 条已知推文。
按地区查看趋势
GET/v3/trends
获取所选地区的可用趋势。
获取 X 列表成员
GET/v3/list-members
使用 list-members 接口及其分页。
按条件筛选提及
POST/v3/mentions
使用该接口支持的互动与日期筛选条件。
获取认证粉丝
GET/v3/verified-followers
查看可获取的认证粉丝资料。
成本

你的工作负载,实际要花多少钱?

估算你的工作负载需要多少次 Sorsa API 请求,再对照可选套餐。

搜索、时间线、提及
官方:每条帖子读取 $0.005
单个或批量查询用户资料
官方:每份用户资料读取 $0.010
粉丝和关注列表
官方:每次读取 $0.010
用户是否关注、转发或评论
官方:每次读取 $0.010
推荐套餐:Pro
每月最多 10 万次请求
Sorsa
$199/月
固定价
官方 X API
约 $12,050/月
按量付费
每月节省 $11,851,比官方 X API 便宜 98%。
一年下来就是 $142,212。
选择 Pro
开发体验

用一个 API 密钥发出第一次请求

创建账号,复制你的 Sorsa API 密钥,用你熟悉的语言试一次请求。

1注册账号 2复制 Sorsa API 密钥 3发出第一次请求
curl "https://api.sorsa.io/v3/info?username=example_user" \
  -H "ApiKey: YOUR_API_KEY"
合成的用户资料响应 · 部分字段
{
  "id": "1900000000000000001",
  "username": "example_user",
  "display_name": "Example account",
  "followers_count": 1200,
  "followings_count": 85
}
可靠性

自 2022 年起久经实战的基础设施。

持续维护的 X(Twitter)数据 API:干净的 JSON、稳定的响应结构、基于 cursor 的分页。平台变动由我们处理,你只需专注自己的应用。

20次/秒

统一的速率限制

所有套餐速度相同。

99.9%

可用性

公开状态页,实时更新。

300毫秒

P50 响应时间

边缘缓存响应。

41

API 接口

搜索、用户资料、粉丝和验证。

生产实践

开发者在 Sorsa API 上交付得更快。

从交易信号到抽奖验证:看开发者如何以可预期的价格、简单的配置接入 X(Twitter)数据。

案例 01

交易信号数据管道

某交易数据管道全天候监测 X 上的股票代码提及。官方 X API 的速率限制让轮询恰恰在行情剧烈波动时中断,另外两家服务商在高负载下也扛不住。迁移到 Sorsa 后,这条管道获得了稳定的 20 次/秒速率限制,可以持续监测市场。

全天候监测20 次/秒速率限制
案例 02

抽奖验证平台

一位独立开发者做的抽奖平台,原本用官方 X API 验证关注、转发和评论,直到预计成本超过了月收入。开发者利用周末把这些验证迁移到 Sorsa 的专用验证接口。按请求计费、价格固定,让平台的单位成本重新回到盈利区间。

周末两天完成迁移按请求计费,价格固定
案例 03

AI 工程团队

某 AI 团队用 Claude 和 Sorsa 的 API 文档迁移了现有的 X 数据客户端。模型第一遍就完成了约 90% 的迁移,剩下的工作只是重命名两个字段。响应结构稳定、JSON 格式一致,团队直接照着文档就能开发,无需提交支持工单,也没有沙盒审批流程。接入 Sorsa 只需注册账号并拿到 API 密钥。

借助 AI,约两小时完成客户端迁移
价格

每 1,000 条推文 $0.02 起。

固定套餐,没有点数换算:所有接口都是 1 次请求 = 1 个单位。一次请求返回最多 100 条推文或 200 份资料,这就是为什么单条推文的价格能压过任何按次计费的接口。所有套餐都是 20 次/秒。支持银行卡或加密货币付款。

Starter
1 万 次请求
$49/月
按月计费
每 1,000 条推文 $0.049
按官方 API 价格折合 $5,000 的数据量

  • 每月 1 万次请求
  • 含约 100 万条推文或约 200 万份资料
  • 20 次/秒速率限制
  • 可创建多个 API 密钥
选择 Starter
Enterprise
50 万 次请求
$899/月
按月计费
每 1,000 条推文 $0.018
这个用量需要 X Enterprise 合同,每月约 4.2 万美元起

  • 每月 50 万次请求
  • 含约 5000 万条推文或约 1 亿份资料
  • 包含 Pro 的全部功能
  • 优先支持
选择 Enterprise
不确定选哪个?每个账号都从 100 次免费请求开始:最多 1 万条推文或 2 万份用户资料。无需绑卡,永不过期,覆盖全部 41 个接口。免费开始

在做大项目?

50 万次请求以上的用量、定制基础设施,以及与我们团队的直接联系。专为在生产环境跑高吞吐的平台准备。

  • 用量 每月 50 万次请求以上
  • 基础设施 更高的速率限制,专属
  • 价格 批量折扣与定制条款
  • 支持 专属客户经理
常见问题

问题,都在这里。

Sorsa API 是什么?

Sorsa API 是面向 X(Twitter)公开数据的只读 REST API。它提供 41 个接口,覆盖用户资料、帖子、高级搜索、粉丝和关注、列表、X Articles、Space、趋势和互动验证,返回干净的 JSON。你只需一个 Sorsa API 密钥即可完成全部配置,无需申请 X 开发者账号。按请求计费、价格固定,每 1,000 条推文 $0.02 起,每个新账号都有 100 次免费请求。Sorsa 自 2022 年起稳定运行在生产环境中,最初名为 TweetScout API。

使用 Sorsa 需要 X 开发者账号或个人 X 账号吗?

不需要。你唯一需要的凭证是 Sorsa API 密钥,注册后立即发放。无需提交 X 开发者申请,无需走 OAuth 流程,也不用排队等审批,更不会把你的 X 登录信息或 Cookie 交给 Sorsa。创建账号,在控制台复制密钥,放进 ApiKey 请求头,几分钟内就能跑通第一次请求。

能获取哪些数据?哪些不在范围内?

Sorsa API 返回 X 公开数据:用户资料(逐个获取或每批 100 个)、粉丝和关注列表(每页 200 个)、按 ID 获取帖子(每批 100 条)、用户完整时间线、回复、引用和转发用户。此外还有支持全部高级搜索语法的关键词和提及搜索,以及列表、X Articles、Space 和按地区获取的趋势。账号“关于”信息(如所在国家)和确认用户是否关注、转发、引用或回复的验证接口也都包含在内。不在范围内的有:受保护账号、私信、谁点赞了某条帖子、用户的点赞或书签、已删除的帖子,以及发帖、点赞、关注、发消息等任何写操作。Sorsa 从产品设计上就是只读的。完整接口列表见 API 参考文档。

Sorsa 和官方 X API 有什么不同?

Sorsa 按请求计费,官方 X API 按资源计费。在 X 上,响应里的每条帖子、每份用户资料、每个粉丝都单独计费:每 1,000 次帖子读取约 $5.00,作者资料另收 $10.00,读取上限为每月 200 万条帖子。在 Sorsa 上,一次请求最多返回 100 条推文或 200 份用户资料,并包含作者数据,因此 1,000 条推文 $0.02 起;读密集型工作负载的成本最多可便宜 50 倍。你只需一个 Sorsa API 密钥,不必再走 OAuth 和开发者申请。代价是 Sorsa 只读:发帖、私信等写操作仍需使用官方 API。分步迁移方法见迁移指南。

Sorsa 和其他第三方 X API、爬虫相比如何?

主要有三点。第一,按请求计费、价格固定,不按条计费;批量接口一次请求最多返回 100 条推文或 200 份用户资料,所以 Sorsa 能做到每 1,000 条推文 $0.02,按条计费的 API 通常要贵好几倍。第二,覆盖很多替代方案缺失的能力:关注、转发、引用和回复验证,X Articles、Space,以及账号“关于”信息(如所在国家)。第三,Sorsa 是托管服务:响应结构保持稳定,X 平台有变动时由我们修复,不需要改你的代码。

数据是实时的吗?

是的。每次请求都在调用时实时获取,所以粉丝数、互动指标和搜索结果反映的是 X 当下的状态,不是缓存副本。P50 响应时间约 300 毫秒。Sorsa 不提供流式 firehose 或 webhook;实时监测通过轮询实现,速度最高每秒 20 次请求,所有套餐都包含。唯一的例外是限流检测,同一账号的结果会缓存一小时。

数据最早能追溯到什么时候?

可以追溯到账号的第一条帖子。用户时间线可以分页翻完全部发帖历史,没有 3,200 条推文的上限;搜索支持 since: 和 until: 语法,可检索到 2006 年以来的帖子,任何关键词、话题标签或账号的旧帖子都能获取。互动数按请求时的实际数值返回。粉丝和关注列表反映当前的关系;Sorsa 不保存“谁关注过谁”的历史快照。方法和代码见 X 历史数据指南。

速率限制是多少?

从 Starter 到 Enterprise,所有套餐都是每秒 20 次请求,包含全部接口,低档套餐也不降速。一次请求最多返回 100 条推文或 200 份用户资料,相当于分页之前每秒最多 2,000 条推文或 4,000 份用户资料。各套餐只在月请求量上有区别:1 万、10 万或 50 万次请求。超出这个量的定制套餐提供更高的专属速率限制;联系销售即可开通。

X 平台有变动时会怎样?

你这边什么都不用做。X 平台有变动时,由 Sorsa 团队负责更新,响应结构保持不变,你的集成无需改代码就能继续运行。这正是持续维护的服务和自己写的脚本或开源库的实际区别:后者每次 X 更新后都得你自己修。Sorsa 自 2022 年起稳定运行在生产环境中,公开的状态页实时展示可用性和延迟。

Sorsa 是 X 官方产品吗?

不是。Sorsa 是独立服务,与 X Corp. 无隶属关系,也未获得其认可或赞助;X 和 X 标志是 X Corp. 的商标。你通过 Sorsa 自己的 API、控制台和服务条款访问 X 公开数据,并需自行确保对这些数据的使用、存储和分享符合适用于你和你的项目的法律,包括保护你所处理帖子的作者的隐私规定。本页内容不构成法律建议。

如何接入 Sorsa API?支持哪些语言和 AI 工具?

任何能发送 HTTP 请求的语言都可以。Sorsa API 是标准 REST:把密钥放进 ApiKey 请求头,发送 JSON,收到 JSON,不需要 SDK。现有指南覆盖 Python、Node.js、Go、PHP、n8n、Make 和 Zapier。如果用 AI 辅助开发,把这个文档地址粘贴到 Claude Code、Cursor、ChatGPT 或 Codex 里,让模型写好客户端;也可以从 npm 安装 sorsa-mcp 服务器,直接为 Claude 和其他 MCP 客户端提供实时 X 数据。大多数集成,包括从官方 X API 迁移,都能在两小时内完成。

怎么收费?可以免费试用吗?

固定价格套餐下,每 1,000 条推文 $0.02 起,每 1,000 份用户资料 $0.01 起,所有接口都是一次 API 调用计为一次请求。每个新账号都有 100 次免费请求,最多可获取 1 万条推文或 2 万份用户资料,无需绑卡,永不过期。付费套餐每月 1 万到 50 万次请求,可按月或按年付费(按年省 16%),支持银行卡或加密货币付款,随时可以取消。完整套餐详情和成本计算器见价格页面。

提供什么样的支持和可用性?

支持通过工单进行:在你的控制台提交工单,团队会在那里回复;另有完整文档和公开状态页。月请求量达到 100 万次后,可以申请专属客户经理,更快处理你的问题。自 2022 年以来可用性保持在 99.9%,生产环境没有发生过重大故障,P50 响应时间约 300 毫秒。X 平台有变动时由 Sorsa 负责修复,所以大多数团队几乎不需要提交工单。

还有其他问题?写信到 contacts@sorsa.io,或注册后在控制台提交支持工单。

3 分钟开始获取 X 公开数据

创建账号,发起一次请求,查看响应。前 100 次请求免费:无需绑卡,永不过期。

免费获取 API 密钥
免费获取 API 密钥 100 次免费请求,无需绑卡