We are no longer accepting new registration for IP2Proxy Web Service. For new registration, please visit ip2location.io.
IP2Proxy Proxy Detection Web Service

IP2Proxy™ Proxy Detection Web Service

1,000 credits  
10,000 credits (for 1 year)
100,000 credits (for 1 year)
500,000 credits (for 1 year)

The IP2Proxy™ Proxy Detection Web Service is a hosted Web Service that allows instant detection of anonymous proxy, VPN, TOR exit nodes, search engine robots (SES) and residential proxies (RES) by IP address. It is a REST API supporting both JSON and XML responses and provides IP location lookup information when a proxy is detected.

You can protect your site and web application by filtering detected anonymous proxy, TOR users at first glance.


All successful HTTP or HTTPS requests will return a response code of 200, together with the proxy lookup information. Error code will be returned if an error occurred.

Each unit of package purchase entitles you to 10,000 query credits. If you need more credits, please add multiple units during checkout. Total credits will be the number of units purchased multiplied by 10,000. However, please note that only one unique API key will be given for each user account, even if multiple units are purchased. If you need a different API key, you should sign up using a different email account.

IP2Proxy™ web service is a RESTful API call for anonymous proxy detection. The REST API supports both HTTP GET or HTTPS GET. You can test this REST API easily using a web browser with the below syntax.

  • No database to download, to install or to upgrade in the server-side
  • Supports 11 different types of package queries with a different granularity of data.
  • Supports HTTP or HTTPS queries up to 10,000 times or 1 year (whichever comes first)
Name Description
key (required) API key.
ip (optional) IP address (IPv4 or IPv6) 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 | PX5 | PX6 | PX7 | PX8 | PX9 | PX10 | PX11
format (optional) If not present, json format will be returned as the search result. Valid value: json | xml
Field Description
proxyType Type of proxy.
countryCode Two-character country code based on ISO 3166.
countryName Country name based on ISO 3166.
regionName Region or state name.
cityName City name.
isp Internet Service Provider or company's name.
domain Internet domain name associated with IP address range.
usageType Usage type classification of ISP or company
  • (COM) Commercial
  • (ORG) Organization
  • (GOV) Government
  • (MIL) Military
  • (EDU) University/College/School
  • (LIB) Library
  • (CDN) Content Delivery Network
  • (ISP) Fixed Line ISP
  • (MOB) Mobile ISP
  • (DCH) Data Center/Web Hosting/Transit
  • (SES) Search Engine Spider
  • (RSV) Reserved
asn Autonomous system number (ASN).
as Autonomous system (AS) name.
lastSeen Proxy last seen in days.
threat Security threat reported.
  • (SPAM) Email and forum spammers
  • (SCANNER) Network security scanners
  • (BOTNET) Malware infected devices
provider Name of VPN provider if available.
creditsConsumed Total credit used for current query.
Proxy Type Description Anonymity
VPN Anonymizing VPN services. These services offer users a publicly accessible VPN for the purpose of hiding their IP address. High
TOR Tor Exit Nodes. The Tor Project is an open network used by those who wish to maintain anonymity. High
DCH Hosting Provider, Data Center or Content Delivery Network. Since hosting providers and data centers can serve to provide anonymity, the Anonymous IP database flags IP addresses associated with them. Low
PUB Public Proxies. These are services that make connection requests on a user\'s behalf. Proxy server software can be configured by the administrator to listen on some specified port. These differ from VPNs in that the proxies usually have limited functions compare to VPNs. High
WEB Web Proxies. These are web services that make web requests on a user\'s behalf. These differ from VPNs or Public Proxies in that they are simple web-based proxies rather than operating at the IP address and other ports level. High
SES Search Engine Robots. These are services that perform crawling or scraping to a website, such as, the search engine spider or bots engine. High
RES Residential proxies. These services offer users proxy connections through residential ISP with or without consents of peers to share their idle resources.
Only available with PX10 & PX11
Free Trial

You can try out our web service by signing up for our free trial key which will entitle you to an one-time 1,000 free credits.

Example to perform proxy lookup:


Example to check remaining credits:

The remaining credits returned in this API is not updated in realtime but with a 10-minute delay.

Sign Up For a Trial Key


There are 11 packages of proxy detection web services available. Each package returns a different set of IP address information with different amounts of credits deducted for each query.

Package Information Returned Credit
Country Code, Country Name, Is Proxy 1 credit
Country Code, Country Name, Is Proxy, Proxy Type 2 credits
Country Code, Country Name, Is Proxy, Proxy Type, Region, City 3 credits
Country Code, Country Name, Is Proxy, Proxy Type, Region, City, ISP 4 credits
Country Code, Country Name, Is Proxy, Proxy Type, Region, City, ISP, Domain 5 credits
Country Code, Country Name, Is Proxy, Proxy Type, Region, City, ISP, Domain, Usage Type 6 credits
Country Code, Country Name, Is Proxy, Proxy Type, Region, City, ISP, Domain, Usage Type, ASN 7 credits
most popular product
Country Code, Country Name, Is Proxy, Proxy Type, Region, City, ISP, Domain, Usage Type, ASN, Last Seen 8 credits
Country Code, Country Name, Is Proxy, Proxy Type, Region, City, ISP, Domain, Usage Type, ASN, Last Seen, Threat 9 credits
Country Code, Country Name, Is Proxy, Proxy Type, Region, City, ISP, Domain, Usage Type, ASN, Last Seen, Threat, Residential 10 credits
Country Code, Country Name, Is Proxy, Proxy Type, Region, City, ISP, Domain, Usage Type, ASN, Last Seen, Threat, Residential, Provider 11 credits
Sample Code
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://api.ip2proxy.com/?' . http_build_query([
	'ip'      => '',
	'key'     => 'YOUR_API_KEY',
	'package' => 'PX11',

curl_setopt($ch, CURLOPT_FAILONERROR, 1);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, 0);
curl_setopt($ch, CURLOPT_TIMEOUT, 10);

$response = curl_exec($ch);

try (java.util.Scanner s = new java.util.Scanner(new java.net.URL("https://api.ip2proxy.com/?ip={YOUR_API_KEY}&package=PX11").openStream(), "UTF-8").useDelimiter("\\A")) {
} catch (java.io.IOException e) {
Dim httpClient As New System.Net.Http.HttpClient
Dim response As String = Await httpClient.GetStringAsync("https://api.ip2proxy.com/?ip={YOUR_API_KEY}&package=PX11")
var httpClient = new HttpClient();
var response = await httpClient.GetStringAsync("https://api.ip2proxy.com/?ip={YOUR_API_KEY}&package=PX11");
from requests import get

response = get('https://api.ip2proxy.com/?ip={YOUR_API_KEY}&package=PX11').text
curl -s "https://api.ip2proxy.com/?ip={YOUR_API_KEY}&package=PX11"
require "net/http"

response = Net::HTTP.get(URI("https://api.ip2proxy.com/?ip={YOUR_API_KEY}&package=PX11"))
puts response
Web Service Query Example



    "response": "OK",
    "countryCode": "JP",
    "countryName": "Japan",
    "regionName": "Tokyo",
    "cityName": "Tokyo",
    "isp": "Amazon Technologies Inc.",
    "domain": "amazon.com",
    "usageType": "DCH",
    "asn": "14618",
    "as": "Amazon.com Inc.",
    "lastSeen": 20,
    "proxyType": "DCH",
    "isProxy": "NO",
    "threat": "SPAM",
    "provider": "NordVPN",
	"creditsConsumed": 11



    <isp>Japan Network Information Center</isp>
    <as>Amazon.com Inc.</as>