域名 DNS 信息查询

查询域名的 DNS 记录，按记录类型返回结果。无记录类型省略；合法全空返回空对象，沿用不扣调用包的判定。查询预算最多 20 秒，解析失败返回 503。只查询输入名称及既有解析链，不遍历所有子域，不保证发现全部 SRV 服务，也不按域名自动执行 IP 反查。TTL 为 DNS 记录提供的值；记录可能来自仍在有效期内的 DNS 缓存。

当前接口契约

接口详情：https://www.gugudata.com/api/details/dnslookup

功能说明

输入域名，一次查询 A、AAAA、MX、TXT、NS、CNAME、SRV、PTR 和 SOA 九种记录类型，汇总已解析到的结果；

查看 A 与 AAAA 记录，核对域名指向的 IPv4、IPv6 地址；

返回 MX 记录的邮件服务器与优先级，便于检查域名的邮件接收配置；

获取 TXT 记录内容，可用于查看 SPF 声明及域名验证文本；

查看 NS 记录，了解域名使用的 DNS 服务器；

提供 SOA 记录，便于核对主 DNS 服务器、区域序列号等解析管理信息；

查询 CNAME 别名指向，帮助检查网站接入 CDN 或其他服务时的域名配置；

每条记录包含名称、TTL、类别、类型和记录值，便于并列查看解析信息；

结果按记录类型分组，同类型的多条记录以数组返回，方便展示多个地址或邮件服务器；

支持中文国际化域名，并兼容域名大小写与末尾的点，便于接入不同来源的域名列表；

无对应记录的类型会省略；合法无记录与解析失败分别返回，方便巡检任务区分结果；

可与 SSL 证书查询、WHOIS 查询组合，在同一站点巡检流程中检查解析、证书与域名注册信息；

请求参数

参数	类型	必填	默认值	说明
appkey	string	否	无	支持 appkey/appKey Query、X-GUGUDATA-APPKEY/X-API-Key Header 或 Bearer；多处提供时须一致。 AppKey 整体必填；在本操作已声明支持的鉴权位置任选一个提供，本位置无需重复填写。多处填写时须一致。
domain	string	是	YOUR_VALUE	域名，不含协议、路径或端口；支持国际化域名，参数不可重复。只查询该名称及其解析链，不遍历子域或发现全部服务名称。

正常响应字段

字段	类型	说明
dataStatus.requestParameter	string	安全的域名参数，不包含凭据。
dataStatus.statusCode	integer	HTTP状态码
dataStatus.status	string	请求状态
dataStatus.statusDescription	string	请求状态的描述
dataStatus.responseDateTime	string	响应时间
dataStatus.dataTotalCount	integer	沿用对象计数口径，成功为 1，并非记录条数。
data.*	array	按类型分组的记录数组；无记录类型省略，全空返回空对象并沿用不扣调用包的判定。
data.*.domain	string	解析的域名
data.*.ttl	string	DNS 记录提供的 TTL 字符串；记录可能来自有效期内的 DNS 缓存。
data.*.class	string	解析记录的类别
data.*.type	string	解析记录的类型
data.*.value	string	解析记录的值

业务状态说明

业务状态码	业务状态码解释	备注
200	成功	SUCCESS; HTTP 200
400	参数错误	PARAMETER_ERROR; HTTP 400
402	凭据缺失或无效	APPKEY_NOT_SUPPLIED / APPKEY_NOT_EXISTED; HTTP 401/403
403	订单过期或无权限	APPKEY_EXPIRED; HTTP 403
429	请求频率超限	REQUEST_FREQUENCY_LIMIT; HTTP 429
500	内部错误	FAILED; HTTP 500
503	解析或鉴权服务暂时不可用	UPSTREAM_UNAVAILABLE / AUTH_SERVICE_UNAVAILABLE; HTTP 503
505	调用包额度不可用	APPKEY_CALL_CREDITS_EXHAUSTED; HTTP 403

返回响应

🟢200成功

application/json

成功（业务码 200）。

Bodyapplication/json

示例

