> ## 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

Sorsa API 通过简单的 REST 接口，让你快速、结构化地访问 X（原 Twitter）的公开数据。它涵盖用户资料、推文、搜索、关注关系图谱、列表和社群内容，以及加密货币领域的受众分析。只需一个 API 密钥，无需 OAuth、应用审核，也无需担心意外的速率限制。

你可以把它看作无需自行构建或维护的可靠 X 数据源：作为官方 Twitter API 的托管替代方案，它面向希望大规模提取、监测和分析 X 公开内容的开发者、数据工程师、分析师、研究人员、增长团队和 AI 产品开发者。

> **AI 文档 / 适合 LLM 的文档。** 正在使用 LLM、AI 智能体或编程助手开发？请先让它读取机器可读文档，在生成请求之前了解完整上下文：[完整纯文本 API 文档](https://api.sorsa.io/v3/static/sorsa_api_v3_documentation_en.txt)。

***

## 谁适合使用 Sorsa API？

Sorsa 适合任何需要以编程方式访问 X 平台数据的人。开始使用时，无需官方 X 开发者账号、Twitter API 审核或复杂的 OAuth 配置。

常见用户包括构建社交数据管道的后端开发者、开展情感分析的数据科学家、追踪品牌提及的增长营销人员、验证社群互动的 Web3 团队、通过 Make 或 Zapier 等自动化工具连接 X 数据的无代码开发者，以及从公开对话中收集训练数据集的 AI 工程师。

***

## 快速开始

**基础 URL**

```text theme={null}
https://api.sorsa.io/v3
```

**身份验证**

每个请求都需要在 `ApiKey` 请求头中包含 API 密钥。无需 OAuth 流程、Bearer 令牌或回调 URL。

**响应格式**

所有端点均返回 JSON。

**请求示例**

```bash theme={null}
curl --request GET \
  --url "https://api.sorsa.io/v3/info?username=elonmusk" \
  --header "ApiKey: YOUR_API_KEY"
```

第一次使用？按照[快速入门指南](https://docs.sorsa.io/zh-Hans/quickstart)，三分钟内即可获取 API 密钥并发送第一个请求。

**免费开始。** 每个新账号均获得 100 次免费请求：无需信用卡、永不过期，并且可访问所有可用端点。选择套餐之前，可以用它们体验任意端点。

***

## 正在使用 AI 开发？

Sorsa 可以轻松接入 LLM 智能体、AI 编程助手和自动化工作流。无需手动粘贴各个端点，直接为模型提供完整文档上下文：

* [AI 文档](https://docs.sorsa.io/zh-Hans/ai-docs)：了解如何以编程方式使用 Sorsa 文档。
* [文档索引（llms.txt）](https://docs.sorsa.io/llms.txt)：所有可用页面的精简目录，帮助智能体先了解文档结构，再深入阅读。
* [完整纯文本 API 参考](https://api.sorsa.io/v3/static/sorsa_api_v3_documentation_en.txt)：一个文件中的完整 LLM 可读规范，可加入提示词、IDE 或检索索引。

***

## API 功能

以下概述可以获取的数据。完整的数据结构、参数和响应示例请参阅 [API 参考](https://docs.sorsa.io/zh-Hans/api-reference-guide)。

### 用户

获取用户资料、受众指标、账号历史和关系图谱，包括粉丝、关注对象及认证粉丝。可逐个获取资料，也可一次批量获取最多 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 查询功能。可使用免费的[搜索构建器](https://api.sorsa.io/playground/search-builder)可视化构建查询，并参阅完整的[搜索运算符](https://docs.sorsa.io/zh-Hans/search-operators)参考。

主要端点：`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 转换器](https://api.sorsa.io/playground/id-converter)在浏览器中转换。

主要端点：`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。

详细实现方式和工作流示例请参阅[使用场景指南](https://docs.sorsa.io/zh-Hans/use-cases-overview)。

***

## 无需代码即可体验

探索 Sorsa 无需编写任何代码。[API Playground](https://api.sorsa.io/playground) 让你在浏览器中调用任意端点、查看实时响应，并在集成之前试验参数。

我们还提供一系列基于 API 的免费即用工具：

* [搜索构建器](https://api.sorsa.io/playground/search-builder)：可视化构建高级推文搜索查询。
* [ID 转换器](https://api.sorsa.io/playground/id-converter)：在用户名、用户 ID 和个人资料链接之间转换。
* [Shadowban 检测](https://api.sorsa.io/playground/shadowban-check)：检查账号是否受到隐性可见性限制。
* [媒体下载器](https://api.sorsa.io/playground/media-downloader)：下载推文中的图片和视频。
* [用户比较](https://api.sorsa.io/playground/compare-users)：并排比较两个账号的主要指标。
* [最新粉丝](https://api.sorsa.io/playground/recent-followers)：查看账号最近的粉丝。
* [互动率计算器](https://api.sorsa.io/playground/engagement-calculator)：根据最近推文估算互动率。
* [关注检查](https://api.sorsa.io/playground/follow-check)：检查两个账号是否相互关注。
* [所在地检查](https://api.sorsa.io/playground/location-check)：了解 X 账号所在国家。
* [账号年龄检查](https://api.sorsa.io/playground/account-age-check)：查看账号创建时间。

更多深入指南、教程和迁移步骤请浏览 [Sorsa 博客](https://api.sorsa.io/blog)。

***

## Sorsa API 不支持哪些功能？

Sorsa 是专注于数据提取和分析的只读 API，不会在 X 平台执行写入操作：

* 发布推文、回复或私信
* 点赞、收藏或转推
* 关注或取消关注账号
* 代表用户账号执行任何操作

如果你的场景需要写入权限，可以使用官方 X API 执行这些操作，同时使用 Sorsa 获得可靠的大规模读取能力。

***

## 后续步骤

* [快速入门](https://docs.sorsa.io/zh-Hans/quickstart)：获取 API 密钥并发送第一个请求
* [身份验证](https://docs.sorsa.io/zh-Hans/authentication)：了解如何授权 v3 API 请求
* [API 参考](https://docs.sorsa.io/zh-Hans/api-reference-guide)：浏览所有端点、参数和响应结构
* [价格](https://docs.sorsa.io/zh-Hans/pricing)：套餐和请求包（每个账号均有 100 次免费请求）
* [速率限制](https://docs.sorsa.io/zh-Hans/rate-limits)：了解用量配额和限流
* [使用场景指南](https://docs.sorsa.io/zh-Hans/use-cases-overview)：实际实现方式与工作流