Referencia para desarrolladores

Créditos y precios

API de DomScan: DomScan incluye 10.000 créditos gratuitos al mes. Sin tarjeta de crédito requerida. Empieza en segundos.

Créditos y precios

DomScan incluye 10.000 créditos gratuitos al mes. Sin tarjeta de crédito requerida. Empieza en segundos.

Los créditos se renuevan mensualmente en el aniversario de registro. ¿Necesitas más créditos? Compra paquetes que nunca expiran:

Créditos por endpoint

Consulta a continuación los costes de los endpoints más habituales. Algunos endpoints de referencia son gratuitos. Para ver la tabla de tarifas completa y legible por máquina, utiliza /v1/pricing.

EndpointCréditosDescripción
/v1/coverage 0 Listar TLD con mapeos de RDAP
/v1/tlds 0 Lista de metadatos de TLD
/v1/watchlist 1 Ver tu lista de vigilancia
/v1/webhooks 2 Por cada alerta entregada a tu endpoint de webhook. Las entregas fallidas se reembolsan y los eventos de prueba son gratuitos.
/v1/status 1 Comprobar disponibilidad de dominio
/v1/health/quick 1 Comprobación rápida de estado
/v1/dns 1 Búsqueda DNS
/v1/dns/bulk 1/domain Búsqueda DNS masiva (hasta 25 dominios)
/v1/ip 1 Geolocalización de IP
/v1/value 2 Valoración de dominio
/v1/prices 0-1/pair Precios de registro
/v1/tlds/:tld 1 Detalles de TLD
/v1/watchlist/check 1 Comprobar elemento de lista de vigilancia
/v1/typos/permutations 1 Permutaciones de typos
/v1/typos/score 1 Puntuación de riesgo de typo
/v1/email/check 1 Comprobación de lista negra de correo electrónico
/v1/status/bulk 1/domain Comprueba disponibilidad para múltiples nombres de dominio de una vez. Soporta hasta 50 dominios por solicitud.
/v1/health 3 Comprobación de estado completa
/v1/dns/all 2 Todos los registros DNS
/v1/profile 3 Perfil de dominio
/v1/redirects 2 Cadena de redireccionamiento
/v1/tech 3-9 Detección de pila de tecnología
/v1/categorize 3 Categorización de sitios web
/v1/similarity 2 Similitud de dominios
/v1/typos 2-3 Detección de typosquatting
/v1/reputation 3 Reputación de dominio
/v1/reputation/bulk 3/domain Reputación de dominios en lote (hasta 3 dominios)
/v1/certificates 2 Certificado SSL
/v1/certificates/bulk 2/domain Certificado SSL
/v1/social 2 Comprobación de perfil en redes sociales
/v1/social/bulk 2/handle Comprobación masiva de nombres de usuario en redes sociales
/v1/company 3 Búsqueda de empresa
/v1/suggest 2-5 Sugerencias de dominio
/v1/whois 3 Búsqueda WHOIS
/v1/whois/history 3 Historial de cambios WHOIS
/v1/whois/bulk 3/domain Consulta WHOIS masiva (hasta 20 dominios)
/v1/rdap/bulk 2/query Búsqueda WHOIS
/v1/prices/bulk 1/pair Precios en lotes
/v1/dns/security 3 Análisis de seguridad DNS
/v1/dns/propagation 2 Comparación de servidores DNS recursivos
/v1/dns/propagation/bulk 2/domain Comparación de servidores DNS recursivos
/v1/email-auth/bulk 3/domain Autenticación de correo electrónico
/v1/hosting/bulk 3/domain Detección de alojamiento
/v1/value/bulk 2/domain Valoración en lotes
/v1/health/bulk 3/domain Comprobación de estado en lotes
/v1/subdomains 4-5 Buscador de subdominios
/v1/subdomains/bulk 4-5/domain Buscador de subdominios
/v1/report 5 Informe completo (ahorra ~10 créditos frente a llamadas individuales)

Aplicación de créditos

Cuando sus créditos llegan a cero, las solicitudes de API que cuestan créditos devuelven HTTP 402 (pago requerido). Las herramientas gratuitas basadas en navegador no se ven afectadas.

