DNSfish API · v1

面向运维、监控与 CI 的 DNS API。

与站点同一套引擎，提供 JSON、JSONP 与 DoH 接口。每日 1,000 次以内免认证，无限速页面，无追踪。

GET/v1/lookup/:domain200 OK · 38ms p50

针对指定解析器查询域名的全部记录类型。可使用 ?types=A,MX,TXT 限定返回类型。

参数

名称	类型	默认值	说明
domain	string	—	必填，需要查询的主机名。
types	string[]	all	逗号分隔，例如 A,AAAA,MX
resolver	string	cloudflare	可选 cloudflare、google、quad9、opendns、auth
trace	bool	false	是否包含从根域开始的完整递归追踪。

请求示例

cURL

$ curl "https://api.dnsfish.com/v1/lookup/github.com" \
    -H "Accept: application/json"

响应

application/json200 OK

{
  "domain": "github.com",
  "resolver": "cloudflare",
  "queried_at": "2026-05-24T18:42:11Z",
  "latency_ms": 38,
  "dnssec": { "signed": false, "reason": "no DS at parent" },
  "answers": {
    "A": [{ "value": "140.82.114.4", "ttl": 60 }],
    "MX": [{ "priority": 1, "value": "aspmx.l.google.com." }, /* 还有 4 条 */]
  }
}

SDK 代码

JavaScript

import { dnsfish } from "dnsfish"
const r = await dnsfish.lookup("github.com")
console.log(r.answers.A)

Python

import dnsfish
r = dnsfish.lookup("github.com")
print(r.answers["A"])

client := dnsfish.New("")
r, _ := client.Lookup("github.com")
fmt.Println(r.Answers.A)

Shell

$ dnsfish lookup github.com --type mx
1 aspmx.l.google.com.
5 alt1.aspmx.l.google.com.