Free IP GeoLocation / GeoIp API

API Documentation

Requests

All requests have to be HTTP GET requests in the following schema:

https://geoip.cdnservice.eu/api/{ip}/{language}/{type}

Parameters

ip	optional	Valid IP address in IPv4 or IPv6 format.
language	optional*	Two character language code like en or de.
type	optional*	Possible values are short to get a response conataining only most relevant data or full to get a response containing all available data.

* This parameter can only be used if IP parameter is provided.

Responses

By default all responses are JSON encoded strings.
It is also possible to get JSONP responses for direct usage in javascripts. To get a JSONP response a callback function has to be provided within the request using the ?callback= parameter.

Examples

https://geoip.cdnservice.eu/api/8.8.8.8

https://geoip.cdnservice.eu/api/2a00:a200:0:f::888

https://geoip.cdnservice.eu/api/8.8.8.8/full

https://geoip.cdnservice.eu/api/87.79.99.25/de

<script>
function foo(data) {
    document.write("City: ", data.city);
    document.write("Country: ", data.country.name);
    document.write("Latitude: ", data.location.latitude);
    document.write("Longitude: ", data.location.longitude);
}
</script>
<script src="https://geoip.cdnservice.eu/api?callback=foo"></script>

Limits

The API follows a fair use policy. There are no limits by default but if the service is abused your IP may get blocked.