IP Geolocation API
IPv4 / IPv6 → country, region, city, county, postal code, and ASN — sub-millisecond local lookup
<1 ms
Local lookup
3
Endpoints
1,000
IPs / batch
What you get
Submillisecond local lookup
MaxMind GeoLite2 mmdb in-memory on the geocoder box — no external API call. p95 under 1 ms.
ASN block
Autonomous System Number + organization name on every response — useful for fraud detection, VPN/proxy filtering, and traffic-source analytics.
Confidence label
Each result is tagged residential / datacenter / anycast / vpn so your code can decide how much to trust the geo signal.
County overlay (US)
For US IPs, FIPS county code is added on top of the standard country/region/city lookup — useful for compliance, demographics, and SLA targeting.
All 3 Endpoints
| Method | Endpoint | Description |
|---|---|---|
| GET | /v1/ip | Resolve a single IP address to country/region/city/county/ASN |
| GET | /v1/ip/me | Geolocate the requester's own IP (no parameters needed) |
| POST | /v1/ip/batch | Batch lookup up to 1,000 IPs in a single request |
Example
GET /v1/ip?ip=8.8.8.8&api_key={key}
Response:
{
"ip": "8.8.8.8",
"country": { "code": "US", "name": "United States" },
"region": { "code": "CA", "name": "California" },
"city": "Mountain View",
"county": { "fips": "06085", "name": "Santa Clara County" },
"postcode": "94035",
"location": { "lat": 37.4056, "lng": -122.0775, "accuracy_radius_km": 1000 },
"asn": { "number": 15169, "org": "Google LLC" },
"confidence": "datacenter"
}