WHOIS域名查询API接口文档 GET / POST 应用开发

获取域名的注册信息,包括注册商、注册人、创建/到期时间、DNS服务器、域名年龄等。支持200+域名后缀。

请求 GET / POST返回 application/json0.5 积分 / 次上线 2026-09-24 14:57:41

获取域名的注册信息,包括注册商、注册人、创建/到期时间、DNS服务器、域名年龄等。支持200+域名后缀。

0.5 积分 / 次调用次数: 3正常运行KEY 必填
接口信息
GET / POST api.souxiaocha.com/apis/gateway?api=whois
方法
GET / POST
分类
应用开发
计费
0.5 积分 / 次
KEY
KEY 必填
调用
3
QPM
不限制
鉴权
Query 参数、Header(X-API-Key)
作者

WHOIS域名查询接口信息

接口地址:
https://api.souxiaocha.com/apis/gateway?api=whois
请求方式:
GET / POST
返回格式:
application/json

调用统计

3总调用次数
请求示例 · GET
GET https://api.souxiaocha.com/apis/gateway?api=whois

apikey=你的API密钥&domain=请填写domain

GET 参数放在查询字符串中。参数值请替换为实际有效值。

WHOIS域名查询请求参数

参数名类型必填说明示例
domainstring查询域名
返回示例
{"success":true,"data":{"domain":"wengbi.com","registrar":"eName Technology Co., Ltd.","registrant":null,"registrant_email":null,"creation_date":"2012-07-05 13:37:02","expiry_date":"2027-07-05 13:37:02","updated_date":"2026-06-09 11:26:39","name_servers":["NS1.ENAME.NET","NS2.ENAME.NET"],"status":["clientDeleteProhibited https:\/\/icann.org\/epp#clientDeleteProhibited","clientTransferProhibited https:\/\/icann.org\/epp#clientTransferProhibited"],"dnssec":"unsigned","domain_age":{"years":14,"months":1,"days":20,"total_days":5150,"age_text":"14年1个月"}},"generated_at":"2026-08-11 16:24:15"}

详细文档

WHOIS域名查询 API 接口文档

接口描述

获取域名的注册信息,包括注册商、注册人、创建/到期时间、DNS服务器、域名年龄等。支持200+域名后缀。

功能特性

  • 获取域名的注册信息,包括注册商、注册人、创建/到期时间、DNS服务器、域名年龄等。支持200+域名后缀。
  • 返回 JSON 结构化数据,便于程序解析
  • 支持 GET / POST 两种调用方式
  • 平台统一密钥鉴权与调用统计,支持积分计费

接口地址

https://api.souxiaocha.com/apis/gateway?api=whois

请求方式

GET / POST(业务参数 GET 通过 URL 传递,POST 支持表单或 JSON)

鉴权方式

调用需携带平台密钥(用户中心「令牌管理」获取,SK- 开头):

  • URL 参数:key=SK-你的密钥
  • 或请求头:X-API-Key: SK-你的密钥

请求参数

参数名 类型 必填 描述
domain string 查询域名

请求参数 (JSON格式)

[
  {"name": "domain", "type": "string", "required": true, "description": "查询域名"}
]

响应格式

JSON 格式响应

成功返回示例:

{"success":true,"data":{"domain":"wengbi.com","registrar":"eName Technology Co., Ltd.","registrant":null,"registrant_email":null,"creation_date":"2012-07-05 13:37:02","expiry_date":"2027-07-05 13:37:02","updated_date":"2026-06-09 11:26:39","name_servers":["NS1.ENAME.NET","NS2.ENAME.NET"],"status":["clientDeleteProhibited https:\/\/icann.org\/epp#clientDeleteProhibited","clientTransferProhibited https:\/\/icann.org\/epp#clientTransferProhibited"],"dnssec":"unsigned","domain_age":{"years":14,"months":1,"days":20,"total_days":5150,"age_text":"14年1个月"}},"generated_at":"2026-08-11 16:24:15"}

失败返回示例:

{"success":false,"error":"missing_domain","message":"请提供域名参数(domain)"}

返回参数说明

参数名 类型 说明
data.domain string 查询域名
data.registrar string 注册商
data.registrant string 注册人/组织
data.registrant_email string 注册邮箱(可能因隐私保护为空)
data.creation_date string 创建时间
data.expiry_date string 到期时间
data.updated_date string 更新时间
data.name_servers array DNS服务器列表
data.status array 域名状态列表
data.dnssec array DNSSEC状态
data.domain_age object 域名年龄信息
data.domain_age.years integer
data.domain_age.months integer
data.domain_age.days integer
data.domain_age.total_days integer 总天数
data.domain_age.age_text string 年龄描述(如"26年10个月")

代码示例

curl "https://api.souxiaocha.com/apis/gateway?api=whois?key=SK-你的密钥&domain=douhao.com"

错误响应

上游业务级错误:

code msg 描述
400 missing_domain 缺少domain参数
400 invalid_domain 域名格式不正确
400 unsupported_tld 不支持的域名后缀
502 whois_query_failed WHOIS查询失败
502 parse_failed 数据解析失败

平台级错误(errcode):11001 缺少密钥 / 11002 密钥无效或已禁用 / 11005 接口禁用 / 11006 接口维护 / 11010 积分不足 / 11018 请求方式不允许。

失败时请以响应体中的 code / errcodemsg 判断。

注意事项

  • 本接口为平台代理的聚合数据服务,数据与稳定性以上游服务为准
  • 涉及命理、测算类内容(如有)仅供娱乐参考,不构成任何现实建议
  • 请合理控制调用频率,避免高频恶意调用触发风控
  • 密钥请妥善保管,勿在公开代码或前端页面中暴露

开发时间

2026-09-24