Proxy API docs

The REST API lets your code check prices, read your credit and remaining GB, buy traffic and fetch your proxy login. JSON over HTTPS, one Bearer key per account, made on the API key page of the console.

Base URLhttps://gbproxies.cc/api/v1

AuthAuthorization: Bearer gbk_...

Limit300 requests per minute per key

Endpoints

GET /productsKey: NoProducts, prices per GB with volume steps, ports and targeting options.

GET /locations?product=residentialKey: NoCountries and unique IPs seen in 30 days for one product.

GET /balanceKey: YesYour credit in USD and the GB bought, used and left per product.

GET /proxyKey: YesGateway host, your proxy username and password, and the ports of every product.

POST /ordersKey: YesBuy traffic: JSON body {"product": "residential", "gb": 50}. Paid from credit.

GET /ordersKey: YesYour last 50 purchases.

Examples

A purchase answers with the order id, the GB added and the price. Read the proxy login once with GET /proxy and reuse it; it does not change between purchases.

{
  "ok": true,
  "id": "GO-7K2MQX9PLA",
  "product": "residential",
  "gb": 50,
  "price_usd": "30.00",
  "state": "added"
}

curl https://gbproxies.cc/api/v1/products

curl -H "Authorization: Bearer gbk_YOUR_KEY" https://gbproxies.cc/api/v1/balance

curl -X POST -H "Authorization: Bearer gbk_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"product":"residential","gb":50}' https://gbproxies.cc/api/v1/orders

import requests

H = {"Authorization": "Bearer gbk_YOUR_KEY"}
print(requests.get("https://gbproxies.cc/api/v1/balance", headers=H).json())
r = requests.post("https://gbproxies.cc/api/v1/orders", headers=H, json={"product": "residential", "gb": 50})
print(r.status_code, r.json())

const H = { Authorization: "Bearer gbk_YOUR_KEY", "Content-Type": "application/json" };
console.log(await (await fetch("https://gbproxies.cc/api/v1/balance", { headers: H })).json());
const r = await fetch("https://gbproxies.cc/api/v1/orders", { method: "POST", headers: H, body: JSON.stringify({ product: "residential", gb: 50 }) });
console.log(r.status, await r.json());

Errors

Every answer has ok. Errors add error (a stable code) and message. Nothing is charged on any error.

unauthorized401Missing or wrong API key.

bad_product400Unknown product id.

bad_gb400GB outside the product's minimum and maximum.

funds402Not enough credit. need_usd says how much to add. Nothing is charged.

network503The traffic could not be added right now. Nothing is charged; try again later.

rate_limited429More than 300 requests per minute on one key.

Proxy integration guides