Use SOAP to locate your website visitors

If you don't want to maintain an IP to Country database, but you still need to offer location specific services, you can use real-time look-up to the itistimed.com servers. This page is about the SOAP implementation. If you prefer XML-RPC please write at xmlrpc_whois@itistimed.com for details.

This service is implemented based on the WebNet77 daily updated geo-ip database. It is offered free under the terms of the GENERAL PUBLIC LICENSE.

Work with your website visitors country in your code as simple as calling a SOAP method (PHP example):

$client = new SoapClient(null, array(
   'location' => "http://www.itistimed.com/soap/whois.php",
   'uri'      => "http://www.itistimed.com/soap/req"
));

$country_data = $client->ipToCountry($_SERVER["REMOTE_ADDR"]);

The above will return an associative array, containing:

• status - search status: 0, 1, 2
• status_text - additional text for the call status: "Failed. Bad IP", "Success", "Not found"
• range_from - starting address in the network numerical format for the IP range the searched address is part of
• range_to - ending address in the network numerical format for the IP range the searched address is part of
• registry -
• assigned - assigned dat since the epoch
• country_2 - country (2 character code - US)
• country_3 - country (3 character code - USA)
• country_name - country name (UNITED STATES)

IMPORTANT NOTES:

• the number of requests per day per IP is limited to 10,000
• if you feel that your site will call more then 10,000 times/day please contact us at: soap_whois@itistimed.com

Simple PHP example that displays all IP to Country data joined by ';':

<?php

   $ip = $_REQUEST['ip']?$_REQUEST['ip']:$_SERVER["REMOTE_ADDR"];

   $client = new SoapClient(null, array(
      'location' => "http://www.itistimed.com/soap/whois.php",
      'uri'      => "http://www.itistimed.com/soap/req"
   ));

   $country_data = $client->ipToCountry($ip);
   echo(join(";", array_values($country_data)));

?>

Will display something like:

1;Success;1089929216;1089945599;ARIN;1003363200;US;USA;UNITED STATES

What you're looking for?