Overview

IP2Proxy detects whether an IP address is being used through a proxy, VPN, Tor exit node, or other anonymizer service. It helps developers flag suspicious traffic and enforce geo-restrictions more accurately. The service returns a simple JSON response indicating the proxy type and threat level.

Beginner Tip

Use the demo key to make a quick test call before purchasing credits. The free tier supports basic proxy detection; advanced threat classifications like residential proxies require a paid plan.

Available Data

The kind of data this API exposes, based on its documentation. We could not call the endpoint to confirm the exact field names.

IP address information
geographic location
ASN and ISP data

Example Response

Illustrative shape only — we were not able to call this endpoint (it requires credentials or exposes no public sample URL), so the fields below show the kind of data this API returns rather than a recorded response.

JSON Response · Illustrative
{
  "status": "success",
  "data": {
    "result": "Data from IP2Proxy",
    "description": "Detect proxy and VPN using IP address",
    "timestamp": "2025-01-15T10:00:00Z"
  }
}

Field Reference

isProxy Indicates if the IP is a proxy: YES, NO, or - (unknown).
proxyType Type of proxy detected, such as VPN, TOR, DCH (data center), or - if none.
countryCode Two-letter ISO country code of the IP address.
isp Name of the Internet Service Provider associated with the IP.
threat Threat level classification such as SPAM or - if no threat is detected.

Implementation Example

Calls a real endpoint of this API. Replace any placeholder credentials with your own key.

Request
const url = "https://api.ip2proxy.com/?key=YOUR_API_KEY&ip=8.8.8.8&package=PX1&format=json";
// Replace headers or query params with the values required by this API.
const response = await fetch(url, {
  headers: {
  "X-API-Key": "YOUR_API_KEY"
  }
});
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
const data = await response.json();
console.log(data);

What Can You Build?

Note: These code examples are AI-generated and unverified. Always refer to the official API documentation for accurate usage.

Common Errors & Troubleshooting

Generated guidance based on this API's documentation, not observed by us. Treat it as a starting point and check against the provider's own error reference.

INVALID API KEY The key query parameter is missing or contains a typo.
Copy your key from the IP2Proxy dashboard and ensure no extra spaces are included.
INVALID PACKAGE The package parameter specifies a tier you do not have access to.
Start with PX1 (basic) and upgrade to PX11 for more detailed proxy classification.
Unexpected field values (-) The IP is not in the proxy database or the field is not available at your package level.
A "-" response means no proxy detected or the data is unavailable; this is normal for clean IPs.

Metadata Score Breakdown

Estimated from metadata — endpoint not independently tested

This score is estimated from observable metadata — HTTPS support, authentication model, declared CORS, and documentation reachability — because the API requires authentication or exposes no publicly testable endpoint. The five-signal breakdown is only shown for live-tested APIs.

Metadata estimate · endpoint not independently tested

Technical Specifications

Auth API Key
HTTPS REQUIRED
CORS UNKNOWN
Category Geocoding
Difficulty Intermediate
Listing details not endpoint-verified

Related Tags

Similar APIs

View All →