Skip to content

hakanensari/country

Repository files navigation

Country

Build

Country is a geolocation API that gets your users' country (and nothing else) from their IP.

Usage

Country has a minimal 🔥 interface.

Have your browser or app query its own IP address.

https://api.country.is/

Query an abitrary IP.

https://api.country.is/9.9.9.9

See the data sources.

https://api.country.is/info

Country automatically checks for a newer version every 24 hours.

Deployment

We run a public instance at country.is. Alternatively, you can run privately with

docker run -d -p 3000:3000 -e LICENSE_KEY=YOUR_LICENSE_KEY hakanensari/country

Replace the YOUR_LICENSE_KEY placeholder with a license key associated with your MaxMind account.

Notes

Country uses geolocation data provided by Cloudfare and MaxMind.

Since 30 December 2019, you need to register for a license key to download the MaxMind data.

Our public instance does not log requests.