GeoJoe - IP Geolocation Service

Welcome to the GeoJoe API!

If you didn't know, GeoJoe is an online look-up service for locating IP addresses, servers and domain names. Simply input an IP or server name on the main GeoJoe website and GeoJoe will tell you exactly where in the world it is - often right down to the city, town or village - along with precise geographical co-ordinates and other such useful data.

GeoJoe API for Developers and Webmasters

The GeoJoe API (Application Programming Interface) allows developers and webmasters to retrieve geolocation data for embedding within their own websites and applications . Using simple query syntax, users can pass the API single or multiple IP addresses and get back a variety of results, depending upon their requirements, in various formats.

The GeoJoe API currently contains:

Returning of all Geolocation data for a single IP address;
Returning an array from a batch of IP addresses;
Display a configurable badge for a single IP address;
Display a country flag for a single IP address;
Display a world map with real-time plotting of visitor origin

Calling the API functions

Single

The single format takes an IP address and returns all geolocation data in key/value pairs.

Method Name: single

URL: http://www.geojoe.co.uk/api/single

Passed Variables: ip or domain name (optional)

Returned Formats: key/value pairs

Returned Variables:

ip
country_code
country_name
region
city
latitude
longitude

Example Call

http://www.geojoe.co.uk/api/single/?ip=209.85.171.99

Note: If you omit the ip variable the IP calling the script will be used.

Example Output

ip=209.85.171.99&country_code=US&country_name=United States&region=California&city=Mountain View&latitude=37.4192&longitude=-122.0574

Batch

The batch format takes a CSV of IP address and returns all geolocation data in the chosen format.

Method Name: batch

URL: http://www.geojoe.co.uk/api/batch

Passed Variables: ips - CSV of IP addresses or domain names, format

Returned Formats: key/value pairs (default) or XML

Returned Variables:

ip
country_code
country_name
region
city
latitude
longitude

Example Call

http://www.geojoe.co.uk/api/batch/?ips=209.85.171.99,127.0.0.1,127.0.0.1&format=xml

Note: If you omit the format variable, the default key/value pairs will be returned.

Example XML Output

<?xml version="1.0" encoding="iso-8859-1"?>
<results>
<geodata>
<ip>xx.xx.xx.xx</ip>
<country_code>US</country_code>
<country_name>United States</country_name>
<region>California</region>
<city>Mountain View</city>
<latitude>37.4192</latitude>
<longitude>-122.0574</longitude>
</geodata>...
...
<results>