Referencia para Desarrolladores

Perfil de dominio Documentación API

Perfil de dominio Documentación API: Obtiene datos de registro RDAP normalizados incluyendo registrador, fecha de creación, expiración, servidores de nombres, estado DNSSEC y resumen de contactos. Incluye la antigüedad del dominio y los días hasta la expiración precalculados para mayor comodidad.

Perfil de dominio

Obtiene datos de registro RDAP normalizados incluyendo registrador, fecha de creación, expiración, servidores de nombres, estado DNSSEC y resumen de contactos. Incluye la antigüedad del dominio y los días hasta la expiración precalculados para mayor comodidad.

GET /v1/profile

Parámetros de consulta

Parámetro	Tipo	Descripción
domain obligatorio	string	Nombre de dominio completo (ej., github.com)

Campos de respuesta

Campo	Tipo	Descripción
`age_days`	number	Antiguedad del dominio en dias desde el registro
`days_until_expiry`	number	Dias hasta que expire el dominio
`dnssec`	boolean	Si DNSSEC esta habilitado
`status`	array	Codigos de estado EPP (clientDeleteProhibited, etc.)

Solicitud de ejemplo

curl "https://domscan.net/v1/profile?domain=github.com"

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

console.log(`Domain age: ${data.age_days} days`);
console.log(`Expires in: ${data.days_until_expiry} days`);
console.log(`DNSSEC: ${data.dnssec ? 'Enabled' : 'Disabled'}`);

import requests

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

print(f"Domain age: {data['age_days']} days ({data['age_days'] // 365} years)")
print(f"Expires in: {data['days_until_expiry']} days")

Respuesta de ejemplo

{
  "domain": "github.com",
  "registered": true,
  "registrar": "MarkMonitor Inc.",
  "registrar_url": "https://www.markmonitor.com",
  "created_date": "2007-10-09T18:20:50Z",
  "updated_date": "2024-09-08T09:19:27Z",
  "expiry_date": "2026-10-09T07:00:00Z",
  "age_days": 6310,
  "days_until_expiry": 628,
  "nameservers": ["dns1.p08.nsone.net", "dns2.p08.nsone.net"],
  "dnssec": true,
  "status": ["clientDeleteProhibited", "clientTransferProhibited"],
  "contacts": {
    "registrant_name": "GitHub, Inc.",
    "registrant_org": "GitHub, Inc.",
    "registrant_country": "US"
  },
  "privacy": {
    "is_private": false,
    "privacy_service": null
  }
}

GET /v1/overview

Parámetros de consulta

Parámetro	Tipo	obligatorio
domain	string	obligatorio

Campos de respuesta

Campo	Tipo
`domain`	string
`health`	object
`health.dns_ok`	boolean
`health.https_ok`	boolean
`dns`	object
`dns.has_a`	boolean
`dns.has_aaaa`	boolean
`dns.has_mx`	boolean
`dns.nameservers[]`	string[]
`registration`	object
`registration.registered`	boolean
`registration.registrar`	string \| null
`registration.created_date`	string \| null
`registration.expiry_date`	string \| null
`registration.age_days`	integer \| null
`registration.days_until_expiry`	integer \| null
`registration.dnssec`	boolean
`reputation`	object
`reputation.score`	number \| null
`reputation.grade`	string \| null
`query_time_ms`	integer
`checked_at`	string

Solicitud de ejemplo

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

Respuesta de ejemplo

{
  "domain": "example.com",
  "health": {
    "dns_ok": true,
    "https_ok": true
  },
  "dns": {
    "has_a": true,
    "has_aaaa": true,
    "has_mx": true,
    "nameservers": [
      "string"
    ]
  },
  "registration": {
    "registered": true,
    "registrar": "string",
    "created_date": "2026-04-15",
    "expiry_date": "2026-04-15",
    "age_days": 1,
    "days_until_expiry": 1,
    "dnssec": true
  },
  "reputation": {
    "score": 1,
    "grade": "string"
  },
  "query_time_ms": "2026-04-15T12:00:00Z",
  "checked_at": "2026-04-15T12:00:00Z"
}