WhoDNS API
The site’s tools as a REST API. Auth via Authorization: Bearer or X-API-Key; JSON responses with the standard {ok, data|error} shape.
Quick start
curl "https://whodns.ir/api/v1/dns?domain=example.com" -H "Authorization: Bearer YOUR_KEY"Get a free key: API Keys · Pricing: API Pricing
Interactive playground
Your key is stored only in your browser (localStorage) and sent straight to /api/v1.
/api/v1/me
Key summary and usage
The name, status, allowed endpoints, limits, current usage and expiry of the key you call it with. Always available and never counted against your quota, so it is a good way to test a key and monitor usage.
/api/v1/dns
DNS check (A and NS)
The A (IPv4) and NS (nameserver) records of a domain as seen by the chosen resolver. A light, fast reply; the heavier DNS sections (reachability, DNSSEC, email security and a score) are intentionally not part of this endpoint.
| Parameter | Required | Description | Example |
|---|---|---|---|
domain | ✓ | The domain, e.g. example.com | example.com |
resolver | — | DNS resolver: 8.8.8.8 (default), 1.1.1.1, 9.9.9.9, 178.22.122.100 (Shecan), 78.157.42.100 (Electro), system or any other public IP. | 1.1.1.1 |
/api/v1/dnssec
DNSSEC check
A domain's DNSSEC status as seen by a validating public resolver: DS records at the parent, DNSKEY keys (KSK and ZSK) and the AD flag.
| Parameter | Required | Description | Example |
|---|---|---|---|
domain | ✓ | The domain, e.g. example.com | cloudflare.com |
/api/v1/ptr
PTR lookup (reverse DNS)
The reverse name (PTR) of an IPv4 address, the reverse zone and its nameservers, the zone's primary server (SOA) and the nameserver that actually answered — plus the IP's owner and ISP.
| Parameter | Required | Description | Example |
|---|---|---|---|
ip | ✓ | An IPv4 address, e.g. 8.8.8.8 | 8.8.8.8 |
resolver | — | DNS resolver: 8.8.8.8 (default), 1.1.1.1, 9.9.9.9, 178.22.122.100 (Shecan), 78.157.42.100 (Electro), system or any other public IP. | 1.1.1.1 |
/api/v1/myip
My IP and IP details
Without parameters it returns the IP your request came from (your server's outbound IP) with country, city, ASN and ISP. With the ip parameter it returns details for that IP.
| Parameter | Required | Description | Example |
|---|---|---|---|
ip | — | An IP to look up; empty means your own IP. | 8.8.8.8 |
/api/v1/cdn
CDN and WAF detection
Detects the CDN, web application firewall (WAF) and front-end server of a website from its CNAME chain, nameservers, headers, cookies and IP owner — each with its evidence.
| Parameter | Required | Description | Example |
|---|---|---|---|
host | ✓ | A domain or IP, e.g. example.com | example.com |
/api/v1/ssl
SSL certificate check
A domain's TLS certificate: issuer, validity dates and days left, covered names (SAN), chain, chain trust and name match.
| Parameter | Required | Description | Example |
|---|---|---|---|
domain | ✓ | The domain, e.g. example.com | example.com |
port | — | TLS port; default 443. | 443 |
/api/v1/tls
TLS version and cipher scan
Which TLS versions are supported (1.0 to 1.3), the cipher negotiated for each, and insecure versions that are enabled.
| Parameter | Required | Description | Example |
|---|---|---|---|
host | ✓ | A domain or IP, e.g. example.com | example.com |
port | — | TLS port; default 443. | 443 |