> ## 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 采用统一计价模式：**1 次 API 调用 = 扣除 1 次请求配额**，与调用哪个端点无关。复杂推文搜索和简单 ID 转换的成本相同。没有积分倍数、按端点划分的价格等级，也不会为推文响应中嵌入的用户数据收取隐藏费用。本页介绍可用套餐、各端点每单位数据的实际成本，以及常见工作流的月度费用估算方法。

***

## 套餐

|        | Starter  | Pro       | Enterprise |
| :----- | :------- | :-------- | :--------- |
| 每月请求数  | 10,000   | 100,000   | 500,000    |
| 价格     | \$49/月   | \$199/月   | \$899/月    |
| 每次请求成本 | \$0.0049 | \$0.00199 | \$0.0018   |
| 速率限制   | 20 次/秒   | 20 次/秒    | 20 次/秒     |
| 包含所有端点 | 是        | 是         | 是          |

**从 100 次免费请求开始。** 每个新账号均免费获得 100 次请求，无需信用卡、永不过期，且适用于所有可用端点。选择套餐前可测试 API 的任意部分。

**定制套餐。** 如果每月需要超过 500,000 次请求（例如 AI 训练、大规模数据获取或持续监测数千个账号），我们可提供定制用量和专属速率限制。请通过[联系销售](https://api.sorsa.io/talk-to-sales)或 [Discord](https://discord.com/invite/uwAefKCj7X) 联系我们。

**所有标准套餐的速率限制相同。** 均为每秒 20 次请求。从 Starter 升级为 Pro 只会增加月度配额，不会提升速度。定制套餐可包含更高的专属速率限制。

***

## 统一计价原则

许多 X 数据提供商采用积分计价，不同端点每次调用消耗不同积分。例如搜索消耗 25 积分、资料查询 5 积分、粉丝提取 50 积分。这使预算难以预测，同样的数据也可能因获取方式不同而产生悬殊成本。

Sorsa 的每个端点每次调用都只扣除 1 次请求配额。此外：

* **推文响应免费包含用户数据。** `/search-tweets`、`/user-tweets`、`/comments`、`/mentions` 等推文端点返回的每条推文均包含完整作者资料（ID、用户名、简介、粉丝数、认证状态等），无需额外付费。
* **批量端点适合大规模查询。** `/info-batch` 和 `/tweet-info-bulk` 一次最多获取 100 条数据，可显著降低单条成本。
* **粉丝和关注端点每次最多返回 200 份资料。** 这是单次请求产出较高的方式之一。

***

## 每单位数据成本

真正需要估算的是获取所需数据的成本，而不仅是单次请求价格。结果取决于各端点每次返回多少条数据。

### 推文数据

| 端点                 | 每次请求返回数量   | Starter   | Pro       | Enterprise |
| :----------------- | :--------- | :-------- | :-------- | :--------- |
| `/search-tweets`   | 约 20 条推文   | \$0.00025 | \$0.0001  | \$0.00009  |
| `/user-tweets`     | 约 20 条推文   | \$0.00025 | \$0.0001  | \$0.00009  |
| `/mentions`        | 约 20 条推文   | \$0.00025 | \$0.0001  | \$0.00009  |
| `/comments`        | 约 20 条推文   | \$0.00025 | \$0.0001  | \$0.00009  |
| `/quotes`          | 约 20 条推文   | \$0.00025 | \$0.0001  | \$0.00009  |
| `/list-tweets`     | 约 20 条推文   | \$0.00025 | \$0.0001  | \$0.00009  |
| `/tweet-info-bulk` | 最多 100 条推文 | \$0.00005 | \$0.00002 | \$0.000018 |
| `/tweet-info`      | 1 条推文      | \$0.0049  | \$0.00199 | \$0.0018   |

**建议：** 使用 `/tweet-info-bulk`，避免循环调用 `/tweet-info`。单条推文成本大约相差 100 倍。按关键词、话题或用户收集推文时，搜索和时间线端点效率最高，Pro 套餐约为每条 \$0.0001。

### 用户资料数据

| 端点                    | 每次请求返回数量   | Starter    | Pro       | Enterprise |
| :-------------------- | :--------- | :--------- | :-------- | :--------- |
| `/followers`          | 最多 200 位用户 | \$0.000025 | \$0.00001 | \$0.000009 |
| `/follows`            | 最多 200 位用户 | \$0.000025 | \$0.00001 | \$0.000009 |
| `/verified-followers` | 最多 200 位用户 | \$0.000025 | \$0.00001 | \$0.000009 |
| `/community-members`  | 约 20 位用户   | \$0.00025  | \$0.0001  | \$0.00009  |
| `/list-members`       | 约 20 位用户   | \$0.00025  | \$0.0001  | \$0.00009  |
| `/retweeters`         | 约 20 位用户   | \$0.00025  | \$0.0001  | \$0.00009  |
| `/search-users`       | 约 20 位用户   | \$0.00025  | \$0.0001  | \$0.00009  |
| `/info-batch`         | 最多 100 份资料 | \$0.00005  | \$0.00002 | \$0.000018 |
| `/info`               | 1 份资料      | \$0.0049   | \$0.00199 | \$0.0018   |

**建议：** 获取粉丝和关注对象的成本很低，Pro 套餐每份资料约 \$0.00001。批量查询资料时，始终使用 `/info-batch`，避免循环调用 `/info`。

### 行为验证

| 端点                        | 每次请求返回数量 | Starter  | Pro       | Enterprise |
| :------------------------ | :------- | :------- | :-------- | :--------- |
| `/check-follow`           | 1 次检查    | \$0.0049 | \$0.00199 | \$0.0018   |
| `/check-retweet`          | 1 次检查    | \$0.0049 | \$0.00199 | \$0.0018   |
| `/check-quoted`           | 1 次检查    | \$0.0049 | \$0.00199 | \$0.0018   |
| `/check-comment`          | 1 次检查    | \$0.0049 | \$0.00199 | \$0.0018   |
| `/check-community-member` | 1 次检查    | \$0.0049 | \$0.00199 | \$0.0018   |

验证端点每次请求执行一次检查（检查特定用户是否完成特定行为）。如果活动有 1,000 名参与者，每人 5 项任务，应预留 5,000 次请求。

### 工具端点

| 端点                | 每次请求返回数量 | Starter  | Pro       | Enterprise |
| :---------------- | :------- | :------- | :-------- | :--------- |
| `/about` (国家数据)   | 1 个结果    | \$0.0049 | \$0.00199 | \$0.0018   |
| `/username-to-id` | 1 次转换    | \$0.0049 | \$0.00199 | \$0.0018   |
| `/id-to-username` | 1 次转换    | \$0.0049 | \$0.00199 | \$0.0018   |
| `/link-to-id`     | 1 次转换    | \$0.0049 | \$0.00199 | \$0.0018   |
| `/score`          | 1 个结果    | \$0.0049 | \$0.00199 | \$0.0018   |

***

## 无需额外请求即可获取的数据

部分数据已包含在原有响应中，无需增加成本：

**推文响应中的用户资料。** `/search-tweets`、`/user-tweets`、`/mentions`、`/comments`、`/quotes` 和 `/list-tweets` 的每条推文都包含完整作者资料。如果搜索得到的 1,000 条推文来自 400 位不同用户，你就已获得 400 份完整资料，无需调用 `/info`。

**验证响应中的评论正文。** `/check-comment` 返回 `commented: true` 时，会包含评论的完整推文对象，无需另外调用 `/comments` 来读取内容。

**引用验证中的引用正文。** `/check-quoted` 返回 `status: "quoted"` 时，会包含引用正文和时间戳。

**`/article` 中的文章数据。** 一次调用即可返回文章全文、互动指标和作者资料。

***

## 常见工作流预算估算

### 社交聆听：监测关键词并收集推文

全天候每 30 秒轮询一次 `/search-tweets`，收集关于品牌的推文。

* 每 30 秒 1 次 = 每分钟 2 次 = 每天 2,880 次 = **每月 86,400 次**
* 适用 **Pro 套餐**（\$199/月）
* 每次约 20 条推文，因此每月最多约 170 万条

### 竞品分析：5 个竞争对手的资料、内容和提及

* 通过 `/info` 查询 5 份资料：5 次请求
* 通过 `/user-tweets` 获取每个竞争对手 50 页推文：250 次请求
* 通过 `/mentions` 获取每个竞争对手 10 页提及：50 次请求
* 每次运行合计：**305 次请求**
* 每周运行一次：每月约 1,220 次，**Starter 套餐**足够使用

### 受众研究：提取并分析 50,000 位粉丝的地理分布

* 通过 `/followers` 获取 50,000 位粉丝（每页 200 位）：250 次请求
* 通过 `/about` 查询 50,000 次国家信息：50,000 次请求
* 合计：**50,250 次请求**
* 适用 **Pro 套餐**（\$199/月）
* 成本：约 $100（50,250 × $0.00199）

### 活动验证：2,000 名参与者，每人 5 项任务

* 2,000 × 5 次验证：10,000 次请求
* 适用 **Starter 套餐**（\$49/月）

<a id="large-scale-data-collection-full-timeline-scrape-of-100-accounts" />

### 大规模数据收集：获取 100 个账号的完整时间线

* 每个账号平均 500 条推文，每页约 20 条 = 每个账号 25 页
* 100 个账号 × 25 页 = 2,500 次请求
* 同时获得约 50,000 条包含用户资料的推文
* 适用 **Starter 套餐**（\$49/月）

### 实时监测：通过 X 列表以 5 秒间隔追踪 200 个账号

* 每 5 秒 1 次 = 每天 17,280 次 = **每月 518,400 次**
* 略超 Enterprise 的 500,000 次配额，因此需要**定制套餐**，或稍微延长轮询间隔以适配 \$899/月的 Enterprise
* 每轮只需一次 `/list-tweets` 请求即可覆盖全部 200 个账号

***

## 成本优化策略

[优化 API 使用](https://docs.sorsa.io/zh-Hans/optimizing-api-usage)指南提供详细说明，以下为主要策略：

**使用批量端点。** `/tweet-info-bulk`（每次最多 100 条推文）和 `/info-batch`（每次最多 100 份资料）专门用于减少批量查询的请求次数。

**多账号监测使用 `/list-tweets`。** 单独监测 50 个账号，消耗的请求数是将它们放入 X 列表后统一轮询的 50 倍。

**从推文响应提取用户数据。** 每个推文端点都包含作者资料。利用搜索和时间线结果构建用户数据库，避免单独调用 `/info`。

**用 `/info` 代替先转换再查询。** 同时需要用户 ID 和完整资料时，只需调用一次 `/info`（支持用户名、ID 和链接），无需先调用 `/username-to-id` 再调用 `/info`。

**根据用量选择套餐。** 从 Starter 升级到 Pro，每次请求成本降低 59%（从 $0.0049 降至 $0.00199）；从 Pro 升级到 Enterprise 再降低 10%。如果持续使用超过套餐配额的 80%，升级可以节省费用。

> **与官方 X API 相比如何？** 官方 X API 按用量计费，每读取一条帖子 $0.005，作者资料每份另收 $0.010，按用量付费账号每月最多读取 200 万条帖子。读取约 100 万条帖子每月约需 $5,000。Sorsa Pro 每月 $199，100,000 次请求可获取约 200 万条含作者资料的推文，每条约 $0.0001，而官方 API 为 $0.005。身份验证也更简单：一个 API 密钥请求头即可，无需 OAuth 2.0。完整说明请参阅[从官方 X API 迁移](https://docs.sorsa.io/zh-Hans/migration-from-official-x-api)。

***

## 检查当前用量

使用 `GET /key-usage-info` 查看当前消耗和剩余配额：

```text theme={null}
curl "https://api.sorsa.io/v3/key-usage-info" \
  -H "ApiKey: YOUR_API_KEY"
```

```json theme={null}
{
  "key_requests": 100000,
  "remaining_requests": 87340,
  "total_requests": 512680,
  "valid_until": "2026-08-01T00:00:00Z"
}
```

* `key_requests`：当前计费周期分配的请求总数（套餐配额）
* `remaining_requests`：当前周期剩余可用请求数
* `total_requests`：所有计费周期累计使用的请求数
* `valid_until`：当前请求余额的到期时间

将此检查加入监测脚本，在接近配额上限时发出提醒。也可在[用量统计](https://api.sorsa.io/overview/usage)控制台页面查看历史记录。

***

## 后续步骤

* [优化 API 使用](https://docs.sorsa.io/zh-Hans/optimizing-api-usage)：去重、批量端点和避免重复调用的详细方式
* [速率限制](https://docs.sorsa.io/zh-Hans/rate-limits)：处理每秒 20 次上限、429 错误和退避策略
* [API 参考](https://docs.sorsa.io/zh-Hans/api-reference-guide)：所有端点的完整规范