Geolocation of IP Address
See more REST Examples
Retrieve country, state or province, and city for a public IP address using the DB-IP v2 free JSON API. This replaces the retired freegeoip.net request and the historical two-service comparison. The sample sends one HTTPS request, checks transport and service errors, and reads the returned fields.
DB-IP documents 500 daily requests for its free service. Its free HTTPS endpoint returned a successful lookup during verification on November 20, 2026. For other providers and authenticated services, see the Geolocation examples.
IP geolocation estimates a network location. VPNs, mobile gateways, and anycast routing can affect the result. City and coordinate fields can be missing or approximate. The sample address 8.8.8.8 is a public DNS address used to demonstrate the request.
Chilkat CkPython Downloads
import sys
import chilkat
success = False
# Assumes Chilkat is unlocked. See Global Unlock Sample.
# Use a public IP address. Provider results can change as their databases are updated.
ipAddress = "8.8.8.8"
http = chilkat.CkHttp()
http.put_RequireSslCertVerify(True)
http.put_ConnectTimeout(10)
http.put_ReadTimeout(30)
http.put_Accept("application/json")
url = chilkat.CkStringBuilder()
url.Append("https://api.db-ip.com/v2/free/")
url.Append(http.urlEncode(ipAddress))
response = chilkat.CkHttpResponse()
success = http.HttpNoBody("GET",url.getAsString(),response)
if (response.get_StatusCode() == 0):
# Request diagnostics can contain an API key. Report transport failure without logging credentials.
print("No HTTP response. Check connectivity, DNS, and TLS configuration.")
sys.exit()
json = chilkat.CkJsonObject()
parsed = json.Load(response.bodyStr())
if ((success != True) or (response.get_StatusCode() < 200) or (response.get_StatusCode() >= 300)):
print("Lookup failed. HTTP " + str(response.get_StatusCode()))
if (parsed == True):
if (json.JsonTypeOf("errorCode") == 1):
print(json.stringOf("errorCode"))
if (json.JsonTypeOf("error") == 1):
print(json.stringOf("error"))
sys.exit()
if (parsed != True):
print("Expected a JSON object in the lookup response.")
sys.exit()
if ((json.HasMember("errorCode") == True) or (json.JsonTypeOf("error") == 1)):
print("The service could not complete the lookup.")
if (json.JsonTypeOf("errorCode") == 1):
print(json.stringOf("errorCode"))
if (json.JsonTypeOf("error") == 1):
print(json.stringOf("error"))
sys.exit()
if ((json.JsonTypeOf("ipAddress") != 1) or (json.StringOfEquals("ipAddress","",True) == True)):
print("The response did not contain the expected IP address.")
sys.exit()
print("IP address: " + json.stringOf("ipAddress"))
if ((json.JsonTypeOf("countryName") == 1) and (json.StringOfEquals("countryName","",True) != True)):
print("Country: " + json.stringOf("countryName"))
else:
print("Country: unavailable")
if ((json.JsonTypeOf("countryCode") == 1) and (json.StringOfEquals("countryCode","",True) != True)):
print("Country code: " + json.stringOf("countryCode"))
else:
print("Country code: unavailable")
if ((json.JsonTypeOf("stateProv") == 1) and (json.StringOfEquals("stateProv","",True) != True)):
print("State or province: " + json.stringOf("stateProv"))
else:
print("State or province: unavailable")
if ((json.JsonTypeOf("city") == 1) and (json.StringOfEquals("city","",True) != True)):
print("City: " + json.stringOf("city"))
else:
print("City: unavailable")