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 servise is offered as it is 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-city.php",
   'uri'      => "http://www.itistimed.com/soap/req"
));

$data = $client->ipToCountryCity($_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"
• country - Country (2 character code - US)
• state - State (2 character code - CA)
• city - City
• zip - Zip or postal code
• org - Organization

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-city.php",
      'uri'      => "http://www.itistimed.com/soap/req"
   ));

   $data = $client->ipToCountryCity($ip);
   var_dump($data);

?>

array(7) { 
	["status"]=>  		int(1) 
	["status_text"]=>  	string(7)  "Success" 
	["country"]=>  		string(2)  "US" 
	["city"]=>  		string(13) "Mountain View" 
	["state"]=>  		string(2)  "CA" 
	["zip"]=>  		string(5)  "94043" 
	["org"]=>  		string(11) "Google Inc." 
} 

What you're looking for?