Developer API

Integrate proxy management into your applications with our RESTful API

Authentication

All API requests require your API key, which can be found in your dashboard settings. Include it in the request header:

# Example request curl -H "X-API-Key: YOUR_API_KEY" \ https://cheapipv4proxy.cc/api/v1/proxies

Endpoints

Get All Proxies

GET /api/v1/proxies

Returns all active proxies for your account.

// Response { "success": true, "proxies": [ { "id": 123, "ip": "185.81.112.215", "https_port": "49162", "socks5_port": "49163", "country": "USA", "login": "user123", "password": "pass456", "status": "active", "expires_at": "2026-08-17T23:59:38Z" } ] }

Get Proxy by ID

GET /api/v1/proxies/{id}

Get Orders

GET /api/v1/orders

Get Pricing

GET /api/v1/pricing?type=ipv4

Returns available pricing tiers and lease periods for the specified proxy type.

Export Proxies

GET /api/v1/proxies/export?format=txt

Export all active proxies. Supported formats: txt, csv.

# TXT format: ip:port:login:password 185.81.112.215:49162:user123:pass456 185.81.112.216:49164:user123:pass456

Rate Limits

API requests are limited to 60 requests per minute. If you exceed this limit, you'll receive a 429 Too Many Requests response. Please implement appropriate retry logic with exponential backoff.

Error Handling

// Error response format { "success": false, "error": { "code": "INVALID_API_KEY", "message": "The provided API key is invalid or expired." } }

Common error codes: INVALID_API_KEY, RATE_LIMIT_EXCEEDED, NOT_FOUND, SERVER_ERROR

SDK Examples

PHP

$ch = curl_init('https://cheapipv4proxy.cc/api/v1/proxies'); curl_setopt($ch, CURLOPT_HTTPHEADER, [ 'X-API-Key: YOUR_API_KEY', 'Accept: application/json' ]); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); $response = json_decode(curl_exec($ch), true); curl_close($ch);

Python

import requests response = requests.get( 'https://cheapipv4proxy.cc/api/v1/proxies', headers={'X-API-Key': 'YOUR_API_KEY'} ) proxies = response.json()['proxies']

Node.js

const response = await fetch('https://cheapipv4proxy.cc/api/v1/proxies', { headers: { 'X-API-Key': 'YOUR_API_KEY' } }); const { proxies } = await response.json();

Ready to Start Building?

Get your API key from the dashboard and start integrating

Create Account