public
GET /v1/public/domains/whois
Free public WHOIS lookup for any domain.
Autenticación
Este endpoint es público. No requiere credenciales ni organización; es lo que leen nuestro propio sitio de marketing y los motores de respuesta de IA.
Este endpoint no requiere ningún id de organización. Su clave ya identifica la organización a la que pertenece, y la respuesta está delimitada a ella.
Pruébalo
Reemplaza cualquier elemento entre corchetes angulares por tus propios valores, y el marcador de posición key con una clave de tu panel de control.
curl -X GET https://api.zinndigital.com/v1/public/domains/whois?domain=<domain>¿Has iniciado sesión? La consola de la API en tu panel de control rellena el ID de tu organización real y tu propia clave, y ejecuta la solicitud contra la API en vivo para que puedas ver la respuesta real. Abre este endpoint en la consola de la API
Detalles
What the public registry says about a domain — registrar, registration and expiry dates, status codes, nameservers and DNSSEC — for **any** name, whether it is with us or not. No account, one domain per request. Read from RDAP (RFC 7482/7483), which the registries serve themselves and which needs no credential. **`state` is three-valued and that is load-bearing.** `registered` means the registry returned a record. `not_registered` means it answered `404` — there is no such registration. `unknown` means we could not find out: the extension publishes no RDAP service, the registry timed out, rate-limited us, or answered with something we could not read. ⛔ A client must never render `unknown` as `not_registered`: they send a visitor to opposite actions, and collapsing them is the defect that once offered `google.com` for sale with a valid checkout token. `registry` is `null` for both non-`registered` states. Inside it every field is nullable, and `null` means *the registry did not publish it* — never that the domain lacks it. A client rendering `transfer_locked: null` as "unlocked" would tell somebody to go and protect a domain that is already protected. No registrant, admin or technical contact is ever carried: post-GDPR most registries redact them, and republishing the ones that do not would be exporting personal data for no product reason. **Rate limited per caller and globally**, and answers are cached for 24 hours per domain. There is deliberately no bulk or CSV input — the bulk surface is the authenticated one, where the caller has an organisation.
Parámetros
| Nombre | Tipo | Obligatorio | ¿Qué es esto? |
|---|---|---|---|
domain (query) | string | Sí | The domain to look up, including its extension. A trailing dot is ignored, case is ignored, and an internationalised name must already be punycoded. |
Respuesta
| Nombre | Tipo | Obligatorio | ¿Qué es esto? |
|---|---|---|---|
fqdn | string | Sí | The normalised name that was looked up (lower-cased, no trailing dot). |
state | string<registered, not_registered, unknown> | Sí | `registered` — the registry returned a record. `not_registered` — the registry answered `404`. `unknown` — we could not find out (no RDAP service for the extension, a timeout, a… |
registry | RegistryProfile | Sí | The registry record, or `null` for any state other than `registered`. |
Errores que este endpoint puede devolver
422 · 429 · 503