Whois Lookup
Whois Lookup devuelve la ficha de registro pública de un dominio, con el registrador y su IANA ID, las fechas en que el dominio se registró, se actualizó por última vez y vence, sus códigos de estado, sus name servers y el estado de DNSSEC, además de la organización y el país del titular cuando la ficha los incluye. Esas fechas y configuraciones indican la antigüedad de un dominio, cuándo vence su registro, si está bloqueado contra transferencias y dónde está delegado su DNS, lo que respalda el monitoreo de vencimientos, la verificación de proveedores y las auditorías de portafolios de dominios.
Funcionalidades de la Whois Lookup API
- Ficha actualizada al momento de la solicitudCada consulta lee la ficha de registro en el momento de la solicitud, así que las fechas y los estados reflejan el dominio tal como está cuando usted pregunta.
- Fechas de registro, actualización y vencimientopublished_at, updated_at y expires_at dan la cronología del registro en ISO 8601, desde el primer registro hasta el vencimiento vigente.
- Registrador con su IANA IDregistrar nombra a la empresa que administra el dominio y registrar_iana_id da su número IANA para cruzarlo con listas de registradores.
- Códigos de estado, name servers y DNSSECstatuses enumera códigos de estado del dominio como client transfer prohibited, nameservers muestra dónde está delegado el DNS e is_dnssec_signed indica si DNSSEC está activo.
- Subdominios resueltos a su dominio registradoUn host como docs.example.com se consulta bajo example.com, así que un nombre de host copiado de un enlace o de una dirección de correo se puede enviar tal cual.
Parámetros de la Whois Lookup API
| Parámetros | Obligatorio | Descripción |
|---|---|---|
target | Obligatorio | Un dominio, como github.com, o una raíz de sitio, como https://github.com/. Los subdominios se consultan bajo su dominio registrado; indique solo el host, sin ruta de página. |
Cómo usar la Whois Lookup API
Envíe un dominio y lea su ficha de registro como una sola fila.
- Envíe {"target": "github.com"} por POST a /v1/seo/whois.
- Consulte GET /v1/tasks/{task_id} hasta que status sea succeeded.
- Lea la ficha en results.items; has_more y results.next_cursor siguen las reglas de paginación habituales y quedan vacíos para esta única fila.
curl -X POST "https://api.socq.ai/v1/seo/whois" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"target":"github.com"}'Casos de uso de la Whois Lookup API
- Monitoreo de vencimientos: Guarde expires_at de los dominios que tiene o que le interesan y programe revisiones antes de esa fecha para renovar a tiempo o detectar una liberación.
- Verificar la antigüedad del dominio de un proveedor: Compare published_at con la fecha actual para ver cuánto tiempo lleva existiendo el dominio de un proveedor o de un contacto nuevo antes de confiar en él.
- Auditar un portafolio de dominios: Ponga lado a lado registrar, nameservers, is_dnssec_signed y statuses de sus dominios para encontrar los que están con el registrador equivocado, sin DNSSEC o sin bloqueo de transferencia.
- Detectar cambios en el registro: Vigile updated_at junto con statuses y nameservers para notar cuándo cambió la ficha de un dominio, por ejemplo tras una transferencia de registrador o un cambio de DNS.
Consejos de expertos para la Whois Lookup API
- Cuando una lista contenga varios subdominios de un mismo dominio, redúzcalos primero al dominio registrado, ya que cada uno devolvería la misma fila a 5 créditos por solicitud.
- Calcule la antigüedad del dominio y los días que faltan para su vencimiento a partir de published_at y expires_at frente a collected_at, todas marcas de tiempo ISO 8601.
- Compare statuses con las frases en minúsculas en que se devuelven, como client transfer prohibited, y no con los códigos EPP en camel case.
APIs relacionadas
Además de la Whois Lookup API, use estas APIs cuando necesite otro tipo de datos públicos de SEO.
- Google Organic SERP API — Obtiene una página de resultados de Google en vivo por consulta y mercado, con destinos normalizados, posiciones, tipos de elemento y detalles completos de los resultados.
- Keyword Difficulty API — Compara la dificultad de posicionamiento orgánico de un lote de palabras clave enviado, y devuelve cada palabra clave disponible con su puntuación normalizada.
- Keyword Overview API — Enriquece un lote de palabras clave enviado con el contexto disponible de demanda, competencia de pago, dificultad, búsquedas mensuales e intención.
- Backlinks Summary API — Resume en una sola fila el perfil de enlaces de un dominio, subdominio o página, con rank de autoridad, totales de backlinks y dominios de referencia, spam score y desgloses del origen de los enlaces.
- Domain Overview API — Obtiene los totales orgánicos y de pago en Google de un dominio para un país y un idioma, con palabras clave posicionadas, tráfico estimado y su costo en anuncios, rangos de posición y cambios de posicionamiento.
- Domain Technologies API — Detecta las tecnologías que usa un sitio web a partir de su dominio, con categorías, rank de autoridad, perfiles sociales y contactos publicados.
- Keyword Search Volume API
- Keywords for Site API
- Keyword Suggestions API
- Ranked Keywords API
- Related Keywords API
- Relevant Pages API
- Search Intent API
- Backlinks API
- Referring Domains API
- Backlink Competitors API
- Competitor Domains API
- Traffic Estimate API
- Google News API
- Google Images API
- Bing Search API
- YouTube Rank Tracker API
- Google Autocomplete API