Consulta el estado del servicio en directo y las respuestas de error documentadas antes de integrar la API.
Señales de confianza antes de integrar
Documentación transparente, solicitudes autenticadas y detalles visibles de fiabilidad facilitan evaluar DomScan antes de publicar.
OpenAPI, Swagger, Postman, CLI, SDK y enlaces MCP están a un clic.
Los endpoints autenticados usan claves API con costes de créditos claros antes de llamarlos.
Empieza con 10.000 créditos mensuales y actualiza solo cuando crezca el uso.
Qué te ayuda a lanzar esta API
Usa esta página como un resumen de producción: endpoints, ejemplos, forma de respuesta y piezas de flujo necesarias para integrar DomScan en tu producto.
Integra comprobaciones de dominios, inteligencia DNS, señales de riesgo o enriquecimiento en onboarding, búsqueda y herramientas internas.
Sustituye consultas manuales repetidas por tareas programadas, alertas y pasos de investigación reproducibles.
Usa campos previsibles, códigos de estado documentados y costes de créditos en lugar de raspar páginas de proveedores.
Alimenta agentes, paneles, playbooks SOAR y CRMs mediante OpenAPI, SDK, Postman o MCP.
Flujo de integración
Un camino simple desde la primera solicitud hasta un uso repetible en producción.
Envía tu clave API con la cabecera documentada y mantén solicitudes coherentes entre servicios.
Empieza con las muestras curl y HTTP, y luego mapea los parámetros en el código de tu aplicación.
Usa códigos de estado, costes de créditos y campos de respuesta para crear reintentos, logs y alertas.
Kit para desarrolladores
Salta desde esta página a documentación legible por máquinas, colecciones de solicitudes, SDKs o herramientas para agentes.
Genera clientes o inspecciona cada forma de solicitud y respuesta.
Colección PostmanImporta solicitudes listas para pruebas manuales y traspaso al equipo.
SDKs y CLIUsa paquetes mantenidos y flujos de línea de comandos en vez de escribir boilerplate.
Integración MCPExpón inteligencia de dominios a agentes de IA y asistentes internos.
Mapa de parámetros y respuesta
Revisa entradas, campos de salida y códigos de estado antes de conectar el endpoint a tu cliente.
Parámetro
Respuesta de ejemplo
Códigos de estado HTTP
Endpoints
/v1/reverse/mx
Señales de confianza antes de integrar
Documentación transparente, solicitudes autenticadas y detalles visibles de fiabilidad facilitan evaluar DomScan antes de publicar.
OpenAPI, Swagger, Postman, CLI, SDK y enlaces MCP están a un clic.
Los endpoints autenticados usan claves API con costes de créditos claros antes de llamarlos.
Empieza con 10.000 créditos mensuales y actualiza solo cuando crezca el uso.
Empieza con las muestras curl y HTTP, y luego mapea los parámetros en el código de tu aplicación.
Características principales
Devuelve solo las entradas más recientes indicadas por limit del índice por host de mejor esfuerzo, alimentado por consultas /v1/dns/all, con deduplicación por dominio raíz activada de forma predeterminada.
Este endpoint no rastrea DNS, archivos de zona ni un corpus completo de DNS pasivo.
Use los resultados como contexto opcional, no como evidencia completa.
Devuelve solo las entradas más recientes indicadas por limit del índice por host de mejor esfuerzo, alimentado por consultas /v1/dns/all, con deduplicación por dominio raíz activada de forma predeterminada.
Este endpoint no rastrea DNS, archivos de zona ni un corpus completo de DNS pasivo.
Use los resultados como contexto opcional, no como evidencia completa.
Devuelve solo las entradas más recientes indicadas por limit del índice por host de mejor esfuerzo, alimentado por consultas /v1/dns/all, con deduplicación por dominio raíz activada de forma predeterminada.
Use los resultados como contexto opcional, no como evidencia completa.
Solicitud de ejemplo
curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/reverse/mx?mx=aspmx.l.google.com"
Respuesta de ejemplo
{
"query": {
"mx": "aspmx.l.google.com",
"match": "exact",
"include_apex_only": true
},
"deprecated": true,
"deprecation_notice": "This endpoint is deprecated. It only searches a best-effort seven-day passive index populated by prior /v1/dns/all lookups and capped at 10,000 recent entries per key. It is not an internet-wide reverse DNS dataset.",
"results": [],
"summary": {
"total_found": 0,
"returned": 0
},
"freshness_summary": {
"source": "passive_dns",
"cache_status": "passive_cache_only",
"result_count": 0,
"returned_count": 0,
"apex_domain_count": 0,
"apex_deduped_count": 0,
"warning_count": 2,
"warnings": ["passive_cache_only", "no_cached_matches"],
"last_seen_span_days": null
},
"page": {
"limit": 100,
"next_cursor": null
},
"meta": {
"source": "passive_dns",
"note": "Best-effort seven-day index populated only by prior /v1/dns/all lookups"
},
"cache": {
"hit": null,
"age_s": null,
"ttl_s": null,
"key": null
}
}
Preguntas frecuentes
Los registros MX (Mail Exchanger) especifican que servidores de correo reciben correo electronico para un dominio. Incluyen un valor de prioridad y el nombre de host del servidor.
Obsoleto: este endpoint solo busca nombres de host exactos en un índice de mejor esfuerzo de siete días, alimentado por consultas anteriores a /v1/dns/all. Cada host MX conserva como máximo 10,000 entradas recientes. La API evalúa las entradas indicadas por limit antes de devolver, de forma predeterminada, una fila por dominio raíz. No es un conjunto de datos de todo Internet.
Use los resultados como contexto opcional, no como evidencia completa.
El índice de mejor esfuerzo se alimenta únicamente con consultas /v1/dns/all, conserva las observaciones durante siete días y limita cada host MX a 10,000 entradas recientes. Las escrituras ausentes o fallidas pueden crear huecos.
Herramientas y Recursos Relacionados
Códigos de estado HTTP
Documentamos los códigos de estado HTTP que debes gestionar para distinguir respuestas correctas, problemas de autenticación o créditos, límites de frecuencia, datos inexistentes y fallos del servicio de origen.
Solicitud correcta
Parámetros no válidos
Clave de API o sesión ausente o no válida.
No tienes créditos suficientes para ejecutar esta solicitud.
Límite de frecuencia superado
Error interno
Error del servicio RDAP de origen
El servicio ascendente no está disponible o está limitando temporalmente.
La consulta al servicio de origen agotó el tiempo de espera.
Ver MX inversa obsoleta