Referencia para desarrolladores

Historial de DNS

Consulta la documentación de la API de Historial de DNS, con parámetros de solicitud, campos de respuesta, ejemplos de código y gestión de errores para integraciones con DomScan.

Historial de DNS

Consulta valores DNS, con precisión de día, observados en consultas anteriores de DomScan que se completaron correctamente. Esta cobertura beta no es un archivo de DNS pasivo de todo Internet.

GET /v1/dns/history

Parámetros de consulta

Parámetro	Tipo	obligatorio
domain	string	obligatorio
type	string	opcional
from	string	opcional
to	string	opcional
limit	integer	opcional

Campos de respuesta

Campo	Tipo
`domain`	string
`history[]`	object[]
`history[]`	object
`history[].date`	string
`history[].record_type`	string
`history[].changes[]`	object[]
`history[].changes[]`	object
`history[].changes[].action`	string
`history[].changes[].value`	string
`history[].changes[].ttl`	integer \| null
`current_records`	object
`first_seen`	string \| null
`last_seen`	string \| null
`total_changes`	integer
`record_types_tracked[]`	string[]
`beta_notice`	string
`meta`	object
`meta.note`	string
`meta.data_source`	string
`meta.history_limit`	integer
`meta.history_rows_evaluated`	integer
`meta.history_rows_truncated`	boolean
`meta.current_records_scope`	string

Solicitud de ejemplo

curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/dns/history?domain=example.com&type=A&from=2026-01-01&to=2026-04-15&limit=10"

Respuesta de ejemplo

{
  "domain": "example.com",
  "history": [
    {
      "date": "2026-04-13",
      "record_type": "A",
      "changes": [
        {
          "action": "added",
          "value": "104.20.23.154"
        },
        {
          "action": "added",
          "value": "172.66.147.243"
        },
        {
          "action": "removed",
          "value": "104.18.26.120"
        }
      ]
    }
  ],
  "current_records": {
    "A": [
      "104.20.23.154",
      "172.66.147.243"
    ]
  },
  "first_seen": "2026-01-01",
  "last_seen": "2026-04-13",
  "total_changes": 3,
  "record_types_tracked": [
    "A"
  ],
  "beta_notice": "Beta observation log. Coverage comes only from successful DomScan DNS lookups. Dates are day-level, changes between lookups can be missed, and no external passive DNS sources are included.",
  "meta": {
    "note": "Lookup-driven DomScan observations only. Dates are day-level, gaps can miss changes, and no external passive DNS sources are included.",
    "data_source": "internal",
    "history_limit": 100,
    "history_rows_evaluated": 3,
    "history_rows_truncated": false,
    "current_records_scope": "all_stored_current_records"
  }
}