跳到主要内容

WHOIS API

了解域名。
连接更多可能。

查询域名注册状态,并获取注册局提供的注册商、到期时间与域名服务器。 支持单域名查询与异步列表处理。

域名查询1 Credits / 每个成功查询的域名
TLD 覆盖免费
注册信息示例数据 · example.com
注册状态
已注册
注册商
Example Registrar
注册日期
2020年1月1日
到期日期
2027年1月1日
域名服务器
ns1.example.test

示例值来自已发布的 Schema,并非实时查询;注册局政策可能限制可用字段。

查看完整响应

把域名数据接入工作流

让域名信息进入你的工作流。

域名注册流程

在工作流的下一步之前,确认域名已注册或明确未注册。

域名资产管理

读取权威来源提供的注册与到期字段,并通过质量提示识别缺失数据。

批量数据补全

提交域名列表,查看处理进度并按输入顺序读取结果,复用同一套集成。

理解返回结果

了解每条结果包含什么。

不同注册局返回的字段有所不同。使用注册状态推进工作流,依赖可选字段前请检查质量提示。

先检查 TLD 覆盖

不同 TLD 的支持情况与临时可用性可能不同,提交域名前请先检查覆盖范围。

TLD 覆盖指南

理解返回的数据

即使注册商、日期或联系人字段缺失,注册状态仍可能是明确的。请阅读数据质量提示。

数据质量指南
  1. 01

    提交域名

    POST /batches
  2. 02

    查询进度

    GET /batches/{job_id}
  3. 03

    读取结果

    GET /batches/{job_id}/results

处理域名列表

提交任务,按进度读取结果。

提交域名列表、查询进度,再按输入顺序读取结果。HTTP 202 表示已受理,任务终态按成功查询的域名结算。

阅读批量任务指南

端点与价格

调用前查看各操作的计费单位。下表对应当前展示的发布版本。

发布版本 1.0.0 · 6 个端点

路径说明计费
GET/domains/{domain}查询域名注册信息1 Credits / 每个成功查询的域名
GET/tlds查询顶级域名覆盖范围免费
POST/batches创建批量查询任务1 Credits / 每个成功查询的域名
GET/batches/{job_id}查询批量任务进度免费
GET/batches/{job_id}/results分页读取批量查询结果免费
POST/batches/{job_id}:cancel取消批量查询任务免费

第一次域名查询

创建项目 API key,即可在终端运行下面的请求。

  1. 创建项目密钥

    在控制台选择组织与项目。将生成的密钥保存在后端或本机环境中。

  2. 检查 Credits 余额

    执行付费查询前,确认组织有可用的 Credits,且项目预算充足。

  3. 查看请求记录

    运行下方请求,检查响应后前往控制台查看状态与最终扣费。

域名查询1 Credits / 每个成功查询的域名

请求使用 https://api.antapi.dev,只需在本机私下配置项目密钥 ANTAPI_KEY。

请求 · cURL
curl --request GET 'https://api.antapi.dev/whois/v1/domains/example.com' \
  --header "Authorization: Bearer $ANTAPI_KEY"
阅读快速开始 ↗

Skill 接入

产品 Skill 可单独安装,使用项目 Key 直接调用此 API,沿用相同的 Credits 与限制。CLI 是另一种可选方式。

查询单个域名的注册信息和 TLD 覆盖范围;此 Skill 暂不包含批量命令。

可使用

从仓库安装
npx skills add xiaopozhu/antapi-skills --skill antapi-whois

需要 Node.js 22.20 或更高版本及 npm,按提示选择要安装的 Agent。私有仓库使用本机已配置的 Git 凭据。

官方仓库 ↗

安装指南

了解可选的 CLI ↗

WHOIS API 常见问题

如何理解域名注册状态?

明确已注册或未注册的结果都属于成功查询。未知或无法确定的结果不能证明域名可注册。

阅读指南

为什么部分 WHOIS 字段缺失?

可用字段随注册局、TLD 与数据来源而变化。注册商、到期时间、域名服务器和联系信息可能缺失或被隐去,依赖可选字段前请检查质量提示。

阅读指南

可以批量查询域名列表吗?

通过异步批量任务提交域名列表、查询进度,并按输入顺序读取结果。HTTP 202 只表示已受理,终态按成功查询的域名结算,未使用的 Credits 预留会释放。

阅读指南

让域名数据发挥作用。

创建账号、生成密钥,发出第一次请求。

开始构建