All articles
BLOG

Reselling Proxies: Subusers and the Reseller API

Earning & businessUpdated: July 20265 min read

Articles are currently available in English only.

The reseller rank turns your account into a wholesale source of proxy bandwidth. You buy GB from your balance at a wholesale per-GB cost, provision it to subusers you create, and charge your own customers whatever you want — the margin is entirely yours. This guide walks through the model, subuser management in the dashboard, the Reseller API v2, and the rules that come with the rank.

Reselling is a one-time purchase on the Add-ons page; the current price is shown there. Once unlocked, you get a reseller dashboard for creating and managing subusers, plus programmatic access through a dedicated API. Every subuser you provision runs on the same network as your own account: 16M+ residential IPs across 195+ countries, reachable through a single endpoint at <proxy-host>:80 speaking HTTP, HTTPS (CONNECT) and SOCKS5.

This is the hands-on option: you handle your own billing, support, and customer relationships. If you would rather run a branded storefront that does checkout for you, compare the whitelabel program — covered near the end of this article.

01 How the model works

The economics are simple. You top up your USD balance with crypto, and every GB you allocate to a subuser is paid from that balance at a wholesale per-GB cost. What you charge the customer on the other side — flat monthly fee, per-GB markup, bundle pricing — is your decision and your revenue. The platform never touches your customer-facing prices.

Each subuser gets their own auto-generated proxy credentials, separate from yours. Their usage draws down the GB you allocated to them, shown per subuser in the dashboard. Your own balance and GB never expire, so there is no pressure to pre-buy on a schedule.

  • One-time rank unlock on the Add-ons page — no recurring platform fee.
  • Wholesale GB cost is deducted from your balance at allocation time.
  • Subusers are isolated: individual credentials, individual data pools.
  • You own the customer relationship — invoicing, support, and pricing are yours.

02 Managing subusers in the dashboard

The reseller dashboard is where day-to-day provisioning happens. The lifecycle of a subuser looks like this:

  1. 01Create a subuser by entering an email address. Proxy credentials are generated automatically — you pass them on to your customer.
  2. 02Allocate GB to the new subuser. The minimum allocation is 1 GB, and the wholesale cost comes out of your balance immediately.
  3. 03Add data over time as the customer consumes their pool. Top-ups work the same way as the initial allocation.
  4. 04Rotate credentials if a customer's username and password leak. The subuser gets a fresh pair, the old one stops working immediately, and their allocated GB, usage and expiry all carry over. The new password is shown once.
  5. 05Delete the subuser when the relationship ends. Their credentials stop working.

Warning

Reducing a subuser's allocation below 1 GB deletes the subuser entirely. Treat 1 GB as the floor for any account you want to keep alive.

03 Auto-convert keeps allocations moving

Every allocation is ultimately paid from your USD balance at the wholesale per-GB cost. The optional auto-convert setting converts balance into GB automatically, so provisioning a subuser or topping one up does not require a separate manual step in between. If you run any automation against the API, turning this on is strongly recommended.

Note

Auto-convert only works while your balance is funded. Keep an eye on your balance level in the dashboard — an empty balance stops allocations regardless of settings.

04 The Reseller API v2

Everything the reseller dashboard does can be automated. The API lives at base path /api/reseller/v2 and authenticates with an X-Reseller-API-Key header. Requests are accepted from exactly one whitelisted IP — set it before your first call, and update it if your server moves. The key can be regenerated from the dashboard; after regeneration the old key stops working.

  • GET /account — your reseller account state.
  • GET /config — current configuration.
  • GET /subusers — list all subusers.
  • POST /subusers — create a subuser.
  • GET /subusers/<username> — one subuser's details.
  • PATCH /subusers/<username> — adjust a subuser (for example, add data).
  • DELETE /subusers/<username> — remove a subuser.
  • POST /unlimited/purchase — buy an unlimited plan for a subuser.
  • GET /subusers/<username>/unlimited — a subuser's unlimited plan status.

The API is served on the same domain you sign in to the dashboard on:

TERMINAL
curl -H "X-Reseller-API-Key: YOUR_KEY" \
  https://<dashboard-domain>/api/reseller/v2/subusers

Note that this is a separate system from the per-user API that any account can enable — that one has its own key, base path, and rate limits, covered in the user API guide.

05 Unlimited plans for subusers

Besides metered GB pools, you can put subusers on flat-rate unlimited plans through the API. POST /unlimited/purchase buys the plan, and GET /subusers/<username>/unlimited reports its current status — useful for renewal checks in a billing script.

Unlimited plans come in 200 Mbps, 400 Mbps, and 1 Gbps speed tiers. The 200 Mbps tier is hourly only; 400 Mbps and 1 Gbps are available daily, weekly, or monthly. Capacity is slot-limited per tier and can sell out, so a purchase call can fail even with a funded balance — handle that case in your automation. Current prices are on the Unlimited Proxies page.

06 Reseller versus whitelabel

The reseller rank and the whitelabel program solve different problems. As a reseller, the storefront is yours to build: you collect payments from customers however you like, answer their support questions, and provision through the dashboard or API. Maximum control, maximum work.

The whitelabel program instead gives you a fully branded proxy storefront on your own domain — your name, logo, colors, and prices — where the platform runs checkout and provisioning under your brand, and your margin is paid out to you. If you want to sell proxies without operating billing infrastructure, whitelabel is usually the better fit; if you already have customers and your own payment flow, reselling is.

07 Rules and responsibilities

Two rules matter before you buy the rank.

  • Resellers are excluded from the affiliate program. You cannot hold a referral code and the reseller rank on the same account — pick the model that fits how you plan to earn.
  • Your customers' traffic runs on your account. You are responsible for their compliance with the Acceptable Use Policy, including the terms of any site they target. Enforcement against AUP violations can mean suspension without refund — vet your customers accordingly.

Allocated GB is bought with balance, and deposits are non-refundable once credited, so scale allocations with real demand rather than pre-buying heavily. If anything in the reseller flow behaves unexpectedly — a stuck allocation, an API error you cannot explain — contact the support tickets page in your dashboard with your subuser's username and the approximate time of the issue.