# 域名 Whois 查询 API 数据接口


域名 Whois 查询 API 数据接口

多类型域名支持，精准 Whois 数据，实时数据。

![gugudata_api_cover](https://static.gugudata.com/api_cover_websitetools_whois.png)

# 1. 产品功能

- 支持国际、国内域名 Whois 查询；
- 每小时定时更新基础数据库；
- 提供精准、高效的 Whois 查询；
- 返回可查询最详细的域名相关信息；
- 秒级查询性能，支持高并发；
- 数据持续更新与维护；
- 全接口支持 HTTPS（TLS v1.0 / v1.1 / v1.2 / v1.3）；
- 全面兼容 Apple ATS；
- 全国多节点 CDN 部署；
- 接口极速响应，多台服务器构建 API 接口负载均衡；
- [接口调用状态与状态监控](https://www.gugudata.com/status)

# 2. API 文档

**接口详情:** [https://www.gugudata.com/api/details/whois](https://www.gugudata.com/api/details/whois)

**接口地址:** https://api.gugudata.com/v2/websitetools/whois

**返回格式:** application/json; charset=utf-8

**请求方式:** GET

**请求协议:** HTTPS

**请求示例:** https://api.gugudata.com/v2/websitetools/whois?appkey=YOUR_APPKEY&domain=YOUR_VALUE

**数据预览:** [https://www.gugudata.com/preview/whois](https://www.gugudata.com/preview/whois)

**接口测试:** [https://api.gugudata.com/v2/websitetools/whois/demo](https://api.gugudata.com/v2/websitetools/whois/demo)

# 3. 请求参数

| 参数名 | 参数类型 | 是否必须 |   默认值    |           备注            |
| :----: | :------: | :------: | :---------: | :-----------------------: |
| appkey |  string  |    是    | YOUR_APPKEY |    付费后获取的 APPKEY    |
| domain |  string  |    是    | YOUR_VALUE  | 域名地址，如 gugudata.com |

# 4. 返回参数

|            参数名            | 参数类型 |                 备注                 |
| :--------------------------: | :------: | :----------------------------------: |
|    dataStatus.statusCode     |   int    |            接口返回状态码            |
| dataStatus.statusDescription |  string  |           接口返回状态说明           |
| dataStatus.responseDateTime  |  string  |           接口数据返回时间           |
|  dataStatus.dataTotalCount   |   int    | 此条件下的总数据量，一般用于分页计算 |
|         data.address         |  string  |               注册地址               |
|          data.city           |  string  |               注册城市               |
|         data.country         |  string  |               注册国家               |
|      data.creation_date      |  string  |               注册时间               |
|         data.dnssec          |  string  |                DNSSEC                |
|       data.domain_name       | string[] |            域名，数组形式            |
|         data.emails          |  string  |               注册邮箱               |
|     data.expiration_date     |  string  |               过期时间               |
|          data.name           |  string  |              注册人姓名              |
|      data.name_servers       | string[] |              DNS 服务器              |
|           data.org           |  string  |              注册人组织              |
|      data.referral_url       |  string  |              注册人 URL              |
| data.registrant_postal_code  |  string  |              注册人邮编              |
|        data.registrar        |  string  |                注册商                |
|          data.state          |  string  |               注册省份               |
|         data.status          | string[] |               域名状态               |
|      data.updated_date       |  string  |               更新时间               |