# 域名 DNS 信息查询 API 数据接口


域名 DNS 信息查询 API 数据接口

网络工具，多种记录类型数据返回，丰富的信息结构，毫秒级响应。

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

# 1. 产品功能

- 提供域名 DNS 解析完整记录；
- 丰富的解析记录类型，包括：A, AAAA, MX, TXT, NS, CNAME, SRV, PTR, SOA；
- 支持多种解析记录类型的查询；
- 毫秒级解析性能，支持高并发；
- 全接口支持 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/dnslookup](https://www.gugudata.com/api/details/dnslookup)

**接口地址:** https://api.gugudata.com/v2/websitetools/dns-lookup

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

**请求方式:** GET

**请求协议:** HTTPS

**请求示例:** https://api.gugudata.com/v2/websitetools/dns-lookup?appkey={{YOUR_APPKEY}}&domain={{YOUR_VALUE}}

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

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

# 3. 请求参数

| 参数名 | 参数类型 | 是否必须 |   默认值    |                备注                 |
| :----: | :------: | :------: | :---------: | :---------------------------------: |
| appkey |  string  |    是    | YOUR_APPKEY |         付费后获取的 APPKEY         |
| domain |  string  |    是    | YOUR_VALUE  | 需要解析的域名，格式为 gugudata.com |

# 4. 返回参数

|            参数名            | 参数类型 |                             备注                             |
| :--------------------------: | :------: | :----------------------------------------------------------: |
| dataStatus.requestParameter  |  string  |                        请求的域名参数                        |
|    dataStatus.statusCode     | integer  |                          HTTP状态码                          |
|      dataStatus.status       |  string  |                           请求状态                           |
| dataStatus.statusDescription |  string  |                        请求状态的描述                        |
| dataStatus.responseDateTime  |  string  |                           响应时间                           |
|  dataStatus.dataTotalCount   | integer  |                       返回数据的总条数                       |
|            data.*            |  string  | 解析记录类型，包括：A, AAAA, MX, TXT, NS, CNAME, SRV, PTR, SOA |
|        data.*.domain         |  string  |                          解析的域名                          |
|          data.*.ttl          |  string  |                        解析记录的 TTL                        |
|         data.*.class         |  string  |                        解析记录的类别                        |
|         data.*.type          |  string  |                        解析记录的类型                        |
|         data.*.value         |  string  |                         解析记录的值                         |