完整 API 参考:所有 Sorsa 端点
下方按类别列出了所有 Sorsa API 端点。每个端点使用相同的基础 URL(https://api.sorsa.io/v3),并通过 ApiKey 请求头验证身份。无论使用哪个端点,每次调用都只扣除 1 次请求配额。新账号包含 100 次免费请求,可测试所有可用端点,无需信用卡。
点击各端点旁的文档链接,查看详细参数表、响应结构,并进行交互式测试。也可通过 API Playground 无代码测试任意端点。
用户数据
获取用户资料、粉丝和关注列表,以及账号元数据。
相关指南:粉丝与关注 | 受众地理分布 | 竞品分析
推文
获取推文内容、互动指标、回复、引用、转推用户、长文章和热门话题。
相关指南:搜索推文 | 推文互动 | X 文章 | 历史数据
搜索
搜索推文、提及和用户资料,以及查询 X Spaces。
相关指南:搜索推文 | 追踪提及 | 搜索运算符 | 发现目标受众
行为验证
检查用户是否完成了特定行为,包括关注、转推、评论、引用和加入社群,专为活动与抽奖验证而设计。
相关指南:营销活动验证
社群
访问 X 社群数据,包括成员列表、推文流和社群内搜索。
相关指南:列表与社群
列表
访问 X 列表数据,包括成员资料、订阅者和汇总推文流。
相关指南:列表与社群 | 实时监测
Sorsa Score(加密货币分析)
面向加密货币领域的分析端点:影响力评分、粉丝分类,以及 Sorsa 数据库中加密货币账号最近的关注活动。支持username、user_id 或 user_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 时表示已到末尾。参阅分页。
错误格式: 所有端点发生 400、401、403、404、429、500 错误时,都返回 { "message": "..." }。参阅错误码。
速率限制: 所有标准套餐均为每秒 20 次请求。参阅速率限制。
灵活的输入: 大多数用户相关端点支持 username、user_id 或 user_link(个人资料 URL)三种输入格式。每次只提供其中一种。