Skip to main content

完整 API 参考:所有 Sorsa 端点

下方按类别列出了所有 Sorsa API 端点。每个端点使用相同的基础 URL(https://api.sorsa.io/v3),并通过 ApiKey 请求头验证身份。无论使用哪个端点,每次调用都只扣除 1 次请求配额。新账号包含 100 次免费请求,可测试所有可用端点,无需信用卡。 点击各端点旁的文档链接,查看详细参数表、响应结构,并进行交互式测试。也可通过 API Playground 无代码测试任意端点。

用户数据

获取用户资料、粉丝和关注列表,以及账号元数据。 相关指南:粉丝与关注 | 受众地理分布 | 竞品分析

推文

获取推文内容、互动指标、回复、引用、转推用户、长文章和热门话题。 相关指南:搜索推文 | 推文互动 | X 文章 | 历史数据

搜索

搜索推文、提及和用户资料,以及查询 X Spaces。 相关指南:搜索推文 | 追踪提及 | 搜索运算符 | 发现目标受众

行为验证

检查用户是否完成了特定行为,包括关注、转推、评论、引用和加入社群,专为活动与抽奖验证而设计。 相关指南:营销活动验证

社群

访问 X 社群数据,包括成员列表、推文流和社群内搜索。 相关指南:列表与社群

列表

访问 X 列表数据,包括成员资料、订阅者和汇总推文流。 相关指南:列表与社群 | 实时监测

Sorsa Score(加密货币分析)

面向加密货币领域的分析端点:影响力评分、粉丝分类,以及 Sorsa 数据库中加密货币账号最近的关注活动。支持 usernameuser_iduser_link 相关指南:Sorsa Score 与加密货币分析

技术工具

用于 ID 转换和 API 密钥用量监控。 相关指南:ID 转换 | 价格

数据模型

大多数端点使用两个核心对象。所有变体、字段类型和边界情况请参阅响应格式

User 对象

/info/info-batch,以及粉丝、关注和用户搜索端点返回,也会通过 user 字段嵌入每条推文响应。部分加密货币分析端点会添加 followerDate;普通 /followers/follows 响应使用标准 User 模型。这些变体见响应格式

Tweet 对象

/tweet-info/search-tweets/user-tweets/comments/quotes/mentions/list-tweets 和社群推文端点返回。

TweetEntity 对象


通用方式

身份验证: 所有请求都需要 ApiKey 请求头。参阅身份验证 分页: 支持分页的端点使用游标分页。批量查询和 /top-followers 等加密货币分析列表无需游标即可返回结果。传入上一响应的 next_cursor 获取下一页;游标缺失或为 null 时表示已到末尾。参阅分页 错误格式: 所有端点发生 400401403404429500 错误时,都返回 { "message": "..." }。参阅错误码 速率限制: 所有标准套餐均为每秒 20 次请求。参阅速率限制 灵活的输入: 大多数用户相关端点支持 usernameuser_iduser_link(个人资料 URL)三种输入格式。每次只提供其中一种。

后续步骤