Referência da API

API de Cobertura de TLD

Lista os TLDs com mapeamentos RDAP e o estado de endpoints representativos. Esta não é uma lista completa dos TLDs que podem ser consultados; algumas consultas usam o WHOIS tradicional como alternativa. Use esta referência para escolher uma operação e integrar seu contrato de resposta documentado.

Operações

GET /v1/coverage Ver referência da API

GET /v1/coverage

Operação: getCoverage Créditos e autenticação: Grátis Autenticação opcional
GET /v1/coverage

Parâmetros de Consulta

Parâmetro Tipo obrigatório
live string
Valores permitidos 1
opcional

Campos de Resposta

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

Pedido de Exemplo

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

Resposta de Exemplo

{
  "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 referência