M
API Matrix

IP2Proxy API

Geocoding / API Key Intermediate HTTPS
Varies by plan (check documentation)
77 Score
Grade B
Visit Official Site Compare Alternatives

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

IP address information
geographic location
ASN and ISP data

Example Response

JSON Response 
{
  "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 

const url = "https://www.ip2location.com/web-service/ip2proxy";
// 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

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.

Matrix Score Breakdown

🌐 Reachability 30/30
⚡ Speed 10/20
🔒 Security 15/15
🛠 Developer XP 12/20
✓ Reliability 10/15

Partially tested on Apr 5, 2026

Technical Specifications

Auth API Key
HTTPS REQUIRED
CORS UNKNOWN
Category Geocoding
Difficulty Intermediate
Verified: 2026-04-04

Similar APIs

View All →

Actinia Grass GIS

0

Actinia Grass GIS provides programmatic access to actinia is an open source rest api for geographical data that uses grass gis via REST API.

API Key Intermediate HTTPS

Apiip

82

Apiip is an IP geolocation API that returns detailed location data including city, country, timezone, and currency for any IP address.

API Key Intermediate HTTPS

Battuta

22

Battuta is a hierarchical location API that lets you browse countries, regions, and cities in a cascade, making it easy to build location pickers with dependent dropdowns.

API Key Intermediate

BigDataCloud

⭐ Beginner's Pick
77

BigDataCloud offers a fast and highly accurate IP geolocation API that also includes network security checks and a confidence area metric to indicate how precise the location is.

API Key Intermediate HTTPS

Bing Maps

87

Bing Maps (now Azure Maps) is Microsoft's mapping platform that lets you geocode addresses, reverse geocode coordinates, get routes, and embed interactive maps in your applications.

API Key Intermediate HTTPS