IP Geolocation

Geolocate IPv4 and IPv6 addresses to country, city, ISP, and detect VPNs, proxies, and Tor exit nodes.

apicrate-geolocate-ip

Geolocate an IP address using MaxMind databases. Returns country, continent, city, ISP, network, and security information including VPN detection, proxy status, and Tor exit node identification.

Credit cost: 5 credits per call.

Parameters

Parameter

Type

Required

Description

ip

string

yes

IPv4 or IPv6 address to geolocate.

Example

Request:

{
  "name": "apicrate-geolocate-ip",
  "arguments": {
    "ip": "8.8.8.8"
  }
}

Response:

{
  "ip": "8.8.8.8",
  "ip_version": 4,
  "country": {
    "iso_code": "US",
    "name": "United States"
  },
  "continent": {
    "code": "NA",
    "name": "North America"
  },
  "city": {
    "name": null,
    "postal_code": null
  },
  "location": {
    "latitude": 37.751,
    "longitude": -97.822,
    "accuracy_radius": 1000,
    "timezone": "America/Chicago"
  },
  "isp": {
    "name": "Google LLC",
    "organization": "Google LLC",
    "asn": 15169,
    "network": "8.8.8.0/24"
  },
  "security": {
    "is_vpn": false,
    "is_proxy": false,
    "is_tor_exit_node": false,
    "is_hosting": true
  }
}

Errors

  • Invalid IP address – malformed or unparseable IP strings are rejected. Both IPv4 (192.168.1.1) and IPv6 (2001:4860:4860::8888) formats are accepted.

  • Private / reserved IP – addresses in private ranges (10.x.x.x, 192.168.x.x, ::1, etc.) cannot be geolocated and return an error.