Geolocation API logo

IP Geolocation API

IP Geolocation API is a free real-time IP to Geolocation JSON API
with detailed countries data integration.

                    
GET /api/geolocate/91.213.103.0 HTTP/1.1
Host: ipgeolocationapi.com

{
    "continent": "Europe",
    "alpha2": "DE",
    "country_code": "49",
    "international_prefix": "00",
    "name": "Germany",
    "languages_spoken": [
        "de"
    ],
    "geo": {
        "latitude": 51.165691,
        "longitude": 10.451526,
    },
    "currency_code": "EUR"
}
                    
                
Actual response contains more country details.

What is IP geolocation

Geolocation is the identification or estimation of the real-world geographic location of an Internet-connected computer terminal or device.

Countries information

Countries information packaged as convenient JSON objects. It includes data from ISO 3166 (countries and states/subdivisions ), ISO 4217 (currency), and E.164 (phone numbers).

IPv4/IPv6 support

Geolocation data is provided by a monthly updated MaxMind Geolite2 database.

Usage

Geolocate the request without proving any IP.
This is useful for geolocating users in the frontend without the need to detect their actual IP yourself.

                    
GET /api/geolocate/ HTTP/1.1
Host: ipgeolocationapi.com
                    
                

Geolocate any IPv4 or IPv6 address.

                    
GET /api/geolocate/91.213.103.0 HTTP/1.1
Host: ipgeolocationapi.com
                    
                

List all countries with detailed information about location, currency, phone numbers, etc.

                    
GET /api/countries HTTP/1.1
Host: ipgeolocationapi.com
                    
                

Get specific country information by providing the ISO 3166-1 alpha-2 country code.

                    
GET /api/countries/de HTTP/1.1
Host: ipgeolocationapi.com
                    
                

Please cache results whenever possible this will allow us to keep the service without any rate limits or api key requirements.

The API comes with no warranty but we do our best effort to keep the service working relibly.

Self-host

Want to host this service yourself?
We have a one-click deploy to heroku button for you.

Deploy to Heroku