Entwickler-Referenz

Reverse-IP-Lookup (veraltet)

Entdecken Sie die API-Dokumentation zu Reverse-IP-Lookup (veraltet), Anfrageparameter, Antwortfelder, Codebeispiele und Fehlerbehandlung für DomScan-Integrationen.

Reverse-IP-Lookup (veraltet)

Veraltet: Dieser Endpunkt sucht gültige IPv4- oder IPv6-Adressen nur in einem siebentägigen Best-Effort-Index, der durch frühere /v1/dns/all-Abfragen befüllt wird. Pro IP werden höchstens 10,000 der neuesten Einträge gespeichert. Die API wertet die mit limit angegebene Zahl von Einträgen aus, bevor standardmäßig eine Zeile pro Apex-Domain zurückgegeben wird. Dies ist kein internetweiter Datensatz.

GET /v1/reverse/ip

Abfrageparameter

ParameterTypBeschreibung
ip erforderlich string Gültige IPv4- oder IPv6-Adresse für den veralteten passiven DomScan-Index (z. B. "93.184.216.34" oder "2001:db8::1")
dedupe_apex optional boolean Bei true (Standard) wird eine Zeile pro Apex-Domain zurückgegeben. Mit false bleiben beobachtete Hostnamen erhalten.
limit optional number Höchstzahl der neuesten Indexeinträge, die vor der optionalen Apex-Deduplizierung ausgewertet werden. Standard: 100, Maximum: 1000.

Anwendungsfälle

  • Zwischengespeicherte DomScan-Beobachtungen für eine IP prüfen
  • Nur Kontext früherer API-Abfragen prüfen
  • Prüfen, ob DomScan zugehörige Domains bereits gesehen hat
  • Als begrenztes Altsignal verwenden, nicht als vollständigen Datensatz

Beispielanfrage

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

Beispielantwort

{
  "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"
  }
}

Antwort-Felder

Feld Typ
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