soxway

API Docs

Bulk proxy checker · liveness, protocol, latency, anonymity, exit-IP geo / ASN, residential / mobile / datacenter classification, site reachability and composite rating. WebSocket streaming.

Base URL:https://checker.soxway.io

Authentication

The public endpoints accept either of these credentials, or no credentials at all.

  • Authorization: Bearer <api_key> — programmatic use. Rotate from /account/api.
  • Cookie: soxway_session=… — set by /login automatically, used by the web UI.
  • Anonymous — allowed for /check, /jobs/{id}, /archive, /rating. Rate-limited per IP.

Quickstart

curl -X POST https://checker.soxway.io/api/v1/check \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -d '{
    "proxies": "http://1.2.3.4:8080\nsocks5://5.6.7.8:1080",
    "type": "full",
    "timeout": 10,
    "sites": ["google.com","youtube.com"]
  }'

Response: { "job_id": "…", "total": 2 }. Subscribe to the WebSocket/api/v1/jobs/{job_id}/stream for live results.

Endpoints

POST/api/v1/checkcookie · api key · anon

Submit a job — Parse the proxy list, return a job_id.

GET/api/v1/jobs/{id}cookie · api key · anon

Job summary — Status, totals, alive counter.

GET/api/v1/jobs/{id}/resultscookie · api key · anon

List results — Filter by alive / country / ip_type / protocol / anonymity.

WS/api/v1/jobs/{id}/streamcookie · api key · anon

Live stream — One JSON ProxyResult per WebSocket text frame.

GET/api/v1/archiveanonymous

Daily archive list — Dates with totals of public alive proxies.

GET/api/v1/archive/{date}anonymous

Day snapshot — Best-rated unique proxies seen on the date.

GET/api/v1/ratinganonymous

Top by rating — Window=days. Filter by country / ip_type / protocol.

POST/api/v1/auth/registeranonymous

Register — Creates an account and an initial API key.

POST/api/v1/auth/loginanonymous

Login — Sets the HttpOnly session cookie.

POST/api/v1/auth/logoutcookie · api key · anon

Logout — Revokes the current session.

GET/api/v1/mecookie · api key · anon

Current user — Cookie or Bearer.

GET/api/v1/keyscookie

API key metadata — Returns prefix + last_used_at — never the full key.

POST/api/v1/keys/rotatecookie

Rotate API key — Revokes the current one and returns the new plain key once.

GET/api/v1/jobscookie · api key · anon

List my jobs — Cookie or Bearer.

Full schema, parameter types and response shapes are in the openapi.yaml — drop it into Stoplight, Insomnia or any OpenAPI 3 viewer.

soxway · built for developers, scrapers and arbitrage