Referencia para desarrolladores

Búsqueda WHOIS

API de DomScan: Obtén información WHOIS para un dominio incluyendo registrador, fechas y estado.

Búsqueda WHOIS

Obtén información WHOIS para un dominio incluyendo registrador, fechas y estado.

Nota de privacidad: La información de contacto puede estar oculta debido al RGPD y otras normativas de privacidad. La API detecta automáticamente cuando se utilizan servicios de privacidad/proxy y devuelve un objeto privacy con los detalles de la detección.
GET /v1/whois 2 Créditos

Parámetros de consulta

ParámetroTipoDescripción
domain obligatorio string Nombre de dominio completo (ej., example.com)

Campos de respuesta

CampoTipoDescripción
registeredbooleanSi el dominio esta registrado
registrarstringNombre del registrador
created_datestringFecha de creacion ISO 8601
expiry_datestringFecha de expiracion ISO 8601
statusarrayCodigos de estado EPP
nameserversarrayServidores de nombres autoritativos
contactsobjectContactos de registrante, admin, tech, facturacion
privacyobjectDeteccion de proteccion de privacidad

Solicitud de ejemplo

curl -H "X-API-Key: your-api-key" "https://domscan.net/v1/whois?domain=github.com"
const domscanFetch = (url, options = {}) =>
  fetch(url, {
    ...options,
    headers: { ...options.headers, "X-API-Key": "your-api-key" },
  });

const response = await domscanFetch(
  "https://domscan.net/v1/whois?domain=github.com"
);
const data = await response.json();

console.log(`Registrar: ${data.registrar}`);
console.log(`Created: ${data.created_date}`);
console.log(`Expires: ${data.expiry_date}`);
console.log(`Nameservers: ${data.nameservers.join(', ')}`);

// Check for privacy protection
if (data.privacy.is_private) {
  console.log(`Privacy service: ${data.privacy.privacy_service}`);
}
import requests

domscan = requests.Session()
domscan.headers.update({"X-API-Key": "your-api-key"})

from datetime import datetime

response = domscan.get(
    "https://domscan.net/v1/whois",
    params={"domain": "github.com"}
)
data = response.json()

# Calculate days until expiration
expiry = datetime.fromisoformat(data['expiry_date'].replace('Z', '+00:00'))
days_left = (expiry - datetime.now(expiry.tzinfo)).days

print(f"Registrar: {data['registrar']}")
print(f"Expires in {days_left} days")
print(f"Privacy protected: {data['privacy']['is_private']}")
package main

import (
  "encoding/json"
  "fmt"
  "net/http"
  "os"
)

func domscanGet(url string) (*http.Response, error) {
  request, err := http.NewRequest(http.MethodGet, url, nil)
  if err != nil {
    return nil, err
  }
  request.Header.Set("X-API-Key", os.Getenv("DOMSCAN_API_KEY"))
  return http.DefaultClient.Do(request)
}

func main() {
  resp, _ := domscanGet("https://domscan.net/v1/whois?domain=github.com")
  defer resp.Body.Close()

  var data map[string]interface{}
  json.NewDecoder(resp.Body).Decode(&data)

  fmt.Printf("Registrar: %s\n", data["registrar"])
  fmt.Printf("Created: %s\n", data["created_date"])
  fmt.Printf("Expires: %s\n", data["expiry_date"])
}
require 'net/http'
require 'json'
require 'date'

uri = URI("https://domscan.net/v1/whois?domain=github.com")
request = Net::HTTP::Get.new(uri)
request["X-API-Key"] = ENV.fetch("DOMSCAN_API_KEY")
response = Net::HTTP.start(uri.host, uri.port, use_ssl: uri.scheme == "https") { |http| http.request(request) }
data = JSON.parse(response.body)

expiry = DateTime.parse(data['expiry_date'])
days_left = (expiry - DateTime.now).to_i

puts "Registrar: #{data['registrar']}"
puts "Expires in #{days_left} days"

Respuesta de ejemplo

{
                "domain": "example.com",
                "registered": true,
                "registrar": "RESERVED-Internet Assigned Numbers Authority",
                "registrar_url": "https://www.iana.org",
                "registrar_iana_id": "376",
                "created_date": "1995-08-14T04:00:00Z",
                "updated_date": "2023-08-14T07:01:38Z",
                "expiry_date": "2024-08-13T04:00:00Z",
                "status": ["clientDeleteProhibited", "serverUpdateProhibited"],
                "nameservers": ["a.iana-servers.net", "b.iana-servers.net"],
                "dnssec": true,
                "contacts": {
                "registrant": {
                "name": "REDACTED FOR PRIVACY",
                "organization": "Internet Assigned Numbers Authority",
                "email": null,
                "phone": null,
                "address": {
                "country": "US"
                },
                "role": "registrant"
                },
                "admin": { "name": "Domain Administrator", "email": "admin@example.org" },
                "tech": { "name": "Technical Contact", "email": "tech@example.org" },
                "billing": null
                },
                "privacy": {
                "is_private": false,
                "privacy_service": null,
                "detected_patterns": []
                },
                "summary": {
                "has_registrant": true,
                "has_admin": true,
                "has_tech": true,
                "has_billing": false,
                "contact_count": 3,
                "is_privacy_protected": false
                },
                "raw_rdap_link": "https://rdap.verisign.com/com/v1/domain/example.com",
                "checked_at": "2025-01-07T10:30:00Z",
                "query_time_ms": 145
                }
