ProxyTracer API

ProxyTracer is a sub-10ms, deterministic proxy, datacenter and VPN detection engine.

We process all IP evaluations entirely in-memory and drop the data the millisecond the request finishes. No shadow databases, no logging, and zero probabilistic guesswork. Just hard data to help you drop malicious traffic at the edge.

Quick Start

You can query the REST API directly using any standard HTTP client. Pass the target IP address in the URL path and your API key in the Authorization header.

Request


curl -X GET "https://api.proxytracer.com/v1/check/109.70.100.3" \
  -H "Authorization: Bearer proxy_······"

Response

Our engine prioritizes latency, returning a predictable, flat JSON object. Parse the proxy boolean to instantly block or challenge the connection.


{
  "ip": "109.70.100.3",
  "proxy": true
}

HTTP Status Codes

Status Code	Description
`200 OK`	Successful evaluation. Returns deterministic classification payload.
`400 Bad Request`	Invalid IP address format or malformed request path.
`401 Unauthorized`	Unauthorized. The API key is missing, expired, or invalid.
`402 Payment Required`	Payment required. Your account has depleted its available API credits.

Code Examples

Node.js (fetch)


const response = await fetch("https://api.proxytracer.com/v1/check/109.70.100.3", {
  headers: {
    "Authorization": `Bearer ${process.env.PROXYTRACER_API_KEY}`
  }
});
 
const data = await response.json();
if (data.proxy) {
  // Block malicious traffic or challenge with Captcha
}

Python (requests)


import os
import requests
 
response = requests.get(
    "https://api.proxytracer.com/v1/check/109.70.100.3",
    headers={"Authorization": f"Bearer {os.getenv('PROXYTRACER_API_KEY')}"},
    timeout=1.0
)
 
data = response.json()
if data.get("proxy"):
    # Reject or flag connection
    pass

Official Integrations

We provide drop-in middleware and interceptors for the most common enterprise frameworks and edge runtimes.

For maximum performance and security, we strongly recommend deploying ProxyTracer at the Edge (Cloudflare, AWS, or Next.js) to drop malicious connections before they ever reach your origin servers.

Edge Compute

Platform	Environment	Integration Guide
Cloudflare	Edge CDN	Cloudflare Workers
AWS	Edge CDN	Lambda@Edge
Next.js	Edge Runtime	Middleware

Backend Runtimes

Platform	Language	Integration Guide
Express	Node.js	Express Middleware
Go	Go	net/http Handler
Django	Python	Django Middleware
FastAPI	Python	BaseHTTPMiddleware
ASP.NET Core	C#	HTTP Middleware
Spring Boot	Java	HandlerInterceptor
Laravel	PHP	HTTP Middleware
Ruby on Rails	Ruby	Rack Middleware