Skip to main content
Sorsa API 提供对 X（原 Twitter）公开数据的只读访问，包括推文、用户资料、关注关系图谱、互动指标、社群数据等。本页将常见使用场景与对应端点和指南关联，帮助你直接找到所需内容。

​
社交聆听与品牌监测

实时了解人们对品牌、产品或行业的讨论。在负面情绪升级前发现问题、衡量活动效果，并了解公众认知。 主要端点：
  • /search-tweets：在所有公开推文中搜索任意关键词、话题标签或短语
  • /mentions：追踪特定用户名被标记的每次提及，通过互动筛选减少噪声
  • /list-tweets：通过 X 列表同时监测多个账号
指南：搜索推文 | 追踪提及 | 实时监测 | 搜索运算符

​
竞品情报

对比竞争对手资料、分析内容策略、了解受众构成，并监测公众对他们的评价。 主要端点：
  • /info 和 /info-batch：获取一个或多个账号的资料快照（粉丝、推文、简介）
  • /user-tweets：获取竞争对手时间线，分析内容组合和表现最佳的帖子
  • /mentions：查看用户对竞争对手的讨论，并按互动情况筛选
  • /followers 和 /verified-followers：提取并分析竞争对手的粉丝
  • /score：比较加密货币生态中的影响力，适用于 Web3/加密货币账号
指南：竞品分析 | 粉丝与关注 | Sorsa Score 与加密货币分析

​
潜在客户开发与受众发现

通过搜索用户资料、提取相关账号的粉丝列表、分析社群成员，或寻找积极讨论特定话题的人，发现潜在客户、合作伙伴或社群成员。 主要端点：
  • /search-users：按简介关键词查找账号，如职位、兴趣或细分领域
  • /followers：提取竞争对手或行业领袖的粉丝
  • /community-members：获取特定主题 X 社群的成员列表
  • /search-tweets：寻找正在讨论你产品所解决痛点的人
指南：发现目标受众 | 粉丝与关注 | 列表与社群

​
营销活动与抽奖验证

开展关注、转推、评论、引用、加入社群等互动活动，并确认每位参与者确实完成了要求的行为。根据验证结果自动发放奖励。 主要端点：
  • /check-follow：用户是否关注了你的账号？
  • /check-retweet：是否转推了指定帖子？
  • /check-comment：是否发表了评论？
  • /check-quoted：是否引用了推文？
  • /check-community-member：是否加入了社群？
指南：营销活动验证

​
历史研究与数据收集

访问最早可追溯至 2006 年的公开推文档案。分析过去的事件、构建训练数据集、研究讨论随时间的变化，或审查品牌完整的发帖历史。 主要端点：
  • /search-tweets 配合 since: 和 until:：在任意历史时间窗口按关键词搜索
  • /user-tweets：分页获取账号的完整时间线
  • /tweet-info-bulk：根据推文 ID 列表补全当前互动数据
指南：历史数据 | 搜索运算符

​
实时监测与提醒

在发布后数秒内发现特定账号或匹配关键词的新推文。将提醒发送到 Slack、Discord、数据库或自定义 webhook。 主要端点：
  • /list-tweets：每轮只需一次请求即可监测整个 X 列表（最多 5,000 个账号）
  • /user-tweets：追踪单个重要账号
  • /search-tweets 配合 order: "latest"：实时监测关键词或话题标签
  • /mentions：发现新出现的 @提及
指南：实时监测

​
推文与帖子分析

分析特定推文的互动：谁回复、谁引用、谁转推，以及他们说了什么。衡量传播范围、识别重要评论者，并比较内容表现。 主要端点：
  • /tweet-info 和 /tweet-info-bulk：获取一条或多条推文的完整指标
  • /comments：推文下的所有回复
  • /quotes：所有引用推文
  • /retweeters：所有转推用户
  • /article：X 文章（长文章）的完整内容
指南：推文互动 | X 文章

​
受众地理分布与人口特征

了解账号受众所在地。按国家绘制粉丝分布，用于广告定向、意见领袖评估或市场扩张研究。 主要端点：
  • /followers：提取粉丝列表
  • /about：查询每个账号关联的国家
指南：受众地理分布

​
加密货币与 Web3 分析

通过 Sorsa 专有评分系统评估加密货币账号的实际影响力。该系统衡量账号在有影响力的加密货币 KOL、项目和 VC 中的认可度。追踪分数趋势、发现新兴项目，并识别非自然增长。 主要端点：
  • /score 和 /score-changes：影响力分数及每周、每月变化
  • /followers-stats：按类别划分粉丝（意见领袖、项目、VC）
  • /top-followers 和 /top-following：按分数排名的前 20 位
  • /new-followers-7d 和 /new-following-7d：加密货币账号最近的关注活动
指南：Sorsa Score 与加密货币分析

​
AI 与 LLM 训练数据

收集大规模推文数据集，用于语言模型微调、情感分类器训练或检索增强生成（RAG）管道。Sorsa 返回整洁的 JSON，可直接接入机器学习工作流。 主要端点：
  • /search-tweets：按主题、语言和日期范围大规模收集推文
  • /user-tweets：获取完整时间线以构建语料库
  • /comments 和 /quotes：收集问答对、辩论等对话数据
指南：搜索推文 | 历史数据 | 优化 API 使用

​
SaaS 与分析平台开发

基于 Sorsa 的数据层构建社交分析工具、控制台或监测平台。统一价格模式（一次 API 调用计为一次请求，与返回数据量无关）和每秒 20 次的速率限制，使你可以通过一个 API 密钥服务多个最终用户。 主要端点： 所有套餐都可使用全部端点。完整规范请参阅 API 参考。 指南：优化 API 使用 | 价格 | 速率限制

​
快速查找端点

如果已经明确需要什么数据，可在这里找到对应端点：

​
不确定从哪里开始？

  1. 获取 API 密钥：按照快速入门操作。每个新账号包含 100 次免费请求，无需信用卡、永不过期。
  2. 尝试搜索：将以下内容粘贴到终端，10 秒内即可看到数据：
  1. 无需代码即可体验：通过 API Playground 的可视化界面测试任意端点。
  2. 选择指南：从上方列表中选择符合使用场景的指南。
  3. 查看价格：通过价格页面估算月度成本。