Référence Développeur

Recherche IP inversée (obsolète)

Consultez la documentation de l'API Recherche IP inversée (obsolète), ses paramètres de requête, les champs de réponse, les exemples de code et la gestion des erreurs pour les intégrations DomScan.

Recherche IP inversée (obsolète)

Obsolète : cet endpoint recherche uniquement les adresses IPv4 ou IPv6 valides dans un index de sept jours à couverture non garantie, alimenté par de précédentes recherches /v1/dns/all. Chaque IP conserve au maximum 10,000 entrées récentes. L’API évalue le nombre d’entrées indiqué par limit avant de renvoyer, par défaut, une ligne par domaine apex. Ce jeu de données ne couvre pas tout Internet.

GET /v1/reverse/ip

Paramètres de Requête

Paramètre	Type	Description
ip requis	string	Adresse IPv4 ou IPv6 valide à vérifier dans l’index passif DomScan obsolète (par exemple, "93.184.216.34" ou "2001:db8::1")
dedupe_apex optionnel	boolean	Avec true (valeur par défaut), une ligne est renvoyée par domaine apex. Utilisez false pour conserver les noms d’hôte observés.
limit optionnel	number	Nombre maximal d’entrées récentes de l’index à évaluer avant la déduplication facultative par domaine apex. Par défaut : 100 ; maximum : 1000.

Cas d'utilisation

Vérifier les observations IP en cache de DomScan
Examiner uniquement le contexte des anciennes requêtes API
Confirmer si DomScan a déjà vu des domaines liés
Utiliser comme signal hérité limité, pas comme jeu complet

Exemple de Requête

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

Exemple de Réponse

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

Champs de Réponse

Champ	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