HTTP 402 Payment Required
{
  "error": {
    "code": "INSUFFICIENT_CREDITS",
    "message": "Insufficient credits. This endpoint costs 2 credits but you have 0.",
    "credits_remaining": 0,
    "credits_required": 2,
    "purchase_url": "https://domscan.net/billing"
  }
}

¿Necesitas más créditos? Compra paquetes que nunca expiran:

Los créditos se renuevan mensualmente en el aniversario de registro.

Cabeceras de respuesta de créditos

Todas las respuestas API autenticadas incluyen un encabezado X-Credits-Remaining que muestra su saldo de crédito actual después de la solicitud.

X-Credits-Remaining: 9500

Todas las respuestas /v1 autenticadas, incluidos los errores, incluyen estas cabeceras:

  • X-Credits-Charged: créditos que cobró esta solicitud, una vez descontado cualquier reembolso hecho en la misma solicitud (0 cuando no se cobró nada).
  • X-Credits-Remaining: tu saldo después de la solicitud. Se omite en el raro caso de que el saldo no se conozca ya.
  • X-RateLimit-Limit, X-RateLimit-Remaining y X-RateLimit-Reset: tu capacidad de ráfaga, las solicitudes que aún puedes enviar de inmediato y la hora Unix en segundos en que la capacidad se recupera por completo.
  • MCP sobre HTTP devuelve X-Credits-Charged y X-Credits-Remaining para las llamadas a herramientas de cada solicitud.

Estima el coste antes de ejecutar

Envía el método, la ruta, la consulta y el cuerpo de una solicitud a POST /v1/estimate para obtener los créditos que cobraría, con desglose y notas. No se ejecuta nada y la estimación cuesta 0 créditos. Cuando el cargo final depende del resultado, la estimación es el máximo y una nota explica el motivo.

POST /v1/estimate

Cuerpo de la solicitud

ParámetroTipoDescripción
method obligatorio string
Valores permitidos GETPOSTPUTPATCHDELETE
Método HTTP de la solicitud que se va a estimar.
path obligatorio string Ruta de la solicitud que se va a estimar, por ejemplo /v1/value/bulk. También se lee una cadena de consulta incluida en la ruta.
query opcional object Parámetros de consulta como objeto. Los arrays se unen con comas.
body opcional any Cuerpo JSON que enviaría la solicitud.

Solicitud de ejemplo

curl -X POST "https://domscan.net/v1/estimate" \
  -H "X-API-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{"method":"POST","path":"/v1/value/bulk","body":{"domains":["example.com","example.org"]}}'

Respuesta de ejemplo

{
  "credits": 2,
  "breakdown": [
    { "component": "domains", "quantity": 2, "unit_credits": 1, "credits": 2 }
  ],
  "notes": ["Las solicitudes rechazadas con un estado 4xx o que fallan con un estado 5xx se reembolsan automáticamente."],
  "maximum": false,
  "rejected": false
}

Campos de respuesta

Campo Tipo
credits integer
breakdown[] object[]
breakdown[] object
breakdown[].component string
breakdown[].quantity integer
breakdown[].unit_credits number
breakdown[].credits integer
notes[] string[]
maximum boolean
rejected boolean
billing_model string
endpoint object
endpoint.method string
endpoint.path string
dry_run boolean

Los endpoints de bulk, compare, recipe y pricing también aceptan dry_run=true. La solicitud se responde con HTTP 200 y la misma estimación más "dry_run": true, sin ejecutarla ni cobrar créditos.

Calculadora de créditos

Estima tu uso de créditos para operaciones en lotes:

Créditos totales necesarios
100
Eso representa el 1.0% de tus créditos mensuales gratuitos

Paquetes de créditos

¿Necesitas más créditos? Compra paquetes que nunca expiran:

PaquetePrecioPor crédito
50,000 créditos €9 / £7.50 / ¥1,500 €0.00018
250,000 créditos €29 / £24 / ¥4,800 €0.000116
1,000,000 créditos €79 / £66 / ¥13,000 €0.000079