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 ACCOUNT_ID=YOUR_MAXMIND_ACCOUNT_ID LICENSE_KEY=YOUR_MAXMIND_LICENSE_KEY hakanensari/country

Replace the YOUR_MAXMIND_ACCOUNT_ID and YOUR_LICENSE_KEY placeholders with your MaxMind account ID and the license key associated with it.

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.