Official SDK

Build proxy URLs without fragile username strings

proxy-builder-sdk — typed API for country, city, sticky session, and lifetime targeting.

MIT LicenseZero dependenciesnpmPyPI
Node.js
npm install proxy-builder-sdk
Python
pip install proxy-builder-sdk

Why

Targeting lives in the proxy username — easy to get wrong without help.

Aethyn encodes targeting inside the proxy username — country, city, ISP, a sticky-session id, and a lifetime. It's powerful but easy to get subtly wrong (a stray dash in a session id silently corrupts the whole thing, and city/ISP only work on the Elite tier). This SDK gives you a typed, validated API and keeps the wire format an internal detail, so if Aethyn ever changes the username scheme, you just upgrade the package — your code doesn't move.

Languages

Pick your SDK.

Node.js and Python packages on npm and PyPI with Playwright helpers and multi-provider support.

Benefits

Why use the SDK.

Validated targetingThe SDK throws on Elite-only params on Premium — no silent username corruption from a stray dash in a session id.
Ports handledPremium 2099/1099 and Elite 5499/3499 are picked automatically for HTTP and SOCKS5.
Upgrade-safeThe wire format is internal. If Aethyn changes the username scheme, bump the package — your code doesn't move.
SDK optional

Aethyn speaks standard user:pass@host:port from any HTTP client. The SDK is optional sugar for typed URL building.

Read the quickstart →

Multi-provider support

Aethyn is the default, but the same clean API drives other big residential providers too — use ProxyClient with a provider:

ProviderGatewayNotes
aethyn (default)proxy.aethyn.ioPremium/Elite tiers, city/ISP/state/zip
brightdatabrd.superproxy.iopass brd-customer-<id>-zone-<zone> as the username
oxylabspr.oxylabs.iocc/sessid/sesstime; state as us_california
smartproxy / decodogate.decodo.comsessionduration (minutes)
iproyalgeo.iproyal.comtargeting goes in the password
soaxproxy.soax.com⚠️ community-verified; lifetime in seconds
netnutgw.netnut.netcountry + sticky session only

Every non-Aethyn dialect was verified against the provider's official docs (each provider file records the source URL and a confidence level). SOAX is medium confidence — sanity-check it against SOAX's current docs before you lean on it. Each provider maps the same semantic call (country, city, state, session, ttl) to its own username/password format and throws a clear error for anything it can't express.

License: MIT

Docs, integrations & compare