Ontwikkelaarsreferentie

Omgekeerde IP-lookup (verouderd)

Bekijk de API-documentatie voor Omgekeerde IP-lookup (verouderd), aanvraagparameters, responsvelden, codevoorbeelden en foutafhandeling voor DomScan-integraties.

Omgekeerde IP-lookup (verouderd)

Verouderd: dit endpoint zoekt alleen geldige IPv4- of IPv6-adressen in een zevendaagse best-effortindex die wordt opgebouwd uit eerdere /v1/dns/all-lookups. Per IP worden maximaal 10,000 recente vermeldingen bewaard. De API beoordeelt het door limit opgegeven aantal vermeldingen voordat standaard één rij per hoofddomein wordt teruggegeven. Dit is geen internetbrede dataset.

GET /v1/reverse/ip

Queryparameters

Parameter	Type	Beschrijving
ip vereist	string	Geldig IPv4- of IPv6-adres om te controleren in de verouderde passieve index van DomScan (bijvoorbeeld "93.184.216.34" of "2001:db8::1")
dedupe_apex optioneel	boolean	Als true (standaard) wordt één rij per hoofddomein teruggegeven. Stel false in om waargenomen hostnamen te behouden.
limit optioneel	number	Maximaal aantal recente indexvermeldingen dat vóór de optionele deduplicatie per hoofddomein wordt beoordeeld. Standaard: 100, maximaal: 1000.

Gebruikssituaties

Gecachte DomScan-waarnemingen voor een IP-adres controleren
Alleen de context van eerdere API-lookups beoordelen
Controleren of DomScan gerelateerde domeinen eerder heeft gezien
Gebruiken als beperkt verouderd signaal, niet als volledige gegevensset

Voorbeeldverzoek

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

Voorbeeldantwoord

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

Antwoordvelden

Veld	Type
`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