Country is an IP-to-country geolocation API that returns a user’s country based on their IP address.
We run a free instance—no API key needed. You can also self-host if preferred.
The API has a minimal interface.
Returns the country of the IP making the request, typically the user’s browser or app.
/* https://api.country.is/ */
{
"ip": "77.249.1.1",
"country": "NL"
}Returns the country of any given IP. The API supports both with IPv4 and IPv6.
/* https://api.country.is/77.1.2.3 */
{
"ip": "77.1.2.3",
"country": "DE"
}Provides metadata about the API, including when the data sources were last updated.
/* https://api.country.is/info */
{
"dataSources": ["maxmind", "cloudflare"],
"lastUpdated": "2024-08-20T18:34:36.000Z"
}The API automatically updates MaxMind data every 24 hours in the background.
If you prefer not to use our hosted service, you can self-host with Docker.
docker run -d -p 3000:3000 -e ACCOUNT_ID=YOUR_MAXMIND_ACCOUNT_ID -e LICENSE_KEY=YOUR_MAXMIND_LICENSE_KEY lineofflight/country
Replace YOUR_MAXMIND_ACCOUNT_ID and YOUR_LICENSE_KEY with your MaxMind account ID and the license key associated with it.
To improve performance, deploy behind Cloudflare:
- Point your domain to Cloudflare's nameservers
- Enable Cloudflare proxying for your API endpoint (click the cloud icon next to your DNS record until it turns orange)
When deployed with Cloudflare, the API will automatically use Cloudflare's geolocation data as the primary source, falling back to MaxMind when needed.