Consulta WHOIS
La salida cruda de WHOIS es un desorden de formatos: cada registro escribe su propio dialecto de texto plano y no hay dos exactamente iguales. Este endpoint consulta la capa moderna de RDAP por debajo y devuelve registrador, fechas de creación y expiración, códigos de estado y servidores de nombres como campos estructurados y limpios, para que deje de escribir expresiones regulares contra un formato que nunca fue pensado para parsearse.
Ejecútela online
Ejecute esto en nuestros servidores con su cuenta. Las herramientas gratuitas corren en su navegador; esta cobra de su saldo del KIT según el precio de arriba.
Por qué el WHOIS en texto plano se volvió un problema
Durante décadas, las respuestas de WHOIS llegaron como texto con formato libre y sin un esquema compartido entre registros: donde un registrador escribe 'Registry Expiry Date', otro escribe 'Expiration Date', y el orden de los campos cambia sin previo aviso. Cualquier equipo que alguna vez construyó un scraper contra WHOIS en crudo tiene una historia de terror sobre un registro que cambió su formato en silencio y rompió un script que llevaba años funcionando bien.
RDAP: la solución que la industria construyó para sí misma
RDAP (Registration Data Access Protocol) se desarrolló específicamente para reemplazar ese desorden con un protocolo real, estructurado y basado en JSON, regido por un estándar común, y los registros han migrado a él de forma constante. web.whois habla RDAP por debajo y normaliza la respuesta en una forma consistente entre registros, para que obtenga la confiabilidad de un protocolo moderno sin tener que rastrear qué registros ya terminaron su propia migración.
Qué devuelve una solicitud
Hace POST a /web/whois con un nombre de dominio, y la tarea consulta el nombre del registrador, las fechas de registro y expiración, los códigos de estado del dominio y los servidores de nombres autoritativos, y los devuelve como JSON estructurado por webhook firmado o mediante un enlace firmado válido por 24 horas. Se acabó dividir texto por dos puntos esperando que el orden de las líneas no haya cambiado desde la semana pasada.
Dónde encaja en flujos reales
Los intermediarios de compraventa de dominios lo usan para verificar señales de propiedad antes de una venta, los equipos de seguridad lo usan para rastrear quién registró un dominio sospechoso que imita una marca, y las herramientas internas lo usan para autocompletar registrador y servidores de nombres en un inventario de dominios en vez de pedirle a alguien que copie y pegue desde el panel de un registrador. Al ser asíncrono y basado en webhooks, encaja en un proceso por lotes o en un flujo de incorporación sin que nadie tenga que vigilarlo.
Precio simple y predecible
Cada consulta cuesta $0.002, así que auditar una lista de cientos de dominios cuesta centavos en vez de requerir un contrato de datos negociado. Solo se facturan las consultas que se completan; si una tarea falla de nuestro lado, se reintenta automáticamente hasta tres veces sin costo, así que un tropiezo pasajero nunca aparece en su factura.
Qué puede hacer con ella
Diligencia debida antes de comprar un dominio
Un intermediario revisa registrador, fecha de registro y servidores de nombres para confirmar el historial de un dominio antes de negociar una venta.
Protección de marca
Un equipo legal consulta los datos de registrante y registrador de un dominio sospechoso que imita una marca, como primer paso antes de enviar una solicitud de retiro.
Inventario interno de dominios
Un equipo de TI llena automáticamente una hoja de cálculo de los dominios de la empresa con datos de registrador y vencimiento en vez de revisarlos uno por uno a mano.
Auditoría de migración de servidores de nombres
Un equipo de operaciones verifica que los servidores de nombres realmente se actualizaron en decenas de dominios tras una migración masiva de proveedor DNS.
Preguntas frecuentes
¿Qué campos devuelve esta api whois?
El nombre del registrador, las fechas de registro y expiración, los códigos de estado del dominio y los servidores de nombres autoritativos, entregados como JSON estructurado en vez de texto plano.
¿Es WHOIS real o RDAP?
Consulta RDAP, el protocolo estructurado y estandarizado que sucede al WHOIS clásico, y normaliza los resultados para que obtenga campos consistentes entre distintos registros.
¿Por qué no parsear yo mismo el texto de WHOIS?
Puede hacerlo, pero cada registro lo formatea distinto y el diseño cambia sin aviso; este endpoint absorbe esa inconsistencia para que su integración no se rompa en silencio.
¿Hay un plan gratuito o una prueba?
No hay capa gratuita: las capas gratis se abusan y ralentizan a todos. El acceso funciona con un saldo prepago de ForHosting KIT: se recarga desde $10.00 (no caduca) y cada solicitud se cobra a su precio publicado, así que una llamada sin saldo devuelve HTTP 402. Sin suscripción, sin tokens ni créditos inventados, y una tarea fallida no se cobra.
¿Puedo consultar cualquier extensión de dominio?
Cubre dominios cuyos registros exponen RDAP o datos públicos de registro; un número pequeño de registros antiguos o muy restringidos por privacidad puede devolver campos limitados.
¿Qué tan rápida es la respuesta?
La tarea corre de forma asíncrona y normalmente se completa rápido; recibe el resultado por webhook firmado o mediante un enlace firmado válido por 24 horas.
¿Se cobra si el dominio está disponible, sin registrar?
Sí, un resultado de 'disponible' o sin registrar sigue siendo una consulta válida y facturada. Solo no se cobra si la tarea misma falla en ejecutarse, algo que se reintenta automáticamente hasta tres veces.
¿Puedo consultar dominios en bloque?
Llama al endpoint una vez por dominio, pero programarlo sobre una lista es sencillo y se mantiene económico a $0.002 por consulta.
Para desarrolladores — acceso por API
Todo lo de esta página está disponible por programación. Esta sección es para equipos que quieren integrarlo en sus sistemas; el resto puede usar la herramienta de arriba sin más.
Endpoint de API
¿Prefiere automatizarlo? Un POST autenticado crea la tarea; el resultado llega por webhook o enlace firmado. La misma capacidad también se ejecuta aquí en la web, y pronto desde nuestra app, el email y Telegram.
Llámela desde su stack
curl -X POST https://api.kit.forhosting.com/web/whois \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"domain":"ejemplo.com"}'const res = await fetch("https://api.kit.forhosting.com/web/whois", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"domain": "ejemplo.com"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/web/whois",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"domain": "ejemplo.com"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/web/whois", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"domain":"ejemplo.com"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"domain":"ejemplo.com"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/web/whois", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Ejemplo de solicitud
{
"domain": "ejemplo.com"
}Ejemplo de respuesta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "web.whois",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}La API es asíncrona: la llamada devuelve un task_id al instante y el resultado llega por webhook. El polling está limitado a 1 req/s por tarea.
Precio
Precio publicado — sin tokens ni créditos inventados. Una tarea fallida no se cobra.
Límites
timeout_sec | 30 |
max_crawl_pages | 25 |
Errores
| HTTP | Código | Significado |
|---|---|---|
401 | unauthorized | API key ausente o inválida. |
402 | insufficient_balance | El saldo no cubre el precio de la tarea. |
404 | unknown_type | El tipo de tarea no existe. |
429 | rate_limited | Demasiadas peticiones. Use el webhook en vez de sondear. |