Developer Reference

IP Geolocation API Documentation

IP Geolocation API Documentation: Comprehensive IP intelligence including geolocation, ASN/network info, and security signals. Supports both direct IP lookups and domain resolution. Enriched with Tor exit node detection, cloud provider identification, and datacenter detection for fraud prevention and security analysis.

IP Geolocation

Comprehensive IP intelligence including geolocation, ASN/network info, and security signals. Supports both direct IP lookups and domain resolution. Enriched with Tor exit node detection, cloud provider identification, and datacenter detection for fraud prevention and security analysis.

GET /v1/ip

Query Parameters

Parameter	Type	required
ip	string	optional
domain	string	optional

Response Fields

Field	Type
`ip`	string
`domain`	string \| null
`geolocation`	object
`geolocation.country`	string
`geolocation.country_name`	string
`geolocation.region`	string
`geolocation.region_name`	string
`geolocation.city`	string
`geolocation.postal`	string \| null
`geolocation.latitude`	number
`geolocation.longitude`	number
`geolocation.timezone`	string
`network`	object
`network.asn`	integer \| null
`network.asn_name`	string \| null
`network.asn_org`	string \| null
`network.isp`	string \| null
`network.connection_type`	string \| null
`security`	object
`security.is_proxy`	boolean
`security.is_vpn`	boolean
`security.is_tor`	boolean
`security.is_tor_exit`	boolean
`security.is_datacenter`	boolean
`security.is_cloud`	boolean
`security.cloud_provider`	string \| null
`security.threat_score`	integer
`security.is_vpn_suspected`	boolean
`security.vpn_suspected_provider`	string \| null
`security.type_classification`	object
`security.type_classification.type`	string
`security.type_classification.confidence`	string
`security.fcrdns`	object
`security.fcrdns.ptr`	string \| null
`security.fcrdns.fcrdns_valid`	boolean \| null
`meta`	object
`meta.query_time_ms`	integer
`meta.cached`	boolean
`meta.source`	string

Example Request

curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/ip?ip=8.8.8.8&domain=openai.com"

Example Response

{
  "ip": "8.8.8.8",
  "domain": null,
  "geolocation": {
    "country": "US",
    "country_name": "United States",
    "region": "CA",
    "region_name": "California",
    "city": "Mountain View",
    "postal": "94035",
    "latitude": 37.386,
    "longitude": -122.0838,
    "timezone": "America/Los_Angeles"
  },
  "network": {
    "asn": 15169,
    "asn_name": "AS15169",
    "asn_org": "Google LLC",
    "isp": "Google LLC",
    "connection_type": "hosting"
  },
  "security": {
    "is_proxy": false,
    "is_vpn": false,
    "is_tor": false,
    "is_tor_exit": false,
    "is_datacenter": true,
    "is_cloud": true,
    "cloud_provider": "Google Cloud",
    "threat_score": 0,
    "type_classification": {
      "type": "datacenter",
      "confidence": "high"
    },
    "fcrdns": {
      "ptr": "dns.google",
      "fcrdns_valid": true
    }
  },
  "meta": {
    "query_time_ms": 118,
    "cached": false,
    "source": "ip-api.com+enrichment"
  }
}