IP geolocation
Country, region, city, lat/lon, timezone, ASN and ISP for any public IP.
/v1/intel/geoip Resolves a public IPv4 or IPv6 address to a location and network. Returns country, region, city, latitude/longitude, IANA timezone, ASN, and ISP/organisation name, plus an approximate postal code. All lookups hit a local memory-mapped database — no third-party API call, no per-lookup latency tax. Data is from DB-IP Lite, iptoasn.com, and GeoNames, refreshed monthly.
Country, region, and city are reliable globally. ASN and ISP come from public routing data.
postal_code is area-level, not the user's exact ZIP — it is the nearest postal centroid to the IP's city, hence postal_accuracy: "approximate". Sub-city precision is not possible from IP data for any provider, especially on mobile and ISP-pooled ranges.
Parameters
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
| ip | string | yes | — | Public IPv4 or IPv6 address to geolocate. |
Request
curl -X POST https://api.qcrawl.com/v1/intel/geoip \
-H "Authorization: Bearer osk_..." \
-d '{"ip": "8.8.8.8"}'Response
{
"status": "success",
"ip": "8.8.8.8",
"country": "US",
"country_name": "United States",
"continent": "NA",
"region": "California",
"city": "Mountain View",
"postal_code": "94043",
"postal_accuracy": "approximate",
"latitude": 37.4223,
"longitude": -122.0850,
"timezone": "America/Los_Angeles",
"asn": 15169,
"isp": "GOOGLE",
"data_source": "db-ip.com, iptoasn.com, geonames.org"
}Errors
| Code | Meaning |
|---|---|
| 400 | Malformed IP, or a private/reserved IP that cannot be geolocated. |
| 404 | Valid public IP that is not present in the geolocation database. |
| 503 | Geolocation database temporarily unavailable. The credit for this call is refunded. |