API Documentation

Requests

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

http://api.bitwize.com.lb/geoip/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.

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

http://api.bitwize.com.lb/geoip/api/8.8.8.8

http://api.bitwize.com.lb/geoip/api/2a00:a200:0:f::888

http://api.bitwize.com.lb/geoip/api/8.8.8.8/full

http://api.bitwize.com.lb/geoip/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="http://api.bitwize.com.lb/geoip/api?callback=foo"></script>

SSL

This service is also available via https.

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.