Referencia para desarrolladores

Búsqueda IP inversa (obsoleta)

Consulta la documentación de la API de Búsqueda IP 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 IP inversa (obsoleta)

Obsoleto: este endpoint solo busca direcciones IPv4 o IPv6 válidas en un índice de mejor esfuerzo de siete días, alimentado por consultas anteriores a /v1/dns/all. Cada IP 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/ip

Parámetros de consulta

Parámetro	Tipo	Descripción
ip obligatorio	string	Dirección IPv4 o IPv6 válida que se comprobará en el índice pasivo obsoleto de DomScan (por ejemplo, "93.184.216.34" o "2001:db8::1")
dedupe_apex 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 IP en caché de DomScan
Revisar solo contexto de búsquedas anteriores
Confirmar si DomScan vio dominios relacionados antes
Usarlo como señal heredada limitada, no como dataset completo

Solicitud de ejemplo

curl -H "X-API-Key: your-api-key" "https://domscan.net/v1/reverse/ip?ip=93.184.216.34&limit=50"

Respuesta de ejemplo

{
  "query": {
    "ip": "93.184.216.34",
    "asn": null,
    "expand": "none",
    "dedupe_apex": 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
  },
  "coverage_summary": {
    "source": "passive_dns",
    "cache_status": "passive_cache_only",
    "passive_index": true,
    "result_count": 0,
    "returned_count": 0,
    "apex_deduped_count": 0,
    "warning_count": 2,
    "warnings": ["passive_cache_only", "no_cached_matches"],
    "last_seen_span_days": null
  },
  "page": {
    "limit": 50,
    "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.ip`	string \| null
`query.asn`	integer \| null
`query.expand`	string
`query.dedupe_apex`	boolean
`deprecated`	boolean
`deprecation_notice`	string
`ip_context`	object
`ip_context.ip`	string
`ip_context.asn`	integer
`ip_context.asn_name`	string
`results[]`	object[]
`results[]`	object
`results[].domain`	string
`results[].apex`	string
`results[].ips[]`	string[]
`results[].last_seen`	string \| null
`results[].reason`	object
`results[].reason.type`	string
`results[].reason.matched`	string
`results[].reason.source`	string
`summary`	object
`summary.total_found`	integer
`summary.returned`	integer
`coverage_summary`	object
`coverage_summary.source`	string
`coverage_summary.cache_status`	string
`coverage_summary.passive_index`	boolean
`coverage_summary.result_count`	integer
`coverage_summary.returned_count`	integer
`coverage_summary.apex_deduped_count`	integer
`coverage_summary.warning_count`	integer
`coverage_summary.warnings[]`	string[]
`coverage_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