> For the complete documentation index see https://domscan.net/llms.txt. Markdown versions of every docs page are available by appending .md to the page URL.

Source: https://domscan.net/zh/docs/credits-pricing

# 额度和定价

通过 DomScan API，DomScan 每月包含 10,000 个免费额度。无需信用卡。立即开始使用。

DomScan 每月包含 10,000 个免费额度。无需信用卡。立即开始使用。

额度每月在注册周年日刷新. 需要更多额度？购买永不过期的包:

### 每个端点的额度

常用端点的费用如下。部分参考端点免费。完整的机器可读费率表请使用 /v1/pricing。

| 端点 | 额度 | 描述 |
| --- | --- | --- |
| `/v1/coverage` | 0 | 列出具有 RDAP 映射的 TLD |
| `/v1/tlds` | 0 | TLD 元数据列表 |
| `/v1/watchlist` | 1 | 查看您的监视列表 |
| `/v1/webhooks` | 2 | 按成功投递到您 Webhook 端点的每条提醒计费。投递失败的部分会退还，测试事件免费。 |
| `/v1/status` | 1 | 检查域名可用性 |
| `/v1/health/quick` | 1 | 快速健康检查 |
| `/v1/dns` | 1 | DNS 查询 |
| `/v1/dns/bulk` | 1/domain | 批量 DNS 查询（最多 25 个域名） |
| `/v1/ip` | 1 | IP 地理位置 |
| `/v1/value` | 2 | 域名评估 |
| `/v1/prices` | 0-1/pair | 注册价格 |
| `/v1/tlds/:tld` | 1 | TLD 详情 |
| `/v1/watchlist/check` | 1 | 检查监视列表项目 |
| `/v1/typos/permutations` | 1 | 域名仿冒排列组合 |
| `/v1/typos/score` | 1 | 域名仿冒风险分数 |
| `/v1/email/check` | 1 | 电子邮件黑名单检查 |
| `/v1/status/bulk` | 1/domain | 一次检查多个域名的可用性。每个请求最多支持 50 个域名。 |
| `/v1/health` | 3 | 完整健康检查 |
| `/v1/dns/all` | 2 | 所有 DNS 记录 |
| `/v1/profile` | 3 | 域名配置文件 |
| `/v1/redirects` | 2 | 重定向链 |
| `/v1/tech` | 3-9 | 技术栈检测 |
| `/v1/categorize` | 3 | 网站分类 |
| `/v1/similarity` | 2 | 域名相似度 |
| `/v1/typos` | 2-3 | 域名仿冒检测 |
| `/v1/reputation` | 3 | 域名信誉度 |
| `/v1/reputation/bulk` | 3/domain | 批量域名声誉评分（最多 3 个域名） |
| `/v1/certificates` | 2 | SSL 证书 |
| `/v1/certificates/bulk` | 2/domain | SSL 证书 |
| `/v1/social` | 2 | 社交账号检查 |
| `/v1/social/bulk` | 2/handle | 批量检查社交媒体用户名 |
| `/v1/company` | 3 | 公司查询 |
| `/v1/suggest` | 2-5 | 域名建议 |
| `/v1/whois` | 3 | WHOIS 查询 |
| `/v1/whois/history` | 3 | WHOIS变更历史 |
| `/v1/whois/bulk` | 3/domain | 批量WHOIS查询（最多20个域名） |
| `/v1/rdap/bulk` | 2/query | WHOIS 查询 |
| `/v1/prices/bulk` | 1/pair | 批量定价 |
| `/v1/dns/security` | 3 | DNS 安全分析 |
| `/v1/dns/propagation` | 2 | DNS 递归解析器对比 |
| `/v1/dns/propagation/bulk` | 2/domain | DNS 递归解析器对比 |
| `/v1/email-auth/bulk` | 3/domain | 电子邮件身份验证 |
| `/v1/hosting/bulk` | 3/domain | 托管检测 |
| `/v1/value/bulk` | 2/domain | 批量评估 |
| `/v1/health/bulk` | 3/domain | 批量健康检查 |
| `/v1/subdomains` | 4-5 | 子域名查找器 |
| `/v1/subdomains/bulk` | 4-5/domain | 子域名查找器 |
| `/v1/report` | 5 | 综合报告（相比单个调用节省约 10 个额度） |

