v1

latestOpenAPI 3.1.0Commercial License2026-07-132434129.1 KB
IP Geolocation & Security API

Get IP intelligence from client request

Automatically analyzes the client's IP address from HTTP request headers for comprehensive intelligence gathering.

IP Detection Strategy:

  1. X-Real-IP Header: Preferred for load balancers and reverse proxies
  2. X-Forwarded-For: First non-private IP in the chain
  3. RemoteAddr: Direct connection IP (fallback)

Analysis Includes:

  • Precise geolocation with city-level accuracy
  • Real-time timezone calculation with DST detection
  • Comprehensive security threat assessment
  • Network classification (residential, datacenter, mobile)
  • ISP and organization identification

Use Cases:

  • User session fraud detection
  • Content personalization by location
  • Timezone-aware application behavior
  • Real-time security monitoring

Privacy: No personal information is logged or stored

get/api/v1/ip

Response

IP intelligence gathered successfully with complete analysis

ipstring required

The IP address that was analyzed, returned in standard format.

Normalization Applied:

  • IPv4: Standard dotted decimal notation
  • IPv6: Compressed format when possible
  • Case normalization for IPv6

Note: Returned format may differ from input due to standardization

ispstring nullable

Internet Service Provider name derived from the ASN organization field.

asnstring nullable

Autonomous System Number in AS<number> format.

Example response

{
  "ip": "203.0.113.195",
  "isp": "Comcast Cable Communications",
  "asn": "AS7922",
  "suspicious_factors": {
    "is_proxy": false,
    "is_tor_node": false,
    "is_spam": false,
    "is_crawler": false,
    "is_datacenter": true,
    "is_vpn": false,
    "is_threat": false
  },
  "location": {
    "country": "United States",
    "country_code": "US",
    "city": "San Francisco",
    "latitude": 37.7749,
    "longitude": -122.4194,
    "zip": "94105",
    "timezone": "America/Los_Angeles",
    "local_time": "2023-06-21T14:30:00-07:00",
    "local_time_unix": 1687385400,
    "is_daylight_savings": true
  }
}