DomaineeDocs

CNAME Lookup API

Free public REST API for the CNAME Lookup on Domainee. No API key, CORS-enabled, rate-limited per IP.

GEThttps://api.domainee.dev/v1/tools/cname-lookup?host=www.domainee.dev

Resolve a hostname's CNAME chain. Flags apex-domain misuse (apex domains can't legally have CNAME records per RFC 1034) and returns the full chain to the final A record.

Free. No API key required. CORS-enabled. Rate-limited per IP at 30/min and 500/day.

Parameters

NameInTypeDescription
hostrequiredquerystring
Hostname to resolve. Use a subdomain like `www.example.com`.
example: www.domainee.dev

Example request

curl
curl -s "https://api.domainee.dev/v1/tools/cname-lookup?host=www.domainee.dev" | jq

Example response

response.json
{
  "ok": true,
  "data": {
    "host": "www.domainee.dev",
    "isApex": false,
    "cnames": [
      "domainee.dev."
    ],
    "finalIps": [
      "35.165.194.233"
    ]
  }
}

Other languages

fetch.js
const res = await fetch("https://api.domainee.dev/v1/tools/cname-lookup?host=www.domainee.dev");
const { ok, data } = await res.json();
requests.py
import requests
r = requests.get(
    "https://api.domainee.dev/v1/tools/cname-lookup",
    params={"host":"www.domainee.dev"},
)
data = r.json()["data"]

Rate limits & errors

  • 30 requests/minute and 500 requests/day per IP. Exceeding either returns HTTP 429 with a Retry-After header.
  • All responses are JSON with the envelope { "ok": true, "data": {...} } on success or { "ok": false, "error": { "code", "message" } } on failure.
  • code values are stable; safe to switch on programmatically. message is human-friendly and may change.

See also

On this page