IP Address Geolocation to trace Country, Region, City, ZIP Code, etc

Overview of our IP Address Geolocation Online Service

The IP-GeoLoc™ IP Address Geolocation Online Service is a hosted and programmable XML Web Service that allows instant identification of your online visitor's geographical location by using his IP address or host name, both 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, 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/20th 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 by simply using string manipulation, or by parsing the XML tags using any XML parsing component (there are many of such components available for every modern programming language, all of them for free).

How our IP Address Geolocation Online Service works

It is very simple. Your web site makes a call to our IP address geolocation service using either the HTTP "GET" or "POST" methods.
If you have the visitor's IP address and you choose to use the HTTP "GET" method, you should use the following URL:
http://services.ipaddresslabs.com/iplocation/locateip?key={your "Service Access Key"}&ip={the visitor's IP address}
Example: http://services.ipaddresslabs.com/iplocation/locateip?key=demo&ip=50.16.36.153 Alternatively, the "ip" parameter may contain "local-ip" as a static value instead of the visitor's IP address. In such case, the IP address of the host from which our service is invoked will be geolocated. This is particularly useful when our service is invoked from a desktop application that needs to geolocate the IP address of the host from which it is being executed. It is also very useful when our service is invoked by a static javascript code that is executed in the visitor's browser (instead of by the web server in which the site resides).

If you do not have the IP address but you do have the host name (which is very unlikely), and you choose to use the HTTP "GET" method, 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"}&hostname={the visitor's host name}
Example: http://services.ipaddresslabs.com/iplocation/locatehostname?key=demo&hostname=dyndns.com In any of the two cases above (i.e. when sending the IP address or when sending the hostname), you can use the HTTP "POST" method instead of the HTTP "GET" method. To do so, just use the URL up to the "?" character and send the required data inside the message body. You can also use the HTTPS (HTTP secure) protocol instead of the HTTP protocol. Just start the URL with "https://https-services" instead of with "http://services".

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" or HTTP "POST" methods are programmatically 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 invoke our service 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.

Live Demo

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 continuously updated.
Fast, in Real-Time: Our IP address geolocation service returns a response to your web site in less than 1/20th of a second.
Generous Rates: If you use just one license, you can make up to 300 queries/minute, yet not exceed 9,000 queries/hour or 100,000 queries/day. Should you need a higher rate, you could easily extend that ceiling by purchasing additional licenses.
Affordable: The monthly subscription fee can be as low as US$ 5 (for the Basic Edition, paying for 24 months in advance).
No Setup Fees: Pay as you go. You can start paying for just one month of service, with no setup fees.
Several Editions: You can choose from the 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 pay for a subscription.
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).
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

Reduce credit card fraud
Filter access from countries you do not do business with to avoid legal issues
Display native language and currency
Understand better your visitors by geographical location
Auto-selection of country on forms

Control contents distribution by region for digital rights management
Prevent password sharing and abuse of service
Target advertising by geographical location
Redirect web pages based on geographical region for load balancing
Web log statistics and analysis to understand your visitors better by geographical location

Editions, Plans and Pricing of our IP Address Geolocation Online Service

All license types displayed in the following table have some limits regarding the rate at which the geolocation service can be used.
If you use just one license, you can make up to 300 queries/minute, yet not exceed 9,000 queries/hour or 100,000 queries/day. Should you need a higher rate, you could easily extend that ceiling by purchasing additional licenses. Doing so will have a multiplicative effect on such limits, therefore allowing you to make "x" times more queries per minute, hour and day. For instance, if you were to purchase an additional license for a total of two, you would be able to make up to 600 queries/minute, yet not exceed 18,000 queries/hour or 200,000 queries/day.
Once you have purchased multiple licenses, you may choose to alternate your use of them or request us to accrue your total rate to be used with just one of your licenses. The latter will save you time as you would not have to program a different logic to intersperse when to use which license.
Please let us know if you would like any additional information about multiple license usage.

Pre-paid Months	Discount	Basic Edition	Standard Edition	Professional Edition
1		US$10 per month One payment of US$10 Subscribe	US$15 per month One payment of US$15 Subscribe	US$20 per month One payment of US$20 Subscribe
3	10%	US$9 per month One payment of US$27 Subscribe	US$13.3 per month One payment of US$40 Subscribe	US$18 per month One payment of US$54 Subscribe
6	20%	US$8 per month One payment of US$48 Subscribe	US$12 per month One payment of US$72 Subscribe	US$16 per month One payment of US$96 Subscribe
9	30%	US$7 per month One payment of US$63 Subscribe	US$10.4 per month One payment of US$94 Subscribe	US$14 per month One payment of US$126 Subscribe
12	40%	US$6 per month One payment of US$72 Subscribe	US$9 per month One payment of US$108 Subscribe	US$12 per month One payment of US$144 Subscribe
24	50%	US$5 per month One payment of US$120 Subscribe	US$7.5 per month One payment of US$180 Subscribe	US$10 per month One payment of US$240 Subscribe
Get your Free Trial		30-day Free Trial	30-day Free Trial	30-day Free Trial
Live Demo		Live Demo

Output Fields of our IP Address Geolocation Online Service (Editions Comparison)

Output Field	Format	Description	Basic Edition
continent_code	char(2)	Continent two-letter code. AF=Africa, AN=Antarctica, AS=Asia, EU=Europa, NA=North America, OC=Oceania, SA=South America.
continent_name	varchar(15)	Continent name. "Africa", "Antarctica", "Asia", "Europa", "North America", "Oceania" or "South America".
country_code_iso3166alpha2	char(2)	Country code (ISO 3166-1 Alpha-2 standard, two-letter code). More information
country_code_iso3166alpha3	char(3)	Country code (ISO 3166-1 Alpha-3 standard, three-letter code). More information
country_code_iso3166numeric	char(3)	Country code (ISO 3166-1 Numeric standard, three-digit code). More information
country_code_fips10-4	char(2)	Country code (FIPS 10-4 standard, two-letter code). More information
country_name	varchar(50)	Country name (ISO 3166-1 standard). More information
region_code	varchar(4)	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 with the addition of some entries for the US Armed Forces (more information). Outside of the USA and Canada, it uses the FIPS 10-4 standard (more information).
region_name	varchar(100)	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 with the addition of some entries for the US Armed Forces (more information). Outside of the USA and Canada, it uses the FIPS 10-4 standard (more information).
city	varchar(100)	Name of city (or town), in ISO-8859-1 encoding.
postal_code	varchar(6)	Postal code (only available for the USA and Canada). More information
metro_code	char(3)	US metropolitan region code ("Metro Code"). Only available for the USA. More information
area_code	char(3)	Area code, three-digit telephone prefix (only available for the USA).
latitude	decimal(8,4)	Latitude of the center of the city where the IP address is located.
longitude	decimal(8,4)	Longitude of the center of the city where the IP address is located.
isp	varchar(100)	Internet Service Provider (ISP) that owns the IP address. More information
organization	varchar(100)	Organization the IP address is assigned to. More information
ip_address	varchar(15)	IP address supplied as input to the service (if an IP address was supplied by your website).
host_name	varchar(1000)	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	varchar(15)	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	varchar(50)	"OK" if the query was correctly invoked, otherwise an error code. Possible values
query_status_description	varchar(250)	Explains the code received in query_status_code. More information
Live Demo			Live Demo

A "-" character (ASCII Dec 45/Hex 0x2D, Unicode U+002D) is returned by some fields when no value is available. For example, the postal code field returns a "-" when the IP address does not belong to the USA or to Canada.

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.