API Version 1.0

REST API Guide

Automate your proxy workflow with our developer-first REST API. High-speed, secure, and reliable programmatic access to all your proxy assets.

✓ REST / JSON✓ API Key Auth✓ <100ms Latency

Authentication

All API requests must include your API key in the X-API-Key HTTP header. Keys can be generated and managed from the Dashboard → API Management tab.

bash

curl -X GET \
     "https://178.104.83.44:8789/api/v1/balance" \
     -H "X-API-Key: zp_your_api_key_here"

⚠️

Missing or invalid keys return 401 Unauthorized. Keep your API key secret and never expose it in client-side code.

API Endpoints

GET/v1/proxies

Returns a list of all active proxies assigned to your account, including connection credentials and status.

Example Response

json

[
  {
    "id": "3c90e1ab-...",
    "ip": "185.101.92.4",
    "port": 5001,
    "username": "proxy_user",
    "password": "••••••••",
    "status": "active"
  }
]

POST/v1/proxies/{id}/rotate

Triggers an immediate IP rotation for the specified proxy. Equivalent to pressing 'Rotate' in your dashboard. The new IP is returned once the rotation completes.

bash

curl -X POST \
     "https://178.104.83.44:8789/api/v1/proxies/3c90e1ab-.../rotate" \
     -H "X-API-Key: zp_your_api_key_here"

GET/v1/balance

Returns your current real-time account balance in EUR. Useful for billing integrations and low-balance monitoring.

json

{
  "balance": 12.50,
  "currency": "EUR"
}

SDK Examples

🐍Python (Requests)

python

import requests

API_KEY = 'zp_your_key_here'
BASE_URL = 'https://178.104.83.44:8789/api/v1'
HEADERS = {'X-API-Key': API_KEY}

# List all proxies
response = requests.get(f{BASE_URL}/proxies', headers=HEADERS)
print(response.json())

# Rotate a proxy
proxy_id = '3c90e1ab-...'
requests.post(f{BASE_URL}/proxies/{proxy_id}/rotate', headers=HEADERS)

⚡Node.js (Axios)

javascript

const axios = require('axios');

const apiKey = 'zp_your_key_here';
const baseUrl = 'https://178.104.83.44:8789/api/v1';
const headers = { 'X-API-Key': apiKey };

// List proxies
axios.get(`${baseUrl}/proxies`, { headers })
  .then(res => console.log(res.data));

// Rotate a proxy
axios.post(`${baseUrl}/proxies/3c90e1ab-.../rotate`, {}, { headers })
  .then(res => console.log('Rotated!', res.data));