API

Public, read-only JSON access to the .dk DNS dataset — no key required

The dhd.dk API gives free, read-only JSON access to the same .dk DNS dataset shown on this site: domain records, reverse lookups, leaderboards and zone changes. AI assistants can use it through the MCP server at /mcp. No key is required. Data comes from our own scanners, which re-resolve every .dk domain in the zone roughly once a week.

Endpoints#

Base URL: https://www.dhd.dk/api/v1
EndpointReturns
GET /api/v1self-describing endpoint index
GET /api/v1/domain/example.dklatest scan record set (add ?scan_id=N for a past scan)
GET /api/v1/domain/example.dk/historyscan history for the domain
GET /api/v1/domain/example.dk/timelinechange timeline for the domain (zone, registrar, WHOIS, NS, delegation, DNSSEC, mail, hosting)
GET /api/v1/reverse/ns/ns1.gratisdns.dkreverse lookup — by ns|mx|asn|ip|ip6|cidr|isp|country|city|ptr|rname|acme|caa|tlsrpt|www|wwwbase|dkim|nsip|nsptr|spf|srv|srvtarget|registrar|autodiscover|autoconfig
GET /api/v1/leaderboard/asnstop asns|ns|mx|countries|ips|srv|autodiscover|autoconfig|halloffame|dangling
GET /api/v1/changes/asn?view=netmigrations — kind asn|ns|reg, view net|gaining|losing|recent (net = asn only)
GET /api/v1/zone/newcomers?days=14zone churn — newcomers|expired|changed|revisions
GET /api/v1/zone/wwwapex?kind=networkwww vs bare domain differences — kind = network|www_missing|apex_missing
GET /api/v1/nameserver/ns1.gratisdns.dkzone-transfer / glue / CHAOS-version profile
GET /api/v1/statsdashboard aggregate cache, without the per-ASN/ISP/nameserver profile extras (?full=1 adds them, ~2.7 MB)

Response shape#

Every response is {data, meta}; errors are {error:{code,message}} with the matching HTTP status. List endpoints accept page and per_page (≤500).

{
  "data": [ … ],
  "meta": { "count": 123, "page": 1, "per_page": 50, "pages": 3, "as_of": "…Z" }
}

MCP server#

The same data is available to AI assistants as a Model Context Protocol server at https://www.dhd.dk/mcp (Streamable HTTP, stateless, no key). Every tool maps onto an endpoint above; results are capped at 100 rows per page. Machine-readable description: server card, llms.txt.

{
  "mcpServers": {
    "dhd-dk": { "type": "http", "url": "https://www.dhd.dk/mcp" }
  }
}
ToolWhat it returns
lookup_domainCurrent DNS profile of a .dk domain from its latest scan: NS (+IPs, ASN, PTR), A/AAAA, MX, TXT/SPF/DMARC, CAA, DNSSEC verdict, SOA, mail/web hosting. meta.last_checked is when a scanner last confirmed the zone; meta.expired_at is set once the domain left the zone. data.www_vs_apex compares www.<domain> with the bare domain (verdict same|network|www_missing|apex_missing|neither, addresses + ASNs of both; current probe, latest scan only). Pass scan_id for a historical scan.
domain_historyScan history of a domain (newest first, up to 50): when it was scanned and record counts per scan.
domain_timelineChange timeline of a domain: entering/leaving the zone, registrar moves, WHOIS status/expiry changes, NS changes, delegation (ok/lame/deactivated), DNSSEC, mail and web hosting changes.
reverse_lookupWhich .dk domains use a given nameserver, mail server, IP, CIDR, ASN, ISP, country, registrar, etc. (current state). by=cidr matches every address inside the block for IPv4 /16 and IPv6 /32 or narrower (meta.match=contains); a wider block only matches an identical GeoLite2 block (exact_block). Paged; meta.count is capped at 100000.
leaderboardZone-wide top lists: hosting ASNs, nameservers, mail servers, countries, IPs, SRV/autodiscover targets, the DNS hall of fame, dangling www CNAMEs.
market_changesWho is gaining or losing .dk domains over the last 30 days: hosting ASNs (asn), nameservers (ns) or registrars (reg).
zone_listZone movement: newly registered domains (newcomers), domains that left the zone (expired), recently changed domains, zone-list revisions with added/removed counts, or wwwapex: domains whose www and bare name differ (kind=network: different ASNs; www_missing: only the bare domain resolves; apex_missing: only www resolves).
nameserver_profileProbe profile of an authoritative nameserver: AXFR/IXFR open, ANY handling, glue, CHAOS version, and data.protocols: protocol support (TCP, EDNS + version negotiation + unknown options, NSID, cookies, TCP keepalive, ECS, extended errors, ZONEVERSION, error reporting, refusing recursion, DoT, DoH; null until probed). data.response_times.scanners: per scanner (anonymous labels), per day, the median/p90/mean milliseconds its resolver needed for the first A query of domains delegated here (resolver-inclusive; compare days, not hosts). data.round_trip: per day, answered/sent and median/p90 ms of direct SOA queries to one IPv4 of this server from our reference scanner (no resolver; null until sampled).