API Documentation

The NexGeo API provides precise geolocation, timezone, ASN, and security intelligence data for any IP address. Built for speed and accuracy with global edge deployment.

Authenticate your API requests by including your API key in the X-API-Key header of every request. You can find your API key in the dashboard.

curl -H "X-API-Key: your_api_key_here" \
     "https://api.nexgeo.dev/v1/geolocation?ip=8.8.8.8"

Look up the geographic location of an IP address. Returns country, region, city, coordinates, and more.

Parameters

Response

{
  "ip": "8.8.8.8",
  "type": "ipv4",
  "country": {
    "code": "US",
    "name": "United States"
  },
  "region": {
    "code": "CA",
    "name": "California"
  },
  "city": "Mountain View",
  "postal_code": "94035",
  "latitude": 37.386,
  "longitude": -122.0838,
  "accuracy_radius": 1000
}

Get timezone information for an IP address, including the IANA timezone identifier, UTC offset, and current local time.

Parameters

Response

{
  "ip": "8.8.8.8",
  "timezone": {
    "id": "America/Los_Angeles",
    "abbreviation": "PST",
    "utc_offset": "-08:00",
    "current_time": "2026-02-21T08:30:00-08:00",
    "is_dst": false
  }
}

Retrieve Autonomous System Number (ASN) information for an IP address, including the organization name and network range.

Parameters

Response

{
  "ip": "8.8.8.8",
  "asn": {
    "number": 15169,
    "name": "GOOGLE",
    "organization": "Google LLC",
    "network": "8.8.8.0/24",
    "type": "hosting"
  }
}

Get security intelligence for an IP address, including VPN, proxy, and Tor detection, threat classification, and abuse scoring.

Parameters

Response

{
  "ip": "198.51.100.1",
  "security": {
    "is_vpn": true,
    "is_proxy": false,
    "is_tor": false,
    "is_datacenter": true,
    "threat_score": 72,
    "threat_classification": "medium",
    "last_reported": "2026-02-18T14:30:00Z"
  }
}

Look up multiple IP addresses in a single request. Supports up to 100 IPs per request. Results are returned in the same order as the input.

Request Body

Request Example

curl -X POST \
     -H "X-API-Key: your_api_key_here" \
     -H "Content-Type: application/json" \
     -d '{"ips": ["8.8.8.8", "1.1.1.1", "208.67.222.222"]}' \
     "https://api.nexgeo.dev/v1/bulk"

Response

{
  "results": [
    {
      "ip": "8.8.8.8",
      "country": { "code": "US", "name": "United States" },
      "city": "Mountain View"
    },
    {
      "ip": "1.1.1.1",
      "country": { "code": "AU", "name": "Australia" },
      "city": "Sydney"
    },
    {
      "ip": "208.67.222.222",
      "country": { "code": "US", "name": "United States" },
      "city": "San Francisco"
    }
  ],
  "count": 3
}

All API responses are returned in JSON format with UTF-8 encoding. Successful responses return HTTP 200 with the data directly in the response body. Error responses include a structured error object.

{
  "error": {
    "code": 429,
    "type": "rate_limit_exceeded",
    "message": "Rate limit exceeded. Please retry after 1 second."
  }
}

Response Headers

Rate limits are enforced per API key using a sliding window algorithm. When you exceed the rate limit, the API returns a 429 Too Many Requests response with a Retry-After header.

The API uses standard HTTP status codes to indicate the success or failure of a request. Codes in the 2xx range indicate success, 4xx indicate client errors, and 5xx indicate server errors.

Official client libraries to integrate NexGeo into your application in minutes. All SDKs are open source and available on GitHub.

import { NexGeo } from '@nexgeo/node';

const client = new NexGeo('your_api_key');
const data = await client.geolocation('8.8.8.8');

from nexgeo import NexGeo

client = NexGeo("your_api_key")
data = client.geolocation("8.8.8.8")

client := nexgeo.NewClient("your_api_key")
data, err := client.Geolocation(ctx, "8.8.8.8")

curl -H "X-API-Key: your_key" \
  "https://api.nexgeo.dev/v1/geolocation?ip=8.8.8.8"