### 信用执法

当您的积分达到零时，消耗积分的 API 请求将返回 HTTP 402（需要付款）。基于浏览器的免费工具不受影响。

`HTTP 402 Payment Required`

```json
{
  "error": {
    "code": "INSUFFICIENT_CREDITS",
    "message": "Insufficient credits. This endpoint costs 2 credits but you have 0.",
    "credits_remaining": 0,
    "credits_required": 2,
    "purchase_url": "https://domscan.net/billing"
  }
}
```

需要更多额度？购买永不过期的包:

额度每月在注册周年日刷新.

### 信用响应标头

所有经过身份验证的 API 响应都包含一个 X-Credits-Remaining 标头，显示请求后您当前的信用余额。

`X-Credits-Remaining: 9500`

每个已认证的 /v1 响应（包括错误响应）都带有以下响应头：

- `X-Credits-Charged`：此请求扣除的积分，已减去同一请求中退还的部分（未扣费时为 0）。

- `X-Credits-Remaining`：请求之后的余额。在余额尚未确定的少数情况下会省略。

- `X-RateLimit-Limit`、`X-RateLimit-Remaining` 和 `X-RateLimit-Reset`：您的突发容量、仍可立即发送的请求数，以及容量完全恢复时的 Unix 时间（秒）。

- 基于 HTTP 的 MCP 会针对每个请求中的工具调用返回 `X-Credits-Charged` 和 `X-Credits-Remaining`。

### 运行前预估费用

将请求的方法、路径、查询参数和请求体发送到 `POST /v1/estimate`，即可获得该请求将扣除的积分，并附带明细和说明。不会执行任何操作，预估本身消耗 0 积分。当最终费用取决于执行结果时，预估值为上限，并会在说明中解释原因。

POST /v1/estimate

#### 请求体

| 参数 | 类型 | 描述 |
| --- | --- | --- |
| method 必需 | string 允许的值 `GET`, `POST`, `PUT`, `PATCH`, `DELETE` | 待预估请求的 HTTP 方法。 |
| path 必需 | string | 待预估请求的路径，例如 `/v1/value/bulk`。路径中的查询字符串同样会被读取。 |
| query 可选 | object | 以对象形式提供的查询参数。数组以逗号连接。 |
| body 可选 | any | 请求将发送的 JSON 请求体。 |

#### 请求示例

```bash
curl -X POST "https://domscan.net/v1/estimate" \
  -H "X-API-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{"method":"POST","path":"/v1/value/bulk","body":{"domains":["example.com","example.org"]}}'
```

#### 响应示例

```json
{
  "credits": 2,
  "breakdown": [
    { "component": "domains", "quantity": 2, "unit_credits": 1, "credits": 2 }
  ],
  "notes": ["被拒绝并返回 4xx 状态码或失败并返回 5xx 状态码的请求将自动退款。"],
  "maximum": false,
  "rejected": false
}
```

#### 响应字段

| 字段 | 类型 |
| --- | --- |
| `credits` | integer |
| `breakdown[]` | object[] |
| `breakdown[]` | object |
| `breakdown[].component` | string |
| `breakdown[].quantity` | integer |
| `breakdown[].unit_credits` | number |
| `breakdown[].credits` | integer |
| `notes[]` | string[] |
| `maximum` | boolean |
| `rejected` | boolean |
| `billing_model` | string |
| `endpoint` | object |
| `endpoint.method` | string |
| `endpoint.path` | string |
| `dry_run` | boolean |

批量、比较、配方和定价端点也支持 `dry_run=true`。请求将以 HTTP 200 响应，返回相同的预估以及 `"dry_run": true`，不会运行请求，也不会扣除积分。

### 额度计算器

估计您批量操作的额度使用量:

端点

API 调用次数

所需总额度

100

这相当于您每月免费积分的 1.0 %
超出免费层 0 个额度

### 额度包

需要更多额度？购买永不过期的包:

| 包 | 价格 | 每个额度 |
| --- | --- | --- |
| 50,000 额度 | €9 / £7.50 / ¥1,500 | €0.00018 |
| 250,000 额度 | €29 / £24 / ¥4,800 | €0.000116 |
| 1,000,000 额度 | €79 / £66 / ¥13,000 | €0.000079 |