Country has a minimal interface.
Query the IP of the requesting client.
GET https://api.country.is/ HTTP/1.1
Query any IP.
GET https://api.country.is/18.104.22.168 HTTP/1.1
See the age of the underlying data file.
GET https://api.country.is/version HTTP/1.1
Country automatically checks for a newer version every 24 hours.
If you prefer not to use the hosted service, run a private instance with Docker.
docker run -d -p 3000:3000 hakanensari/country -e LICENSE_KEY=YOUR_LICENSE_KEY
YOUR_LICENSE_KEY placeholder with a license key associated with your MaxMind account.
Country uses GeoLite2 data created by MaxMind. Since 30 December 2019, you need to register for a license key to download their data.
The hosted service does not log requests.