Referencia para desarrolladores

Búsqueda MX inversa (obsoleta)

Consulta la documentación de la API de Búsqueda MX inversa (obsoleta), con parámetros de solicitud, campos de respuesta, ejemplos de código y gestión de errores para integraciones con DomScan.

Búsqueda MX inversa (obsoleta)

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.

GET /v1/reverse/mx

Parámetros de consulta

Parámetro	Tipo	Descripción
mx obligatorio	string	Nombre de host exacto del servidor de correo que se comprobará en la caché pasiva obsoleta de DomScan (alias: mailserver; por ejemplo, "aspmx.l.google.com")
match opcional	string	Modo de coincidencia. Solo se admite exact.
include_apex_only opcional	boolean	Cuando es true (valor predeterminado), devuelve una fila por dominio raíz. Usa false para conservar los nombres de host observados.
limit opcional	number	Número máximo de entradas recientes del índice que se evaluarán antes de la deduplicación opcional por dominio raíz. Valor predeterminado: 100; máximo: 1000.

Casos de uso

Consultar observaciones MX en caché de DomScan
Revisar contexto previo de infraestructura de correo
Confirmar si DomScan vio dominios coincidentes antes
Usarlo como señal heredada limitada, no como dataset completo

Solicitud de ejemplo

# Deprecated limited cache lookup for prior DomScan DNS observations
curl -H "X-API-Key: your-api-key" "https://domscan.net/v1/reverse/mx?mx=aspmx.l.google.com&limit=100"

# Deprecated limited cache lookup for another MX hostname
curl -H "X-API-Key: your-api-key" "https://domscan.net/v1/reverse/mx?mx=outlook.protection.outlook.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,
    "warnings": ["passive_cache_only", "no_cached_matches"]
  },
  "page": {
    "limit": 100,
    "next_cursor": null
  },
  "meta": {
    "source": "passive_dns",
    "note": "Best-effort seven-day index populated only by prior /v1/dns/all lookups"
  }
}

Campos de respuesta

Campo	Tipo
`query`	object
`query.mx`	string
`query.match`	string
`query.include_apex_only`	boolean
`deprecated`	boolean
`deprecation_notice`	string
`results[]`	object[]
`results[]`	object
`results[].domain`	string
`results[].apex`	string
`results[].mx`	string
`results[].all_mx[]`	object[]
`results[].all_mx[]`	object
`results[].all_mx[].host`	string
`results[].all_mx[].priority`	integer \| null
`results[].last_seen`	string \| null
`results[].reason`	object
`results[].reason.type`	string
`results[].reason.matched`	string
`summary`	object
`summary.total_found`	integer
`summary.returned`	integer
`freshness_summary`	object
`freshness_summary.source`	string
`freshness_summary.cache_status`	string
`freshness_summary.result_count`	integer
`freshness_summary.returned_count`	integer
`freshness_summary.apex_domain_count`	integer
`freshness_summary.apex_deduped_count`	integer
`freshness_summary.warning_count`	integer
`freshness_summary.warnings[]`	string[]
`freshness_summary.last_seen_span_days`	integer \| null
`page`	object
`page.limit`	integer
`page.next_cursor`	string \| null
`meta`	object
`meta.generated_at`	string
`meta.source`	string
`meta.query_time_ms`	integer
`meta.note`	string
`cache`	object
`cache.hit`	boolean \| null
`cache.age_s`	integer \| null
`cache.ttl_s`	integer \| null
`cache.key`	string \| null