{
  "dataStatus": {
    "requestParameter": "domain=gugudata.com",
    "statusCode": 200,
    "status": "SUCCESS",
    "statusDescription": "successfully / 成功",
    "responseDateTime": "2026-10-02 18:59:23",
    "dataTotalCount": 1
  },
  "data": {
    "A": [
      {
        "domain": "gugudata.com.w.kunlunpi.com.",
        "ttl": "60",
        "class": "IN",
        "type": "A",
        "value": "115.223.42.141"
      },
      {
        "domain": "gugudata.com.w.kunlunpi.com.",
        "ttl": "60",
        "class": "IN",
        "type": "A",
        "value": "115.223.42.236"
      },
      {
        "domain": "gugudata.com.w.kunlunpi.com.",
        "ttl": "60",
        "class": "IN",
        "type": "A",
        "value": "115.223.42.237"
      },
      {
        "domain": "gugudata.com.w.kunlunpi.com.",
        "ttl": "60",
        "class": "IN",
        "type": "A",
        "value": "115.223.42.136"
      },
      {
        "domain": "gugudata.com.w.kunlunpi.com.",
        "ttl": "60",
        "class": "IN",
        "type": "A",
        "value": "115.223.42.137"
      },
      {
        "domain": "gugudata.com.w.kunlunpi.com.",
        "ttl": "60",
        "class": "IN",
        "type": "A",
        "value": "115.223.42.135"
      },
      {
        "domain": "gugudata.com.w.kunlunpi.com.",
        "ttl": "60",
        "class": "IN",
        "type": "A",
        "value": "115.223.42.140"
      },
      {
        "domain": "gugudata.com.w.kunlunpi.com.",
        "ttl": "60",
        "class": "IN",
        "type": "A",
        "value": "115.223.42.134"
      }
    ],
    "AAAA": [
      {
        "domain": "gugudata.com.w.kunlunpi.com.",
        "ttl": "60",
        "class": "IN",
        "type": "AAAA",
        "value": "240e:f7:c000:105:3:0:0:7"
      },
      {
        "domain": "gugudata.com.w.kunlunpi.com.",
        "ttl": "60",
        "class": "IN",
        "type": "AAAA",
        "value": "240e:f7:c000:105:3:0:0:8"
      }
    ],
    "MX": [
      {
        "domain": "gugudata.com.",
        "ttl": "600",
        "class": "IN",
        "type": "MX",
        "value": "10 mxbiz2.qq.com."
      },
      {
        "domain": "gugudata.com.",
        "ttl": "600",
        "class": "IN",
        "type": "MX",
        "value": "5 mxbiz1.qq.com."
      }
    ],
    "TXT": [
      {
        "domain": "gugudata.com.",
        "ttl": "60",
        "class": "IN",
        "type": "TXT",
        "value": "postman-domain-verification=a142112f3dd5ff5b3621b864a65df9386079bf7503faa35af49d00defe47afaba296bd32ba7c868b2391c5f8deb412c83a0b1b9ce8aaefc125125e326b7c2c35"
      },
      {
        "domain": "gugudata.com.",
        "ttl": "60",
        "class": "IN",
        "type": "TXT",
        "value": "v=spf1 include:spf.mail.qq.com -all"
      },
      {
        "domain": "gugudata.com.",
        "ttl": "60",
        "class": "IN",
        "type": "TXT",
        "value": "yandex-verification: 21a626b2d656cefa"
      }
    ],
    "NS": [
      {
        "domain": "gugudata.com.",
        "ttl": "3600",
        "class": "IN",
        "type": "NS",
        "value": "vip4.alidns.com."
      },
      {
        "domain": "gugudata.com.",
        "ttl": "3600",
        "class": "IN",
        "type": "NS",
        "value": "vip3.alidns.com."
      }
    ],
    "CNAME": [
      {
        "domain": "gugudata.com.",
        "ttl": "600",
        "class": "IN",
        "type": "CNAME",
        "value": "gugudata.com.w.kunlunpi.com."
      }
    ],
    "SOA": [
      {
        "domain": "gugudata.com.",
        "ttl": "600",
        "class": "IN",
        "type": "SOA",
        "value": "vip3.alidns.com. hostmaster.hichina.com. 2026081313 3600 1200 86400 600"
      }
    ]
  }
}

🟠400参数错误（业务码 400）。

🟠401凭据缺失或无效（业务码 402）。

🟠403凭据缺失或无效（业务码 402）；订单过期或无权限（业务码 403）；调用包额度不可用（业务码 505）。

🟠429请求频率超限（业务码 429）。

🔴500内部错误（业务码 500）。

🔴503解析或鉴权服务暂时不可用（业务码 503）。

当前接口契约#

功能说明#

请求参数#

正常响应字段#

业务状态说明#

请求参数

请求示例代码

返回响应

当前接口契约

功能说明

请求参数

正常响应字段

业务状态说明