Skip to content

ProxyRequest platform documentation

ProxyRequest is the operating layer between proxy supply and the product your customers use. These guides cover both traffic connectivity and the control-plane workflows required to run a reseller platform.

CHOOSE A PATH

Start with the workflow you operate

Direct customer

Connect applications to proxy gateways, generate credentials, and inspect your own traffic and sessions.

Make a proxy request →

Reseller platform

Provision sub-users, allocate bytes, generate proxy access, and keep your billing system synchronized.

Build the reseller flow →
OPERATING MODELOne control plane, four integration surfaces
01SupplyProviders and pools
02ProxyRequestProducts, users, limits
GatewaysHTTP and SOCKS5
Platform APIProvision and automate
AnalyticsReconcile usage
WebhooksReact to balance events

Proxy gateways

Route HTTP, HTTPS, SOCKS5, and SOCKS5h traffic with package credentials, geographic targeting, and sticky-session tokens.

Platform API

Manage users, orders, data allocation, proxy generation, analytics, API keys, and webhook destinations.

Accounting

Treat bytes as the shared unit across balances, child-order limits, analytics, and usage events.

Event delivery

Receive signed batches when user or order balances change, then reconcile them against analytics.

The same identifiers appear in several API areas. Keep them in your own data model instead of inferring relationships from usernames.

ResourceWhat it representsWhere it is reused
Main userThe authenticated customer or reseller accountProfile, packages, orders, analytics
Sub-userA customer managed by a resellerData allocation, user orders, usage events
PackageA proxy product and its targeting capabilitiesOrders, locations, generation
OrderPurchased or assigned access to a packageCredentials, balances, analytics
LedgerThe accounting balance used by traffic processingWebhook events and reconciliation
  1. Keep secrets server-side. Proxy passwords, JWTs, API keys, and webhook secrets do not belong in browsers or public repositories.
  2. Store identifiers. Persist user, package, order, and ledger IDs alongside your own customer IDs.
  3. Send allocation values in bytes. Convert explicitly and avoid an ambiguous GB label in business logic.
  4. Cache catalogs, not balances. Package and location metadata change less frequently than usage state.
  5. Use webhooks for reaction and analytics for reconciliation. Event delivery reduces polling; analytics remains the reporting surface.