Proxies, from code.

GET/catalog

Prices, allowed values and current datacenter stock. No key needed.

curl https://ghostconnect.io/api/v1/catalog

{
  "ok": true,
  "data": {
    "currency": "USD",
    "pays_from": "balance",
    "products": {
      "datacenter": { "price_per_ip_per_31_days_usd": "1.79", "days": [7, 14, 31, ...], "stock": { "ipv4": { "us": 120, ... } } },
      "residential": { "price_per_gb_usd": "2.99", ... },
      "rotating": { ... },
      "isp": { "use_cases": { "us": ["pkc", "ticket", ...] }, ... }
    }
  }
}

GET/account

The account this key belongs to and its balance.

curl -H "Authorization: Bearer $GT_KEY" https://ghostconnect.io/api/v1/account

{
  "ok": true,
  "data": { "id": 48, "balance_usd": "133.68", "created_at": 1789350000, "api_keys": 1 }
}

POST/quote

The exact price of an order, renewal or top-up, without buying it. Takes kind plus the same fields as the matching purchase; renewals and top-ups also take the proxy id.

curl -X POST -H "Authorization: Bearer $GT_KEY" -H "Content-Type: application/json" \
  -d '{"kind":"isp","country":"us","use_case":"social","months":1,"quantity":2}' \
  https://ghostconnect.io/api/v1/quote

{
  "ok": true,
  "data": {
    "kind": "isp",
    "description": "ISP x2, US, 1 month",
    "amount_usd": "10.00",
    "lines": { "Country": "United States", "Use case": "Social media", "Term": "1 month", "IPs": 2 },
    "balance_usd": "133.68",
    "balance_covers": true
  }
}

POST/orders

Buy proxies. Pays from the balance and returns 201 with the invoice and the new proxies, credentials included, in the same response. Send an Idempotency-Key.

curl -X POST -H "Authorization: Bearer $GT_KEY" \
  -H "Idempotency-Key: order-dc-0001" \
  -H "Content-Type: application/json" \
  -d '{"type":"datacenter","country":"us","ip_type":"ipv4","days":31,"quantity":2}' \
  https://ghostconnect.io/api/v1/orders

{
  "ok": true,
  "data": {
    "invoice": {
      "id": "d3z0sya3", "type": "proxy_datacenter_create",
      "description": "Datacenter IPv4 x2, US, 31 days", "amount_usd": "3.58",
      "payment_method": "balance", "status": "completed",
      "proxy_type": "datacenter", "proxy_id": "k2m9x4qa",
      "created_at": 1789350000, "paid_at": 1789350000, "completed_at": 1789350003
    },
    "proxies": [
      {
        "id": "k2m9x4qa", "type": "datacenter", "created_at": 1789350003,
        "country": "us", "ip_type": "ipv4", "ip": "203.0.113.121",
        "port_http": 10242, "port_socks5": 10243,
        "username": "dxq8m2p", "password": "Zk4pQ9wLr2mT7c",
        "allowlist": [], "expires_at": 1792028403,
        "auto_renew": { "enabled": false, "days": 31 }
      },
      { "id": "p7c1v0ne", ... }
    ],
    "balance_usd": "130.10"
  }
}

Residential proxies come back with a host, credentials and bandwidth in GB. Rotating proxies come back with host, port and threads, and authorise by the allowlist. ISP orders come back as one object with an ips array.

GET/proxies

Every proxy on the account, oldest first, in the same shape as orders returns. Filter with ?type=. GET /proxies/{type}/{id} returns one as {"proxy": ...}; for ISP, the id of any IP in an order returns the whole order.

curl -H "Authorization: Bearer $GT_KEY" "https://ghostconnect.io/api/v1/proxies?type=residential"

POST/proxies/{type}/{id}/renew

Add time to a datacenter, rotating or ISP proxy. An ISP renewal covers every IP in the order. Returns the invoice and the updated proxy. Send an Idempotency-Key: a renewal is not undone by retrying, it is repeated.

curl -X POST -H "Authorization: Bearer $GT_KEY" -H "Idempotency-Key: renew-k2m9x4qa-2026-10" \
  -H "Content-Type: application/json" -d '{"days":31}' \
  https://ghostconnect.io/api/v1/proxies/datacenter/k2m9x4qa/renew

POST/proxies/residential/{id}/topup

Add bandwidth to a residential proxy. Returns the invoice and the updated proxy.

curl -X POST -H "Authorization: Bearer $GT_KEY" -H "Idempotency-Key: topup-0001" \
  -H "Content-Type: application/json" -d '{"gb":10}' \
  https://ghostconnect.io/api/v1/proxies/residential/obcl4126/topup

POST/proxies/{type}/{id}/allowlist

Allow a source address to use a datacenter, residential or rotating proxy without the password. POST /proxies/{type}/{id}/allowlist/remove with the same body removes one. ISP proxies authenticate by username and password only.

curl -X POST -H "Authorization: Bearer $GT_KEY" -H "Content-Type: application/json" \
  -d '{"ip":"198.51.100.7"}' https://ghostconnect.io/api/v1/proxies/rotating/r4t8b2kd/allowlist

POST/proxies/{type}/{id}/auto-renew

Renew automatically from the balance about a day before expiry. For ISP the setting applies to the whole order.

curl -X POST -H "Authorization: Bearer $GT_KEY" -H "Content-Type: application/json" \
  -d '{"enabled":true,"period":31}' https://ghostconnect.io/api/v1/proxies/datacenter/k2m9x4qa/auto-renew

POST/proxies/{type}/{id}/reset-credentials

Issue a new username and password for a datacenter, residential or rotating proxy. The old ones stop working at once. No body.

curl -X POST -H "Authorization: Bearer $GT_KEY" https://ghostconnect.io/api/v1/proxies/datacenter/k2m9x4qa/reset-credentials

GET/proxies/residential/{id}/connection-string

A ready host:port:username:password line with targeting and session built in.

curl -H "Authorization: Bearer $GT_KEY" "https://ghostconnect.io/api/v1/proxies/residential/obcl4126/connection-string?session=sticky&minutes=10&country=de"

GET/invoices

The latest 100 invoices, newest first. GET /invoices/{id} returns one, with the proxies it created. Status is one of completed, credited (paid, not deliverable, refunded to the balance), or a payment state for website payments still in progress.

curl -H "Authorization: Bearer $GT_KEY" https://ghostconnect.io/api/v1/invoices