API
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| Endpoint | Returns |
|---|---|
| GET /api/v1 | self-describing endpoint index |
| GET /api/v1/domain/example.dk | latest scan record set (add ?scan_id=N for a past scan) |
| GET /api/v1/domain/example.dk/history | scan history for the domain |
| GET /api/v1/domain/example.dk/timeline | change timeline for the domain (zone, registrar, WHOIS, NS, delegation, DNSSEC, mail, hosting) |
| GET /api/v1/reverse/ns/ns1.gratisdns.dk | reverse 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/asns | top asns|ns|mx|countries|ips|srv|autodiscover|autoconfig|halloffame|dangling |
| GET /api/v1/changes/asn?view=net | migrations — kind asn|ns|reg, view net|gaining|losing|recent (net = asn only) |
| GET /api/v1/zone/newcomers?days=14 | zone churn — newcomers|expired|changed|revisions |
| GET /api/v1/zone/wwwapex?kind=network | www vs bare domain differences — kind = network|www_missing|apex_missing |
| GET /api/v1/nameserver/ns1.gratisdns.dk | zone-transfer / glue / CHAOS-version profile |
| GET /api/v1/stats | dashboard 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" }
}
}| Tool | What it returns |
|---|---|
| lookup_domain | Current 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_history | Scan history of a domain (newest first, up to 50): when it was scanned and record counts per scan. |
| domain_timeline | Change 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_lookup | Which .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. |
| leaderboard | Zone-wide top lists: hosting ASNs, nameservers, mail servers, countries, IPs, SRV/autodiscover targets, the DNS hall of fame, dangling www CNAMEs. |
| market_changes | Who is gaining or losing .dk domains over the last 30 days: hosting ASNs (asn), nameservers (ns) or registrars (reg). |
| zone_list | Zone 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_profile | Probe 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). |