Automate
everything.
Resell our infrastructure under your brand. Plug-and-play billing platform integrations, plus complete REST API references for VPS and proxy provisioning.
Authentication
All API requests require authentication via the X-Reseller-Key header. Same key as the server APIs.
Base URL
Response Format
All endpoints return JSON. Successful responses:
Error responses:
Proxy Types
| Type | Description | Billing |
|---|---|---|
datacenter | Static IPv4/IPv6 proxies in US, CA, FR, UK, NL. HTTP + SOCKS5. | Per proxy, per day (3-365 days) |
residential | Rotating residential IPs. Bandwidth-based, no expiration. | Per GB of bandwidth |
rotating | Rotating IPv6 proxies in Canada. Configurable thread count. | Per duration + thread count |
?action=account
Get reseller account info (balance, discount, payment method).
Example Response
?action=stock
Get datacenter proxy stock by country and IP type. Check this before ordering.
Example Response
?action=price
Calculate price for any proxy type before ordering. Returns your reseller price.
| Parameter | Type | Description |
|---|---|---|
type * | string | datacenter, residential, or rotating |
days | integer | Duration (datacenter: 3-365, rotating: 7/14/30/60/90) |
quantity | integer | Number of proxies (datacenter only, 1-100) |
bandwidth | integer | GB of bandwidth (residential only, 1-1000) |
threads | integer | Thread count (rotating only, 100-5000) |
?action=proxies
List all proxies (datacenter, residential, and rotating) with credentials.
?action=proxy&id={proxy_id}
Get detailed info for a single proxy including credentials and whitelisted IPs.
| Parameter | Type | Description |
|---|---|---|
id * | string | 8-character proxy ID |
?action=create_datacenter
$ PaidOrder datacenter proxies. Returns proxy credentials immediately.
| Parameter | Type | Description |
|---|---|---|
country * | string | US, CA, FR, UK, or NL |
days | integer | 3-365 (default: 30) |
quantity | integer | 1-100 (default: 1) |
ip_type | string | ipv4 or ipv6 (default: ipv4) |
Example Response
?action=create_residential
$ PaidOrder a residential proxy subscription with bandwidth.
| Parameter | Type | Description |
|---|---|---|
bandwidth * | integer | Bandwidth in GB (1-1000) |
?action=create_rotating
$ PaidOrder a rotating IPv6 proxy.
| Parameter | Type | Description |
|---|---|---|
country | string | Currently only CA (default) |
days | integer | 7, 14, 30, 60, or 90 (default: 30) |
threads | integer | 100-5000 (default: 100) |
protocol | string | Currently only ipv6 (default) |
?action=renew&id={proxy_id}
$ PaidRenew a datacenter or rotating proxy. Not applicable to residential (use topup instead).
| Parameter | Type | Description |
|---|---|---|
id * | string | 8-character proxy ID |
days * | integer | Datacenter: 3-365. Rotating: 7/14/30/60/90. |
?action=topup&id={proxy_id}
$ PaidAdd bandwidth to a residential proxy.
| Parameter | Type | Description |
|---|---|---|
id * | string | 8-character proxy ID |
bandwidth * | integer | GB to add (1-1000) |
?action=reset_credentials&id={proxy_id}
Reset proxy username/password. Works for all proxy types. Returns new credentials.
| Parameter | Type | Description |
|---|---|---|
id * | string | 8-character proxy ID |
?action=add_ip&id={proxy_id}
Add an IP to the proxy whitelist (datacenter and rotating only).
| Parameter | Type | Description |
|---|---|---|
id * | string | 8-character proxy ID |
ip * | string | IP address to whitelist |
?action=remove_ip&id={proxy_id}
Remove an IP from the proxy whitelist.
| Parameter | Type | Description |
|---|---|---|
id * | string | 8-character proxy ID |
ip * | string | IP address to remove |
?action=terminate&id={proxy_id}
Permanently delete a proxy (no refund).
| Parameter | Type | Description |
|---|---|---|
id * | string | 8-character proxy ID |
Error Responses
All errors return JSON with success: false and an error message.
401 Unauthorized
404 Not Found
400 Bad Request
PHP Example
<?php
$apiKey = "your_api_key_here";
$baseUrl = "https://servury.com/api/proxy.php";
function apiRequest($endpoint, $apiKey, $method = 'GET', $data = null) {
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $endpoint);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
"X-Reseller-Key: $apiKey",
"Content-Type: application/json"
]);
if ($method === 'POST') {
curl_setopt($ch, CURLOPT_POST, true);
if ($data) {
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
}
}
$response = curl_exec($ch);
curl_close($ch);
return json_decode($response, true);
}
// Check stock before ordering
$stock = apiRequest("$baseUrl?action=stock", $apiKey);
// Get price quote
$price = apiRequest("$baseUrl?action=price&type=datacenter&days=30&quantity=5", $apiKey);
echo "5 proxies for 30 days: $" . $price['data']['total'];
// Order 5 datacenter proxies
$order = apiRequest("$baseUrl?action=create_datacenter", $apiKey, 'POST', [
'country' => 'US',
'days' => 30,
'quantity' => 5,
'ip_type' => 'ipv4'
]);
// List all proxies with credentials
$proxies = apiRequest("$baseUrl?action=proxies", $apiKey);
foreach ($proxies['data']['proxies'] as $p) {
echo "{$p['ip']}:{$p['port_http']} ({$p['type']})\n";
}
// Renew a datacenter proxy
$result = apiRequest("$baseUrl?action=renew&id=abc12345", $apiKey, 'POST', [
'days' => 30
]);
// Top up residential bandwidth
$result = apiRequest("$baseUrl?action=topup&id=xyz98765", $apiKey, 'POST', [
'bandwidth' => 10
]);