域名Whois信息查询V2版API接入指南
引言
域名Whois信息查询V2是增强版域名注册信息查询接口。相较于V1版本，它在数据字段完整性和查询稳定性上进行了优化，支持通过标准HTTP Header进行鉴权，旨在为开发者提供结构化的域名生命周期管理数据，适用于批量监控与资产盘点场景
快速开始
注册与认证
1.注册起零数据平台
2.登录控制台，右上角--获取API的TOKEN密钥即可
接口地址
请求参数
固定请求参数 【任选其一即可】
动态签名算法开通方式情参考《开发文档》
Header封装【推荐】
| 请求头部 | 必填 | 说明 | 示例 |
|---|---|---|---|
| Authorization | 是 | 用户中心获取到的应用TOKEN，格式：Bearer <token> | Bearer kHDWCttQBVRo**** |
| X-Signature | 可选 | 指定算法生成的Sign签名值《开发文档》 | a5c573b59ee353d*** |
| X-Timestamp | 可选 | 当前毫秒级时间戳（需开发者获取传入，有效期五分钟） | 1751810929 |
参数拼接【安全性低】
| 参数 | 类型 | 必填 | 默认 | 描述 | 示例 |
|---|---|---|---|---|---|
| token | string | 是 | 无 | 用户中心获取到的应用TOKEN | kHDWCttQBVRo**** |
| sign | string | 可选 | 无 | 指定算法生成的Sign签名值《开发文档》 | a5c573b59ee353d*** |
| timestamp | string | 可选 | 无 | 当前毫秒级时间戳（需开发者获取传入，有效期五分钟） | 175181092 |
接口业务参数
| 参数 | 说明 | 类型 | 必填 | 默认 | 示例 |
|---|---|---|---|---|---|
| url | 需要检测的网址 | string | 是 | 无 | https://www.baidu.com |
GET请求实例
响应数据
{
"code": 200,
"data": {
"parserType": "common",
"domainName": "baidu.com",
"whoisServer": "whois.markmonitor.com",
"nameServers": [
"ns3.baidu.com",
"ns7.baidu.com",
"ns4.baidu.com",
"ns2.baidu.com",
"ns1.baidu.com"
],
"creationDate": "1999-10-11 19:05:17",
"expirationDate": "2028-10-11 19:05:17",
"updatedDate": "2025-04-08 09:08:58",
"states": [
"clientupdateprohibited",
"clienttransferprohibited",
"clientdeleteprohibited",
"serverupdateprohibited",
"servertransferprohibited",
"serverdeleteprohibited"
],
"owner": "北京百度网讯科技有限公司",
"registrar": "MarkMonitor Information Technology (Shanghai) Co., Ltd.",
"dnssec": "unsigned",
"info": [
"Domain Name: baidu.com",
"Registry Domain ID: 11181110_DOMAIN_COM-VRSN",
"Registrar WHOIS Server: whois.markmonitor.com",
"Registrar URL: http://www.markmonitor.com",
"Updated Date: 2025-04-08T01:08:58+0000",
"Creation Date: 1999-10-11T11:05:17+0000",
"Registrar Registration Expiration Date: 2028-10-11T11:05:17+0000",
"Registrar: MarkMonitor Information Technology (Shanghai) Co., Ltd.",
"Registrar IANA ID: 3838",
"Registrar Abuse Contact Email: abusecomplaints@markmonitor.com",
"Registrar Abuse Contact Phone: +1.2086851750",
"Domain Status: clientUpdateProhibited (https://www.icann.org/epp#clientUpdateProhibited)",
"Domain Status: clientTransferProhibited (https://www.icann.org/epp#clientTransferProhibited)",
"Domain Status: clientDeleteProhibited (https://www.icann.org/epp#clientDeleteProhibited)",
"Domain Status: serverUpdateProhibited (https://www.icann.org/epp#serverUpdateProhibited)",
"Domain Status: serverTransferProhibited (https://www.icann.org/epp#serverTransferProhibited)",
"Domain Status: serverDeleteProhibited (https://www.icann.org/epp#serverDeleteProhibited)",
"Registrant Organization: 北京百度网讯科技有限公司",
"Registrant State/Province: Beijing",
"Registrant Country: CN",
"Registrant Email: Select Request Email Form at https://domains.markmonitor.com/whois/baidu.com",
"Admin Organization: 北京百度网讯科技有限公司",
"Admin State/Province: Beijing",
"Admin Country: CN",
"Admin Email: Select Request Email Form at https://domains.markmonitor.com/whois/baidu.com",
"Tech Organization: 北京百度网讯科技有限公司",
"Tech State/Province: Beijing",
"Tech Country: CN",
"Tech Email: Select Request Email Form at https://domains.markmonitor.com/whois/baidu.com",
"Name Server: ns3.baidu.com",
"Name Server: ns7.baidu.com",
"Name Server: ns4.baidu.com",
"Name Server: ns2.baidu.com",
"Name Server: ns1.baidu.com",
"DNSSEC: unsigned",
"URL of the ICANN WHOIS Data Problem Reporting System: http://wdprs.internic.net/",
">>> Last update of WHOIS database: 2025-05-24T13:33:06+0000 <<<",
"For more information on WHOIS status codes, please visit:",
" https://www.icann.org/resources/pages/epp-status-codes",
"If you wish to contact this domain's Registrant, Administrative, or Technical",
"contact, and such email address is not visible above, you may do so via our web",
"form, pursuant to ICANN's Temporary Specification. To verify that you are not a",
"robot, please enter your email address to receive a link to a page that",
"facilitates email communication with the relevant contact(s).",
"Web-based WHOIS:",
" https://domains.markmonitor.com/whois",
"If you have a legitimate interest in viewing the non-public WHOIS details, send",
"your request and the reasons for your request to whoisrequest@markmonitor.com",
"and specify the domain name in the subject line. We will review that request and",
"may ask for supporting documentation and explanation.",
"The data in MarkMonitor's WHOIS database is provided for information purposes,",
"and to assist persons in obtaining information about or related to a domain",
"name's registration record. While MarkMonitor believes the data to be accurate,",
"the data is provided \"as is\" with no guarantee or warranties regarding its",
"accuracy.",
"By submitting a WHOIS query, you agree that you will use this data only for",
"lawful purposes and that, under no circumstances will you use this data to:",
" (1) allow, enable, or otherwise support the transmission by email, telephone,",
"or facsimile of mass, unsolicited, commercial advertising, or spam; or",
" (2) enable high volume, automated, or electronic processes that send queries,",
"data, or email to MarkMonitor (or its systems) or the domain name contacts (or",
"its systems).",
"MarkMonitor reserves the right to modify these terms at any time.",
"By submitting this query, you agree to abide by this policy.",
"MarkMonitor Domain Management(TM)",
"Protecting companies and consumers in a digital world.",
"Visit MarkMonitor at https://www.markmonitor.com",
"Contact us at +1.8007459229",
"In Europe, at +44.02032062220",
"--"
]
},
"message": "",
"elapsedTime": "2787.2ms",
"providerName": "ISAS起零数据：https://api.istero.com"
}响应数据说明
| 参数 | 描述 |
|---|---|
| code | 响应码 |
| data | 响应数据 |
| domainName | 域名 |
| whoisServer | 注册商的 WHOIS 服务器地址 |
| nameServers | 域名的权威DNS服务器 |
| creationDate | 域名首次注册时间 |
| expirationDate | 域名过期时间 |
| updatedDate | 最后更新时间（如DNS或联系人信息修改） |
| states | 域名状态 |
| owner | 注册人姓名 |
| registrar | 注册商名称 |
| dnssec | unsigned：未启用DNSSEC signed：已启用DNSSEC unsupported：注册商/注册局不支持DNSSEC |
| info | 详细信息 |
| message | 返回信息 |
| elapsedTime | 响应耗时(ms) |
响应码参照
| 代码 | 描述 |
|---|---|
| 200 | 数据返回成功 |
| 202 | 余额不足，仅付费接口会出现此状态码 |
| 302 | 接口维护/停止服务 |
| 400 | 请求失败，"message"显示错误信息 |
| 403 | TOKEN鉴权失败 |
| 404 | 接口不存在 |
| 429 | 超出会籍QPS限制 |
| 500 | 接口服务器错误 |
| 502 | 账号被封锁/冻结 |
应用案例与使用场景
1. 域名资产管理与监控平台
企业IT或域名投资机构可利用此API构建自动化监控系统。通过定时轮询（Cron Job）调用接口，批量检查名下域名的expirationDate（过期时间）和states（状态），一旦发现临近过期（如30天内）或状态异常（如clientHold），立即通过邮件或钉钉机器人触发告警，避免因域名过期导致的业务停摆。
2. 网络安全与威胁情报分析
在SOC（安全运营中心）或欺诈检测系统中，集成该接口用于快速甄别恶意域名。通过查询陌生域名的creationDate（创建时间）和registrar（注册商），结合"新注册域名"与"短生命周期"等特征，辅助判断钓鱼网站或僵尸网络域名的风险等级，为黑名单库提供数据支撑。
3. 建站与商标保护SaaS工具
建站平台或商标监测服务可在用户注册环节调用此API。例如，用户输入心仪域名后，前端实时展示该域名的注册状态（是否可注册）及历史信息；或在商标保护场景中，通过owner字段模糊匹配，监测是否存在与客户品牌相似的侵权域名。
结论
域名Whois信息查询V2 API将分散在各注册商的非结构化Whois文本转化为标准JSON，极大降低了数据处理成本。对于需要高频、批量获取域名"身份信息"的业务，它是构建自动化运维与安全风控体系的底层数据引擎。特别提示：尽管接口支持URL参数拼接，但文档明确建议使用Header传参（Authorization: Bearer <token>）以保障密钥安全。