IP Geolocation
Get comprehensive geographic location data from IP addresses. Returns country, region, city, timezone, ISP, connection type, and coordinates. Supports both IPv4 and IPv6 with bulk lookup capabilities, IP validation, and distance calculations.
IP Geolocation endpoints
| Method | Endpoint | Description |
|---|---|---|
| health | ||
| GET |
healthCheck /health |
Check API availability and service status. This endpoint does not require authentication. |
| v1 | ||
| POST |
post_v1_bulk /v1/bulk |
Lookup geolocation data for multiple IP addresses in a single request. Maximum 100 IPs per request. PRO tier or higher required. |
| GET |
get_v1_validate /v1/validate |
Validate an IP address and get type information (IPv4/IPv6). Does not perform geolocation lookup. |
| GET |
get_v1_distance /v1/distance |
Calculate the great-circle distance in kilometers between two geographic coordinate pairs using the Haversine formula. |
| GET |
get_v1_info /v1/info |
Get detailed IP type information including version (IPv4/IPv6), whether it's private/public, and other technical details. |
| GET |
get_v1_me /v1/me |
Get geolocation data for the requesting client's IP address. Automatically detects and analyzes your public IP. |
| GET |
get_v1_lookup_path /v1/lookup/{ip} |
Get geolocation data for a specific IP address using path parameter. Alternative to query parameter method. |
| GET |
get_v1_docs /v1/docs |
Get comprehensive API documentation including endpoints, pricing tiers, supported features, and example usage |
| GET |
get_v1_lookup_query /v1/lookup |
Get geolocation data for a specific IP address using query parameter. Supports both IPv4 and IPv6. |
| Other endpoints | ||
| POST |
post_v1_bulk /v1/bulk |
Lookup geolocation data for multiple IP addresses in a single request. Maximum 100 IPs per request. PRO tier or higher required. |
| GET |
get_v1_distance /v1/distance |
Calculate the great-circle distance in kilometers between two geographic coordinate pairs using the Haversine formula. |
| GET |
get_v1_me /v1/me |
Get geolocation data for the requesting client's IP address. Automatically detects and analyzes your public IP. |
| GET |
get_v1_lookup_query /v1/lookup |
Get geolocation data for a specific IP address using query parameter. Supports both IPv4 and IPv6. |
| GET |
get_v1_validate /v1/validate |
Validate an IP address and get type information (IPv4/IPv6). Does not perform geolocation lookup. |
| GET |
get_v1_info /v1/info |
Get detailed IP type information including version (IPv4/IPv6), whether it's private/public, and other technical details. |
| GET |
healthCheck /health |
Check API availability and service status. This endpoint does not require authentication. |
| GET |
get_v1_docs /v1/docs |
Get comprehensive API documentation including endpoints, pricing tiers, supported features, and example usage |
IP Geolocation pricing
| Plan | Price | Rate limit | Quotas |
|---|---|---|---|
| BASIC | Free | 5 / minute |
|
| PRO | $9.99 / month | 30 / minute |
|
| ULTRA Recommended | $49.99 / month | 150 / minute |
|
| MEGA | $199 / month | 500 / minute |
|