API Documentation

REST endpoints and WebSocket for proxy checking, IP scoring, and format conversion.

Quick Start

Start checking proxies in seconds

bash

curl https://socksproxies.com/api/check \
  -X POST -H "Content-Type: application/json" \
  -d '{"proxies": ["IP:PORT"], "timeout": 5000}'

Authentication

API key in header (coming soon)

Public beta currently open. Rate limits apply per IP address. Enterprise keys with higher limits available.

Endpoints

POST/api/check

Bulk check proxies for status (alive/dead), response latency, anonymity level (elite/anonymous/transparent), and geographic location

Rate limit: 100 requests/minute

GET/api/score/:ip

Get comprehensive IP anonymity analysis including WebRTC leak risk, header exposure score, and IP reputation data

Rate limit: 60 requests/minute

POST/api/convert

Transform proxy lists between formats: JSON for APIs, Clash config for proxy clients, cURL for shell scripts

Rate limit: 50 requests/minute

WebSocket/ws/check

Stream real-time results as each proxy check completes. Ideal for large batch operations with live progress updates

Rate limit: 10 concurrent connections

Code Examples

cURL

bash

curl -X POST https://socksproxies.com/api/check \
  -H "Content-Type: application/json" \
  -d '{
    "proxies": ["103.152.112.120:1080", "185.162.231.166:1080"],
    "timeout": 5000
  }'

Python

python

import requests

response = requests.post(
    "https://socksproxies.com/api/check",
    json={
        "proxies": ["103.152.112.120:1080", "185.162.231.166:1080"],
        "timeout": 5000
    }
)
results = response.json()

Node.js

javascript

const response = await fetch('https://socksproxies.com/api/check', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    proxies: ['103.152.112.120:1080', '185.162.231.166:1080'],
    timeout: 5000
  })
});
const results = await response.json();

Response Format

json

{
  "success": true,
  "results": [
    {
      "proxy": "103.152.112.120:1080",
      "status": "alive",
      "latency": 245,
      "anonymity": "elite",
      "country": "US",
      "ip_score": 85
    }
  ],
  "checked_at": "2025-01-06T12:00:00Z"
}