POST /v1/whois/bulk 2/domain

Consulta WHOIS masiva para multiples dominios (max. 20 por solicitud).

Cuerpo de la solicitud

{
                "domains": ["example.com", "google.com", "github.com"]
                }

Campos de respuesta

Campo Tipo
results[] object[]
results[] object
results[].domain string
results[].registrar string | null
results[].created_date string | null
results[].updated_date string | null
results[].expiry_date string | null
results[].nameservers[] string[]
results[].status[] string[]
results[].raw string
results[].raw_whois string | null
results[].edge_summary object
results[].edge_summary.relay_configured boolean
results[].edge_summary.data_sources[] string[]
results[].edge_summary.authoritative_source string
results[].edge_summary.relay_whois_used boolean
results[].edge_summary.raw_whois_available boolean
results[].edge_summary.parse_error_count integer | null
results[].edge_summary.registered boolean | null
results[].edge_summary.available boolean | null
results[].edge_summary.registration_age_days integer | null
results[].edge_summary.days_until_expiry integer | null
results[].edge_summary.expires_within_30_days boolean | null
results[].edge_summary.transfer_locked boolean | null
results[].edge_summary.privacy_protected boolean | null
results[].edge_summary.dnssec boolean | null
results[].edge_summary.nameserver_count integer
results[].edge_summary.contact_roles_available[] string[]
results[].edge_summary.abuse_contact_available boolean
results[].edge_summary.registrar_whois_server string | null
meta object
meta.total integer
meta.successful integer
meta.duration_ms integer

Respuesta de ejemplo

{
  "results": [
    {
      "domain": "example.com",
      "registrar": "string",
      "created_date": "2026-04-15T12:00:00Z",
      "updated_date": "2026-04-15T12:00:00Z",
      "expiry_date": "2026-04-15T12:00:00Z",
      "nameservers": [
        "string"
      ],
      "status": [
        "string"
      ],
      "raw": "string",
      "raw_whois": "string",
      "edge_summary": {
        "relay_configured": true,
        "data_sources": [
          "rdap"
        ],
        "authoritative_source": "rdap",
        "relay_whois_used": true,
        "raw_whois_available": true,
        "parse_error_count": 1,
        "registered": true,
        "available": true,
        "registration_age_days": 1,
        "days_until_expiry": 1,
        "expires_within_30_days": true,
        "transfer_locked": true,
        "privacy_protected": true,
        "dnssec": true,
        "nameserver_count": 1,
        "contact_roles_available": [
          "string"
        ],
        "abuse_contact_available": true,
        "registrar_whois_server": "string"
      }
    }
  ],
  "meta": {
    "total": 1,
    "successful": 1,
    "duration_ms": 1
  }
}
GET /v1/rdap

Parámetros de consulta

Parámetro Tipo obligatorio
query string opcional
type string opcional
domain string opcional

Campos de respuesta

Campo Tipo
query string
type string
status string
rdap object
rdap.objectClassName string
rdap.handle string
rdap.name string
rdap.startAddress string
rdap.endAddress string
rdap.ipVersion string

Solicitud de ejemplo

curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/rdap?query=example.com"

curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/rdap?type=ip&query=8.8.8.8"

curl -G -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/rdap" \
  --data "type=ip" \
  --data-urlencode "query=2001:4860:4860::8888/128"

curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/rdap?type=autnum&query=AS174"

Respuesta de ejemplo

{
  "query": "8.8.8.8",
  "type": "ip",
  "status": "found",
  "rdap": {
    "objectClassName": "ip network",
    "handle": "NET-8-8-8-0-2",
    "name": "LVLT-GOGL-8-8-8",
    "startAddress": "8.8.8.0",
    "endAddress": "8.8.8.255",
    "ipVersion": "v4"
  }
}
POST /v1/rdap/bulk

Parámetros del cuerpo

Parámetro Tipo obligatorio
queries string[] obligatorio
type string opcional

Campos de respuesta

Campo Tipo
results[] unknown[]
meta object
meta.total integer
meta.succeeded integer
meta.failed integer
meta.max_items integer
meta.credits_per_item integer
meta.duration_ms integer

Solicitud de ejemplo

curl -X POST "https://domscan.net/v1/rdap/bulk" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $DOMSCAN_API_KEY" \
  -d '{
  "queries": [
    "example.com",
    "cloudflare.com"
  ],
  "type": "domain"
}'

Respuesta de ejemplo

{
  "results": [
    null
  ],
  "meta": {
    "total": 1,
    "succeeded": 1,
    "failed": 1,
    "max_items": 10,
    "credits_per_item": 1,
    "duration_ms": 1
  }
}
GET /v1/whois/history

Parámetros de consulta

Parámetro Tipo obligatorio
domain string obligatorio
limit integer opcional

Campos de respuesta

