User Country API: GeoIP REST service for language, currency and timezone location

Demo

{
    "status": "success",
    "ip": "173.194.192.101",
    "ip_version": "ipv4",
    "country": {
        "alpha-2": "US",
        "alpha-3": "USA",
        "name": "United States",
        "phone": "1"
    },
    "continent": {
        "code": "NA",
        "name": "North America"
    },
    "currency": {
        "symbol": "$",
        "name": "US Dollar",
        "symbol_native": "$",
        "decimal_digits": "2",
        "rounding": "0",
        "code": "USD",
        "name_plural": "US dollars"
    },
    "language": {
        "code": "en-US",
        "name": "English (United States)"
    },
    "region": {
        "city": "Mountain View",
        "state": "California",
        "postal": "94043",
        "latitude": 37.4192,
        "longitude": -122.0574
    },
    "timezone": {
        "name": "America\/Los_Angeles",
        "current_time": "2017-07-29T15:35:08-07:00",
        "code": "PDT",
        "gmt_offset": -25200,
        "is_daylight_saving": true
    }
}

World

Documentation

URI: usercountry.agum.com/v1.0/json/<IP_Address>

Protocol: http or https

Method: GET

Description:

We support both http or 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.

Usage example:

You can click on this link from your browser, or curl from command line:
curl -s https://usercountry.agum.com/v1.0/json/173.194.192.101

API Token:

Pass in the GET parameter (query string) token to lift the default rate limit. For example:
https://usercountry.agum.com/v1.0/json/173.194.192.101?token=<YOUR_TOKEN>

Output format: JSON. If you'd like us to add support for other formats like XML, please let us know at support@usercountry.com.

Output fields: See the Demo box.

F.A.Q.

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 the NSLocale.preferredLanguages()[0] 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 support@usercountry.com.

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.

GeoIP REST API for easily getting the user's country, language, currency and timezone location

Get a Free API Token!

Demo

Documentation

F.A.Q.