Fast, stateless Network Diagnostics

Network & DNS

GET/api/v1/dns-lookup

DNS Lookup

A, AAAA, MX, TXT, CNAME, NS, and SOA records.

ParameterTypeRequiredDescription
domainstringYesDomain to resolve.
resolverstringNoWhich resolver to query — an ip from the DNS Propagation Checker's named list (8.8.8.8 Google, 1.1.1.1 Cloudflare, 9.9.9.9 Quad9, 208.67.222.222 OpenDNS, 64.6.64.6 Verisign, 94.140.14.14 AdGuard, 223.5.5.5 Alibaba, 4.2.2.1 Level3), or "system" for this server's own default resolver. Omitted or unrecognized defaults to "system".

Example request

curl "https://netsh.io/api/v1/dns-lookup?domain=example.com&resolver=1.1.1.1&api_key=YOUR_API_KEY"

Example response

{
  "ok": true,
  "data": {
    "domain": "example.com",
    "records": {
      "A": ["104.16.132.229", "104.16.133.229"],
      "AAAA": ["2606:4700::6810:85e5"],
      "MX": [{ "exchange": "mx1.example.com", "priority": 10, "type": "MX" }],
      "TXT": ["v=spf1 include:_spf.example.com -all", "google-site-verification=..."],
      "CNAME": [],
      "NS": ["ns1.example.com", "ns2.example.com"],
      "SOA": [{ "nsname": "ns1.example.com", "hostmaster": "dns.example.com", "serial": 2414136692, "refresh": 10000, "retry": 2400, "expire": 604800, "minttl": 300 }]
    },
    "resolver": { "name": "Cloudflare", "ip": "1.1.1.1" }
  },
  "meta": { "tool": "dns-lookup", "version": "v1" }
}