It’s easy: you send an HTTP request to our service, and the service replies with all the information about an IP address in the format of your choice!

Currently supported formats are:

1. ➡CSV: http://freegeoip.appspot.com/csv/ip-address
   

2. ➡XML: http://freegeoip.appspot.com/xml/ip-address
   

3. ➡JSON: http://freegeoip.appspot.com/json/ip-address
   

After selecting the format, you put the IP address you’re looking for, like this:

http://freegeoip.appspot.com/xml/72.14.247.141

This will return all the information related to the IP address 72.14.247.141, or a failure code. The failure code will always respect the chosen data format.

Data formats

Text data is always encoded as UTF-8.

1. ➡CSV
   

The Comma Separated Values format will always return 10 columns in a single line, like this:

The data in the first two columns will always be present. Status can be either true or false, and must be used to determine the success or failure of the query.

1. ➡XML
   

The Extensible Markup Language format will always return the same document structure, with a Status node containing either true or false, used to determine the success or failure of a query.

Here is an example of the reply:

1. ➡JSON
   

The JavaScript Object Notation is also available, and is the preferred method for retrieving the results.

The status key can be either true or false and is used to determine the success or failure of a query: