> ## Documentation Index > Fetch the complete documentation index at: https://docs.sorsa.io/llms.txt > Use this file to discover all available pages before exploring further. # 使用场景概览 Sorsa API 提供对 X（原 Twitter）公开数据的只读访问，包括推文、用户资料、关注关系图谱、互动指标、社群数据等。本页将常见使用场景与对应端点和指南关联，帮助你直接找到所需内容。 *** ## 社交聆听与品牌监测 实时了解人们对品牌、产品或行业的讨论。在负面情绪升级前发现问题、衡量活动效果，并了解公众认知。 **主要端点：** * `/search-tweets`：在所有公开推文中搜索任意关键词、话题标签或短语 * `/mentions`：追踪特定用户名被标记的每次提及，通过互动筛选减少噪声 * `/list-tweets`：通过 X 列表同时监测多个账号 **指南：**[搜索推文](https://docs.sorsa.io/zh-Hans/search-tweets) | [追踪提及](https://docs.sorsa.io/zh-Hans/search-mentions) | [实时监测](https://docs.sorsa.io/zh-Hans/real-time-monitoring) | [搜索运算符](https://docs.sorsa.io/zh-Hans/search-operators) *** ## 竞品情报 对比竞争对手资料、分析内容策略、了解受众构成，并监测公众对他们的评价。 **主要端点：** * `/info` 和 `/info-batch`：获取一个或多个账号的资料快照（粉丝、推文、简介） * `/user-tweets`：获取竞争对手时间线，分析内容组合和表现最佳的帖子 * `/mentions`：查看用户对竞争对手的讨论，并按互动情况筛选 * `/followers` 和 `/verified-followers`：提取并分析竞争对手的粉丝 * `/score`：比较加密货币生态中的影响力，适用于 Web3/加密货币账号 **指南：**[竞品分析](https://docs.sorsa.io/zh-Hans/Competitor-Analysis) | [粉丝与关注](https://docs.sorsa.io/zh-Hans/followers-and-following) | [Sorsa Score 与加密货币分析](https://docs.sorsa.io/zh-Hans/sorsa-score-and-crypto-analytics) *** ## 潜在客户开发与受众发现 通过搜索用户资料、提取相关账号的粉丝列表、分析社群成员，或寻找积极讨论特定话题的人，发现潜在客户、合作伙伴或社群成员。 **主要端点：** * `/search-users`：按简介关键词查找账号，如职位、兴趣或细分领域 * `/followers`：提取竞争对手或行业领袖的粉丝 * `/community-members`：获取特定主题 X 社群的成员列表 * `/search-tweets`：寻找正在讨论你产品所解决痛点的人 **指南：**[发现目标受众](https://docs.sorsa.io/zh-Hans/target-audiences-Discovery) | [粉丝与关注](https://docs.sorsa.io/zh-Hans/followers-and-following) | [列表与社群](https://docs.sorsa.io/zh-Hans/lists-and-communities) *** ## 营销活动与抽奖验证 开展关注、转推、评论、引用、加入社群等互动活动，并确认每位参与者确实完成了要求的行为。根据验证结果自动发放奖励。 **主要端点：** * `/check-follow`：用户是否关注了你的账号？ * `/check-retweet`：是否转推了指定帖子？ * `/check-comment`：是否发表了评论？ * `/check-quoted`：是否引用了推文？ * `/check-community-member`：是否加入了社群？ **指南：**[营销活动验证](https://docs.sorsa.io/zh-Hans/Marketing-Campaign-Verification) *** ## 历史研究与数据收集 访问最早可追溯至 2006 年的公开推文档案。分析过去的事件、构建训练数据集、研究讨论随时间的变化，或审查品牌完整的发帖历史。 **主要端点：** * `/search-tweets` 配合 `since:` 和 `until:`：在任意历史时间窗口按关键词搜索 * `/user-tweets`：分页获取账号的完整时间线 * `/tweet-info-bulk`：根据推文 ID 列表补全当前互动数据 **指南：**[历史数据](https://docs.sorsa.io/zh-Hans/historical-data) | [搜索运算符](https://docs.sorsa.io/zh-Hans/search-operators) *** ## 实时监测与提醒 在发布后数秒内发现特定账号或匹配关键词的新推文。将提醒发送到 Slack、Discord、数据库或自定义 webhook。 **主要端点：** * `/list-tweets`：每轮只需一次请求即可监测整个 X 列表（最多 5,000 个账号） * `/user-tweets`：追踪单个重要账号 * `/search-tweets` 配合 `order: "latest"`：实时监测关键词或话题标签 * `/mentions`：发现新出现的 @提及 **指南：**[实时监测](https://docs.sorsa.io/zh-Hans/real-time-monitoring) *** ## 推文与帖子分析 分析特定推文的互动：谁回复、谁引用、谁转推，以及他们说了什么。衡量传播范围、识别重要评论者，并比较内容表现。 **主要端点：** * `/tweet-info` 和 `/tweet-info-bulk`：获取一条或多条推文的完整指标 * `/comments`：推文下的所有回复 * `/quotes`：所有引用推文 * `/retweeters`：所有转推用户 * `/article`：X 文章（长文章）的完整内容 **指南：**[推文互动](https://docs.sorsa.io/zh-Hans/tweet-engagement) | [X 文章](https://docs.sorsa.io/zh-Hans/x-articles) *** ## 受众地理分布与人口特征 了解账号受众所在地。按国家绘制粉丝分布，用于广告定向、意见领袖评估或市场扩张研究。 **主要端点：** * `/followers`：提取粉丝列表 * `/about`：查询每个账号关联的国家 **指南：**[受众地理分布](https://docs.sorsa.io/zh-Hans/Audience-Geography) *** ## 加密货币与 Web3 分析 通过 Sorsa 专有评分系统评估加密货币账号的实际影响力。该系统衡量账号在有影响力的加密货币 KOL、项目和 VC 中的认可度。追踪分数趋势、发现新兴项目，并识别非自然增长。 **主要端点：** * `/score` 和 `/score-changes`：影响力分数及每周、每月变化 * `/followers-stats`：按类别划分粉丝（意见领袖、项目、VC） * `/top-followers` 和 `/top-following`：按分数排名的前 20 位 * `/new-followers-7d` 和 `/new-following-7d`：加密货币账号最近的关注活动 **指南：**[Sorsa Score 与加密货币分析](https://docs.sorsa.io/zh-Hans/sorsa-score-and-crypto-analytics) *** ## AI 与 LLM 训练数据 收集大规模推文数据集，用于语言模型微调、情感分类器训练或检索增强生成（RAG）管道。Sorsa 返回整洁的 JSON，可直接接入机器学习工作流。 **主要端点：** * `/search-tweets`：按主题、语言和日期范围大规模收集推文 * `/user-tweets`：获取完整时间线以构建语料库 * `/comments` 和 `/quotes`：收集问答对、辩论等对话数据 **指南：**[搜索推文](https://docs.sorsa.io/zh-Hans/search-tweets) | [历史数据](https://docs.sorsa.io/zh-Hans/historical-data) | [优化 API 使用](https://docs.sorsa.io/zh-Hans/optimizing-api-usage) *** ## SaaS 与分析平台开发 基于 Sorsa 的数据层构建社交分析工具、控制台或监测平台。统一价格模式（一次 API 调用计为一次请求，与返回数据量无关）和每秒 20 次的速率限制，使你可以通过一个 API 密钥服务多个最终用户。 **主要端点：** 所有套餐都可使用全部端点。完整规范请参阅 [API 参考](https://docs.sorsa.io/zh-Hans/api-reference-guide)。 **指南：**[优化 API 使用](https://docs.sorsa.io/zh-Hans/optimizing-api-usage) | [价格](https://docs.sorsa.io/zh-Hans/pricing) | [速率限制](https://docs.sorsa.io/zh-Hans/rate-limits) *** ## 快速查找端点 如果已经明确需要什么数据，可在这里找到对应端点： | 我需要… | 端点 | 指南 | | :--------------------- | :------------------------- | :------------------------------------------------------------------------------------ | | 匹配关键词的推文 | `/search-tweets` | [搜索推文](https://docs.sorsa.io/zh-Hans/search-tweets) | | 账号的提及 | `/mentions` | [追踪提及](https://docs.sorsa.io/zh-Hans/search-mentions) | | 用户资料 | `/info` 或 `/info-batch` | [API 参考](https://docs.sorsa.io/zh-Hans/api-reference-guide) | | 账号的粉丝 | `/followers` | [粉丝与关注](https://docs.sorsa.io/zh-Hans/followers-and-following) | | 账号关注了谁 | `/follows` | [粉丝与关注](https://docs.sorsa.io/zh-Hans/followers-and-following) | | 用户推文历史 | `/user-tweets` | [历史数据](https://docs.sorsa.io/zh-Hans/historical-data) | | 推文的回复 | `/comments` | [推文互动](https://docs.sorsa.io/zh-Hans/tweet-engagement) | | 推文的引用 | `/quotes` | [推文互动](https://docs.sorsa.io/zh-Hans/tweet-engagement) | | 谁转推了推文 | `/retweeters` | [推文互动](https://docs.sorsa.io/zh-Hans/tweet-engagement) | | 推文的完整指标 | `/tweet-info` | [推文互动](https://docs.sorsa.io/zh-Hans/tweet-engagement) | | 一次获取 100 条推文的指标 | `/tweet-info-bulk` | [优化 API 使用](https://docs.sorsa.io/zh-Hans/optimizing-api-usage) | | X 列表中的推文 | `/list-tweets` | [列表与社群](https://docs.sorsa.io/zh-Hans/lists-and-communities) | | X 列表的成员 | `/list-members` | [列表与社群](https://docs.sorsa.io/zh-Hans/lists-and-communities) | | 社群成员 | `/community-members` | [列表与社群](https://docs.sorsa.io/zh-Hans/lists-and-communities) | | 社群中的推文 | `/community-tweets` | [列表与社群](https://docs.sorsa.io/zh-Hans/lists-and-communities) | | 用户是否关注某个账号 | `/check-follow` | [活动验证](https://docs.sorsa.io/zh-Hans/Marketing-Campaign-Verification) | | 用户是否转推 | `/check-retweet` | [活动验证](https://docs.sorsa.io/zh-Hans/Marketing-Campaign-Verification) | | 用户是否评论 | `/check-comment` | [活动验证](https://docs.sorsa.io/zh-Hans/Marketing-Campaign-Verification) | | 用户是否引用 | `/check-quoted` | [活动验证](https://docs.sorsa.io/zh-Hans/Marketing-Campaign-Verification) | | 检查社群成员资格 | `/check-community-member` | [活动验证](https://docs.sorsa.io/zh-Hans/Marketing-Campaign-Verification) | | 账号所在国家 | `/about` | [受众地理分布](https://docs.sorsa.io/zh-Hans/Audience-Geography) | | Sorsa Score（加密货币领域影响力） | `/score` | [Sorsa Score 与加密货币分析](https://docs.sorsa.io/zh-Hans/sorsa-score-and-crypto-analytics) | | 用户名转用户 ID | `/username-to-id` | [ID 转换](https://docs.sorsa.io/zh-Hans/ID-Conversion) | | 用户 ID 转用户名 | `/id-to-username` | [ID 转换](https://docs.sorsa.io/zh-Hans/ID-Conversion) | | 个人资料 URL 转用户 ID | `/link-to-id` | [ID 转换](https://docs.sorsa.io/zh-Hans/ID-Conversion) | | API 密钥用量统计 | `/key-usage-info` | [价格](https://docs.sorsa.io/zh-Hans/pricing) | | X 文章内容 | `/article` | [X 文章](https://docs.sorsa.io/zh-Hans/x-articles) | | 简介匹配关键词的用户 | `/search-users` | [发现目标受众](https://docs.sorsa.io/zh-Hans/target-audiences-Discovery) | | 账号的认证粉丝 | `/verified-followers` | [粉丝与关注](https://docs.sorsa.io/zh-Hans/followers-and-following) | | X 列表的订阅者 | `/list-followers` | [列表与社群](https://docs.sorsa.io/zh-Hans/lists-and-communities) | | 在社群内搜索推文 | `/community-search-tweets` | [列表与社群](https://docs.sorsa.io/zh-Hans/lists-and-communities) | | 粉丝类别分布 | `/followers-stats` | [Sorsa Score 与加密货币分析](https://docs.sorsa.io/zh-Hans/sorsa-score-and-crypto-analytics) | | 分数随时间的变化 | `/score-changes` | [Sorsa Score 与加密货币分析](https://docs.sorsa.io/zh-Hans/sorsa-score-and-crypto-analytics) | | 按 Sorsa Score 排名的粉丝 | `/top-followers` | [Sorsa Score 与加密货币分析](https://docs.sorsa.io/zh-Hans/sorsa-score-and-crypto-analytics) | | 按 Sorsa Score 排名的关注对象 | `/top-following` | [Sorsa Score 与加密货币分析](https://docs.sorsa.io/zh-Hans/sorsa-score-and-crypto-analytics) | | 最近 7 天的新粉丝 | `/new-followers-7d` | [Sorsa Score 与加密货币分析](https://docs.sorsa.io/zh-Hans/sorsa-score-and-crypto-analytics) | | 最近 7 天的新关注对象 | `/new-following-7d` | [Sorsa Score 与加密货币分析](https://docs.sorsa.io/zh-Hans/sorsa-score-and-crypto-analytics) | *** ## 不确定从哪里开始？ 1. **获取 API 密钥**：按照[快速入门](https://docs.sorsa.io/zh-Hans/quickstart)操作。每个新账号包含 100 次免费请求，无需信用卡、永不过期。 2. **尝试搜索**：将以下内容粘贴到终端，10 秒内即可看到数据： ```bash theme={null} curl -X POST https://api.sorsa.io/v3/search-tweets \ -H "ApiKey: YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"query": "your topic here", "order": "popular"}' ``` 3. **无需代码即可体验**：通过 [API Playground](https://api.sorsa.io/playground) 的可视化界面测试任意端点。 4. **选择指南**：从上方列表中选择符合使用场景的指南。 5. **查看价格**：通过[价格](https://docs.sorsa.io/zh-Hans/pricing)页面估算月度成本。