AI 文档 / 适合 LLM 的文档。 正在使用 LLM、AI 智能体或编程助手开发？请先让它读取机器可读文档，在生成请求之前了解完整上下文：完整纯文本 API 文档。
谁适合使用 Sorsa API？
Sorsa 适合任何需要以编程方式访问 X 平台数据的人。开始使用时，无需官方 X 开发者账号、Twitter API 审核或复杂的 OAuth 配置。 常见用户包括构建社交数据管道的后端开发者、开展情感分析的数据科学家、追踪品牌提及的增长营销人员、验证社群互动的 Web3 团队、通过 Make 或 Zapier 等自动化工具连接 X 数据的无代码开发者，以及从公开对话中收集训练数据集的 AI 工程师。快速开始
基础 URLApiKey 请求头中包含 API 密钥。无需 OAuth 流程、Bearer 令牌或回调 URL。
响应格式
所有端点均返回 JSON。
请求示例
正在使用 AI 开发？
Sorsa 可以轻松接入 LLM 智能体、AI 编程助手和自动化工作流。无需手动粘贴各个端点，直接为模型提供完整文档上下文：- AI 文档：了解如何以编程方式使用 Sorsa 文档。
- 文档索引（llms.txt）：所有可用页面的精简目录，帮助智能体先了解文档结构，再深入阅读。
- 完整纯文本 API 参考：一个文件中的完整 LLM 可读规范，可加入提示词、IDE 或检索索引。
API 功能
以下概述可以获取的数据。完整的数据结构、参数和响应示例请参阅 API 参考。用户
获取用户资料、受众指标、账号历史和关系图谱，包括粉丝、关注对象及认证粉丝。可逐个获取资料，也可一次批量获取最多 100 个账号。 主要端点：GET /info、GET /info-batch、GET /about、GET /followers、GET /follows、GET /verified-followers
推文
访问推文内容、互动指标、对话串、回复、引用、转推用户、用户时间线、X 长文章，以及按地区划分的热门话题。可获取单条推文，或一次获取最多 100 条。 主要端点：POST /tweet-info、POST /tweet-info-bulk、POST /user-tweets、POST /comments、POST /quotes、POST /retweeters、POST /article、GET /trends
搜索
通过查询搜索推文和用户，完整支持 X 高级搜索语法（from:、to:、since:、until:、话题标签等），并提供专门的提及追踪和 Spaces 查询功能。可使用免费的搜索构建器可视化构建查询，并参阅完整的搜索运算符参考。
主要端点：POST /search-tweets、POST /mentions、POST /search-users、GET /spaces
行为验证
确认特定社交行为是否发生：关注、评论、引用、转推或加入社群。适合访问权限控制和营销活动验证。 主要端点：POST /check-follow、GET /check-comment、POST /check-quoted、POST /check-retweet、POST /check-community-member
列表
获取公开 X 列表的成员、订阅者和推文流。 主要端点：GET /list-members、GET /list-followers、GET /list-tweets
社群
访问 X 社群内容、成员数据，以及社群内搜索。 主要端点：POST /community-tweets、POST /community-search-tweets、POST /community-members
加密货币与 Web3 分析
追踪账号的 Sorsa Score（在意见领袖、项目和 VC 中的受欢迎程度）、分数随时间的变化、粉丝类别分布、按分数排名的粉丝与关注对象，以及最近 7 天新增的关注活动。 主要端点：GET /score、GET /score-changes、GET /followers-stats、GET /top-followers、GET /top-following、GET /new-followers-7d、GET /new-following-7d
技术工具
在用户名与用户 ID 之间转换、从个人资料链接提取 ID，以及监控 API 配额用量。也可使用免费的 ID 转换器在浏览器中转换。 主要端点：GET /username-to-id、GET /id-to-username、GET /link-to-id、GET /key-usage-info
典型使用场景
品牌和媒体监测。 实时追踪与品牌或竞争对手相关的提及、关键词和情感。 数据管道。 将结构化 X 数据导出至 BigQuery、PostgreSQL、S3 或其他下游数据仓库。 受众分析。 绘制关注关系图谱，识别高价值联系，并分析创作者随时间的增长。 访问控制与社交行为验证。 在授予活动、代币空投或受限内容的访问权限之前，确认用户已完成关注、转推、评论、引用等社交任务。 AI 与 LLM 训练数据。 收集高质量公开对话数据，用于模型微调、情感分析或研究数据集。 无代码和低代码自动化。 通过 HTTP 请求模块将 Sorsa API 连接至 Make（Integromat）、Zapier、n8n 或 Pipedream 等工具。无需编写代码，即可监测账号、在出现新提及时触发工作流，或将 X 数据同步至电子表格和 CRM。 详细实现方式和工作流示例请参阅使用场景指南。无需代码即可体验
探索 Sorsa 无需编写任何代码。API Playground 让你在浏览器中调用任意端点、查看实时响应，并在集成之前试验参数。 我们还提供一系列基于 API 的免费即用工具：- 搜索构建器：可视化构建高级推文搜索查询。
- ID 转换器：在用户名、用户 ID 和个人资料链接之间转换。
- Shadowban 检测：检查账号是否受到隐性可见性限制。
- 媒体下载器：下载推文中的图片和视频。
- 用户比较：并排比较两个账号的主要指标。
- 最新粉丝：查看账号最近的粉丝。
- 互动率计算器：根据最近推文估算互动率。
- 关注检查：检查两个账号是否相互关注。
- 所在地检查：了解 X 账号所在国家。
- 账号年龄检查：查看账号创建时间。
Sorsa API 不支持哪些功能？
Sorsa 是专注于数据提取和分析的只读 API，不会在 X 平台执行写入操作：- 发布推文、回复或私信
- 点赞、收藏或转推
- 关注或取消关注账号
- 代表用户账号执行任何操作