Referencia de API

API de Cobertura de TLD

Enumera los TLD con mapeos de RDAP y el estado de salud de endpoints representativos. No es una lista completa de los TLD que se pueden consultar; algunas consultas utilizan WHOIS tradicional como alternativa. Usa esta referencia para elegir una operación e integrar su contrato de respuesta documentado.

Operaciones

GET /v1/coverage Ver referencia de API

GET /v1/coverage

Operación: getCoverage Créditos y autenticación: Gratis Autenticación opcional
GET /v1/coverage

Parámetros de consulta

Parámetro Tipo obligatorio
live string
Valores permitidos 1
opcional

Campos de respuesta

Campo Tipo
gtlds[] string[]
cctlds[] string[]
total_tlds integer
all_tlds[] string[]
rdap_health[] object[]
rdap_health[] object
rdap_health[].tld string
rdap_health[].endpoint string
rdap_health[].measurement_status string
rdap_health[].ok boolean | null
rdap_health[].p50_ms number | null
rdap_health[].error_rate number | null
bootstrap_source string
bootstrap_last_updated string
meta object
meta.served_by string
meta.bootstrap_ttl_s integer
meta.live boolean

Solicitud de ejemplo

curl "https://domscan.net/v1/coverage?live=1"

Respuesta de ejemplo

{
  "gtlds": [
    "example"
  ],
  "cctlds": [
    "example"
  ],
  "total_tlds": 1,
  "all_tlds": [
    "com"
  ],
  "rdap_health": [
    {
      "tld": "com",
      "endpoint": "https://example.com",
      "measurement_status": "single_probe",
      "ok": true,
      "p50_ms": 1.5,
      "error_rate": 0
    }
  ],
  "bootstrap_source": "iana",
  "bootstrap_last_updated": "2026-08-27T12:00:00Z",
  "meta": {
    "served_by": "example",
    "bootstrap_ttl_s": 1,
    "live": false
  }
}

Recursos de referencia