Build proxy URLs without fragile username strings
proxy-builder-sdk — typed API for country, city, sticky session, and lifetime targeting.
npm install proxy-builder-sdkpip install proxy-builder-sdkWhy
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.
Pick your SDK.
Node.js and Python packages on npm and PyPI with Playwright helpers and multi-provider support.
Why use the SDK.
Aethyn speaks standard user:pass@host:port from any HTTP client. The SDK is optional sugar for typed URL building.
Multi-provider support
Aethyn is the default, but the same clean API drives other big residential providers too — use ProxyClient with a provider:
| Provider | Gateway | Notes |
|---|---|---|
| aethyn (default) | proxy.aethyn.io | Premium/Elite tiers, city/ISP/state/zip |
| brightdata | brd.superproxy.io | pass brd-customer-<id>-zone-<zone> as the username |
| oxylabs | pr.oxylabs.io | cc/sessid/sesstime; state as us_california |
| smartproxy / decodo | gate.decodo.com | sessionduration (minutes) |
| iproyal | geo.iproyal.com | targeting goes in the password |
| soax | proxy.soax.com | ⚠️ community-verified; lifetime in seconds |
| netnut | gw.netnut.net | country + 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