Campo Tipo
domain string
total_snapshots integer
first_seen string | null
last_seen string | null
snapshots[] object[]
snapshots[] object
snapshots[].id integer
snapshots[].domain string
snapshots[].registrar string | null
snapshots[].registrar_iana_id string | null
snapshots[].created_date string | null
snapshots[].expiry_date string | null
snapshots[].updated_date string | null
snapshots[].status[] string[]
snapshots[].nameservers[] string[]
snapshots[].dnssec boolean
snapshots[].transfer_locked boolean
snapshots[].privacy_protected boolean
snapshots[].snapshot_date string
snapshots[].changes_from_previous[] object[]
snapshots[].changes_from_previous[] object
snapshots[].changes_from_previous[].field string
snapshots[].changes_from_previous[].old_value string | null
snapshots[].changes_from_previous[].new_value string | null
snapshots[].created_at string
summary object
summary.registrar_changes integer
summary.nameserver_changes integer
summary.expiry_extensions integer
summary.privacy_toggles integer
summary.status_changes integer
lifecycle_drift_summary object
lifecycle_drift_summary.drift_detected boolean
lifecycle_drift_summary.change_event_count integer
lifecycle_drift_summary.latest_change_date string | null
lifecycle_drift_summary.registrar_changed boolean
lifecycle_drift_summary.nameservers_changed boolean
lifecycle_drift_summary.expiry_extended boolean
lifecycle_drift_summary.status_changed boolean
lifecycle_drift_summary.privacy_changed boolean
lifecycle_drift_summary.transfer_lock_changed boolean
lifecycle_drift_summary.dnssec_changed boolean
lifecycle_drift_summary.expiry_extension_days_total integer
lifecycle_drift_summary.latest_changes[] object[]
lifecycle_drift_summary.latest_changes[] object
lifecycle_drift_summary.latest_changes[].field string
lifecycle_drift_summary.latest_changes[].old_value string | null
lifecycle_drift_summary.latest_changes[].new_value string | null
lifecycle_drift_summary.current_snapshot object
lifecycle_drift_summary.current_snapshot.registrar string | null
lifecycle_drift_summary.current_snapshot.expiry_date string | null
lifecycle_drift_summary.current_snapshot.nameservers[] string[]
lifecycle_drift_summary.current_snapshot.status[] string[]
lifecycle_drift_summary.current_snapshot.privacy_protected boolean
lifecycle_drift_summary.previous_snapshot object
lifecycle_drift_summary.previous_snapshot.registrar string | null
lifecycle_drift_summary.previous_snapshot.expiry_date string | null
lifecycle_drift_summary.previous_snapshot.nameservers[] string[]
lifecycle_drift_summary.previous_snapshot.status[] string[]
lifecycle_drift_summary.previous_snapshot.privacy_protected boolean

Solicitud de ejemplo

curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/whois/history?domain=example.com&limit=50"

Respuesta de ejemplo

{
  "domain": "example.com",
  "total_snapshots": 1,
  "first_seen": "2026-07-09",
  "last_seen": "2026-07-09",
  "snapshots": [
    {
      "id": 42,
      "domain": "example.com",
      "registrar": "Example Registrar, Inc.",
      "registrar_iana_id": "9999",
      "created_date": "1995-08-14T04:00:00Z",
      "expiry_date": "2027-08-13T04:00:00Z",
      "updated_date": "2026-06-01T12:00:00Z",
      "status": [
        "client transfer prohibited"
      ],
      "nameservers": [
        "a.iana-servers.net",
        "b.iana-servers.net"
      ],
      "dnssec": true,
      "transfer_locked": true,
      "privacy_protected": true,
      "snapshot_date": "2026-07-09",
      "changes_from_previous": [
        {
          "field": "nameservers",
          "old_value": "ns1.example.net, ns2.example.net",
          "new_value": "a.iana-servers.net, b.iana-servers.net"
        }
      ],
      "created_at": "2026-07-09T10:15:30Z"
    }
  ],
  "summary": {
    "registrar_changes": 1,
    "nameserver_changes": 1,
    "expiry_extensions": 1,
    "privacy_toggles": 1,
    "status_changes": 1
  },
  "lifecycle_drift_summary": {
    "drift_detected": true,
    "change_event_count": 1,
    "latest_change_date": "2026-04-15",
    "registrar_changed": true,
    "nameservers_changed": true,
    "expiry_extended": true,
    "status_changed": true,
    "privacy_changed": true,
    "transfer_lock_changed": true,
    "dnssec_changed": true,
    "expiry_extension_days_total": 1,
    "latest_changes": [
      {
        "field": "string",
        "old_value": "string",
        "new_value": "string"
      }
    ],
    "current_snapshot": {
      "registrar": "string",
      "expiry_date": "2026-04-15T12:00:00Z",
      "nameservers": [
        "string"
      ],
      "status": [
        "string"
      ],
      "privacy_protected": true
    },
    "previous_snapshot": {
      "registrar": "string",
      "expiry_date": "2026-04-15T12:00:00Z",
      "nameservers": [
        "string"
      ],
      "status": [
        "string"
      ],
      "privacy_protected": true
    }
  }
}