ip2location facebbook  ip2location twitter  ip2location google+ ip2location github

IP2Proxy™ Web Service

USD $50.00 / 10,000 Credits * For 1 year

The IP2Proxy™ Proxy Detection Web Service is a hosted Web Service that allows instant detection of anonymous proxy, VPN and TOR exit nodes by IP address. It's a REST API supporting JSON and XML response.



All successful HTTP request will return a response code of 200. In our IP proxy API, it also returns the lookup country code and country name if successful or error code if failed.

Each API unit subscription has 10,000 query credits. If you need more credits, please add multiple units during checkout. Total credits will be in multiplier (x 10,000) of number of units paid. An unique API key will be provided to query the web service.

IP2Proxy™ REST API uses a single web interface to perform the lookup logic. The protocol used is HTTP GET. You can test this API as easy as using a web browser.





Name Description
key (required) API key. Please use "demo" for evaluation.
ip (optional) IP address (IPv4) for lookup purpose. If not present, the server IP address will be used for the lookup.
package (optional) If not present, the web service will assume the PX1 package query.
Valid value: PX1 | PX2 | PX3 | PX4
format (optional) If not present, json format will be returned as the search result. Valid value: json | xml


Name Description
response OK if success, otherwise failed.
countryCode 2 digits country code.
countryName Country name.
regionName Region or state name.
cityName City name.
isp The service provider name.
isProxy YES if the IP is a Proxy.
NO if the IP is not a proxy.
DCH if the IP belongs to Hosting Provider, Data Center or Content Delivery Network. Note: DCH is only available for PX2, PX3 and PX4 query
proxyType The type of proxy service.



You can try out our IP proxy API by using the demo key. For example, http://api.ip2proxy.com/?ip= Demo query limit is 20 per day.

In addition, you can also sign up for a trial key that enable you to test the REST API for up to 1,000 credits.

JSON Example:


JSON Result:


    "response": "OK",
    "countryCode": "JP",
    "countryName": "Japan",
    "regionName": "Tokyo",
    "cityName": "Tokyo",
    "isp": "Japan Network Information Center",
    "proxyType": "DCH",
    "isProxy": "NO"


XML Example:


XML Result:

	<isp>Japan Network Information Center</isp>



We offer you 4 packages for your IP query. Each package returns you a different set of IP information with different credits required for each query.
Package Information Returned Credit
PX1 Country Code, Country Name, Is Proxy 1 credit
PX2 Country Code, Country Name, Is Proxy, Proxy Type 2 credits
PX3 Country Code, Country Name, Is Proxy, Proxy Type, Region, City 3 credits
PX4 Country Code, Country Name, Is Proxy, Proxy Type, Region, City, ISP 4 credits