Starting January 1st, 2018, API calls without a token will be rate limited to 100/day.
Simply provide your email address to receive a token.
We support both
https protocol for your convenience, but we recommend
the use of
https whenever possible.
Our API is a simple HTTP GET request. Simply replace
<IP_Address> with your user's
IP address. We support both IPv4 and IPv6.
You can click on this link from your browser, or curl from command line:
curl -s https://usercountry.com/v1.0/json/220.127.116.11
Pass in the
GET parameter (query string)
token to lift
the default rate limit. For example:
JSON. If you'd like us to add support for other formats like XML, please let us know at [email protected]
1. How accurate is the language data?
We determine language purely based on what country the user resides in, based on their IP address. Like any human being, your user could live in (or stay in) a certain country and speak a different language than the official language of the country. For best results, you should also check the
Accept-Language HTTP header of your user's client,
and determine what to use in your web app.
Similarly, Android apps could use the
Locale.getDefault().getISO3Language() call and iOS apps could use
NSLocale.preferredLanguages() as String call to get user languages.
2. How accurate is the currency data?
We determine currency based on what country the user resides in, based on their IP address. We keep currency information up to date, but if you find that a country's official currency had changed due to recent events and we have not yet reflected that, please let us know at [email protected]
3. How accurate is the timezone data?
Timezone data is determined based on a more fine-grained geographical data determined by user's IP address, with precision on a city level. Our geographic data source has 99.8% accurate on a country level, 90% accurate on a state level in the US, and 81% accurate for cities in the US within a 50 kilometer radius.
4. What does "BETA" mean?
While we're in BETA release, our API is completely free for use. As more people adopt our API, we will plan to begin charging a small monthly fee based on usage. (the lowest tier will remain free, meaning personal and side projects can continue to use us for free.)
If you begin using our API for your application, please stay tuned with us for this upcoming change.