Overview of our IP Address Geolocation Online Service
The IP-GeoLoc™ IP Address Geolocation Online Service is a hosted, programmable XML Web Service that allows instant identification of your online visitor's geographical location by using his IP address or host name, in real time. Your web site communicates with our cloud-based service, sends your visitor's IP address or host name, and receives its geographic information such as the Continent, Country Code (ISO 3166), Country Name, Region (State, County, Province, Region, Territory, District, etc), City, Postal/ZIP Code, Metro Code, Area Code, Latitude, Longitude, Internet Service Provider (ISP) and Organization. This IP address geolocation response is returned to your web site in less than 1/20 of a second, in XML format (you can see an example of this format here). Your code then obtains the IP address geolocation information from this response simply by using string manipulation, or by parsing the XML tags using any XML parsing component (there are many of these components for all modern programming languages, for free).
How does our IP Address Geolocation Online Service work
It is very simple. Your web site makes a call to our IP address geolocation service performing an "HTTP GET" method.
You should use the following URL if you have the visitor's IP address:
http://services.ipaddresslabs.com/iplocation/locateip?key=(your "Service Access Key" goes here)&ip=(the visitor's IP address goes here)
Example: http://services.ipaddresslabs.com/iplocation/locateip?key=demo&ip=38.107.179.212
If you don't have the IP address but you do have the host name (which is very unlikely), you can use the following URL and the IP address geolocation service will automatically obtain the IP address from the host name:
http://services.ipaddresslabs.com/iplocation/locatehostname?key=(your "Service Access Key" goes here)&hostname=(the visitor's host name goes here)
Example: http://services.ipaddresslabs.com/iplocation/locatehostname?key=demo&hostname=dyndns.com
The "Service Access Key" is a value that identifies your geolocation service license in our system, either as a trial user or as a subscribed user. To get your own Service Access Key, please register, then sign in, and then get your Free Trial License or subscribe to our IP address geolocation service.
The "HTTP GET" method is programatically performed from your website, in real time, so you must have access to your website's source code to extend it. All modern languages (such as Java/JSP, ASP, PHP, C#, Visual Basic, C, C++ and others) include libraries that implement the HTTP protocol, and allow you to make this with just a few lines of code. All web programming languages also allow you to obtain the visitor's IP address (as well as the host name), with just one line of code. You will need one of these values in order to invoke our service.
Features of our IP Address Geolocation Online Service
- Highly Accurate: Our IP mapping technology covers all the 4,294,967,296 IPv4 addresses around the world. Our IP address geolocation database is being permanently updated.
- Fast, in Real-Time: Our IP address geolocation service returns a response to your web site in less than 1/20 of a second.
- Unlimited Lookups: No quotas on the quantity of IP address geolocation lookups, or the rate (IP address geolocation lookups per second).
- Free Micro Edition: If the information it brings is enough for your needs, you can use our Micro Edition for Free!
- Affordable Paid Editions: The monthly subscription fee can be as low as US$ 6 (for the Basic Edition, paying for 12 months in advance).
- No Setup Fees: Pay as you go. You can start paying for just one month of service of one of our paid editions, with no setup fees. Or you can use our Micro Edition for Free!
- Several Editions: You can choose from the Micro, Basic, Standard and Professional editions, depending on your information needs.
- Free Trial License: Ask for a free trial license to evaluate our IP address geolocation service, before you get a paid subscription. Or you can directly use our Micro Edition for Free!
- Web Service: No software to buy and install in your server. No databases to install, that would require frequent manual updates.
- Easy to Integrate: You can invoke our IP address geolocation service from your web site with just a few lines of code. All modern programming languages are supported (Java/JSP, ASP, PHP, C#, Visual Basic, C, C++, etc). Don't even worry about your infrastructure (operating system, web server software, hardware, etc). No need to open your firewall, because it uses the standard HTTP protocol (port 80) to communicate your web server with our cloud.
- 99.995% Availability: Designed to achieve a 99.995% availability, which is equivalent to 26 minutes of downtime per year at the most, considering both hardware/software failures and planned maintenances.
- The Best Support: Our fast and friendly customer support staff will be more than happy to assist you before and after you subscribe to our service.
Things your web site can do with our IP Address Geolocation Online Service
|
|
Use our IP Address Geolocation Online Service, Micro Edition... for Free!
|
We offer our Micro Edition for free. It will provide you the following information:
|
Paid Editions, Plans and Pricing of our IP Address Geolocation Online Service
| Pre-paid Months |
Discount | Basic Edition |
Standard Edition |
Professional Edition |
|---|---|---|---|---|
| 1 |
US$10 per month
One payment of US$10 |
US$15 per month
One payment of US$15 |
US$20 per month
One payment of US$20 |
|
| 3 | 10% |
US$9 per month
One payment of US$27 |
US$13.3 per month
One payment of US$40 |
US$18 per month
One payment of US$54 |
| 6 | 20% |
US$8 per month
One payment of US$48 |
US$12 per month
One payment of US$72 |
US$16 per month
One payment of US$96 |
| 9 | 30% |
US$7 per month
One payment of US$63 |
US$10.4 per month
One payment of US$94 |
US$14 per month
One payment of US$126 |
| 12 | 40% |
US$6 per month
One payment of US$72 |
US$9 per month
One payment of US$108 |
US$12 per month
One payment of US$144 |
| Live Demo |
|
|||
| Get your Free Trial |
|
|
|
|
Get your Free Lifetime License (with a slower service) Our load balancer will forward your request to a crowded server shared by hundreds of users, that will return a response to your web site in a few seconds instead of in 1/20 of a second. |
Responds in 4 seconds |
Responds in 5 seconds |
Responds in 6 seconds |
|
Get your Free Lifetime License (with a monthly quota) You will have a limit on the quantity of IP address geolocation lookups per month. |
60,000 lookups/month |
45,000 lookups/month |
30,000 lookups/month |
|
Output Fields of our IP Address Geolocation Online Service (Editions Comparison)
| Output Field | Format | Description | Micro Edition |
Basic Edition |
Standard Edition |
Pro Edition |
|---|---|---|---|---|---|---|
| continent_code | String | Continent code. |  |
|
|
|
| continent_name | String | Continent name. | |
|
|
|
| country_code_iso3166alpha2 | String | Country code (ISO 3166-1 Alpha-2 standard, two-letter code). | |
|
|
|
| country_code_iso3166alpha3 | String | Country code (ISO 3166-1 Alpha-3 standard, three-letter code). | |
|
|
|
| country_code_iso3166numeric | String | Country code (ISO 3166-1 Numeric standard, three-digit code). | |
|
|
|
| country_code_fips10-4 | String | Country code (FIPS 10-4 standard, two-letter code). | |
|
|
|
| country_name | String | Country name (ISO 3166-1 standard). | |
|
|
|
| region_code | String | Region code ("Region" means "State" in the USA, "County" in the UK, "Province/Territory" in Canada, "Region" in Italy, etc). For the USA and Canada, it uses the ISO 3166-2 standard. For the rest of the world, it uses the FIPS 10-4 standard. | |
|
|
|
| region_name | String | Region name ("Region" means "State" in the USA, "County" in the UK, "Province/Territory" in Canada, "Region" in Italy, etc). For the USA and Canada, it uses the ISO 3166-2 standard. For the rest of the world, it uses the FIPS 10-4 standard. | |
|
|
|
| city | String | City name (using the ISO-8859-1 encoding). | |
|
||
| postal_code | String | Postal code (only available for the USA, Puerto Rico and Canada). | |
|
||
| metro_code | String | Metro code (only available for the USA). | |
|
||
| area_code | String | Area code, three-digit telephone prefix (only available for the USA). | |
|
||
| latitude | Float | Latitude. | |
|||
| longitude | Float | Longitude. | |
|||
| isp | String | Internet Service Provider. | |
|||
| organization | String | Organization the IP address belongs to. | |
|||
| ip_address | String | IP address supplied as input to the service (if an IP address was supplied by your website). | |
|
|
|
| host_name | String | Host name supplied as input to the service (if a host name was supplied by your website, instead of an IP address). | |
|
|
|
| resolved_ip_address | String | IP address the host name resolves to (if a host name was supplied by your website, instead of an IP address). | |
|
|
|
| credit_balance | Integer | Credit balance left for queries (if you are using a 30-day free trial license, or a free license with a monthly quota). | |
|
|
|
| query_status_code | String | "OK" if the query was correctly invoked, otherwise an error code. | |
|
|
|
| query_status_description | String | Explains the code received in query_status_code. | |
|
|
|
| Live Demo |
|
|||||
Input Parameters to call our IP Address Geolocation Online Service
| Input Parameter | Description |
|---|---|
| IP Address or Host Name | Your visitor's IP address or host name. |
| Service Access Key | This value identifies your service license. |