Skip to content
main
Switch branches/tags
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Country

Build

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

Usage

Country has a minimal 🔥 interface.

Query the IP of the requesting client.

https://api.country.is/

Query any IP.

https://api.country.is/9.9.9.9

See the age of the underlying data file.

https://api.country.is/version

Country automatically checks for a newer version every 24 hours.

Deployment

Use the hosted service or 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 GeoLite2 data provided 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.