Documentation

IP Detection API Documentation

Welcome to the IPScanner API documentation. Our API provides comprehensive IP detection including VPN detection, proxy detection, geolocation, ASN data, and WHOIS information.

Try it without a key

Run one lookup from your terminal before you sign up. The demo endpoint needs no key and no account.

Terminal

curl https://ipscanner.io/v1/demo/8.8.8.8

Response (trimmed)

{
  "target": { "raw": "8.8.8.8", "kind": "ip", "ip": "8.8.8.8" },
  "verdict": {
    "classification": "datacenter",
    "anonymized": false,
    "confidence": 0.94,
    "method": "range+asn"
  },
  "purity": { "score": 62, "grade": "C", "verdict": "datacenter" },
  "isVpn": false,
  "isProxy": false,
  "isTor": false,
  "provider": "GOOGLE",
  "riskScore": 60,
  "networkType": "hosting",
  "geo": {
    "country": "United States",
    "countryCode": "US",
    "city": "Mountain View",
    "latitude": 37.4056,
    "longitude": -122.0775,
    "timezone": "America/Los_Angeles"
  },
  "asn": {
    "asn": "AS15169",
    "name": "GOOGLE",
    "domain": "google.com",
    "route": "8.8.8.0/24",
    "type": "hosting"
  }
}

The demo endpoint answers about 100 requests a day per IP address. A free key gives you a quota of your own: 30,000 requests a month, with no daily cap, so you can spend them whenever you need them.

Get a free key

Base URL

All API requests should be made to the following base URL:

https://ipscanner.io/v1

API Endpoints

The following endpoints are available:

VPN Detection

/vpn/{ip}

Proxy Detection

/proxy/{ip}

Geolocation

/geo/{ip}

ASN Data

/asn/{ip}

WHOIS Info

/whois/{domain}