开发者参考
额度和定价
通过 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
{
"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
允许的值
GETPOSTPUTPATCHDELETE
|
待预估请求的 HTTP 方法。 |
| path 必需 | string | 待预估请求的路径,例如 /v1/value/bulk。路径中的查询字符串同样会被读取。 |
| query 可选 | object | 以对象形式提供的查询参数。数组以逗号连接。 |
| body 可选 | any | 请求将发送的 JSON 请求体。 |
请求示例
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"]}}'
响应示例
{
"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,不会运行请求,也不会扣除积分。
额度计算器
估计您批量操作的额度使用量:
所需总额度
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 |