Documentation

Build on Aethyn

Aethyn is a residential proxy network with a unified endpoint, transparent billing, and targeting baked into the standard username and password format. Use raw proxy auth — or install our optional SDK for typed URL building.

proxy quickstart
curl -x "http://user-country-DE-session-a3f8:<key>@proxy.aethyn.io:2099" \
  https://ifconfig.me

# Same credentials, Elite pool
proxy.aethyn.io:5499
SDK optionalStandard proxy auth from any client, or use proxy-builder-sdk.
One formatTargeting and sessions live in the username string.
Live usageDashboard billing reflects the same request stream.
Guides

Choose a documentation path.

Start with your first request, then add credentials, targeting, protocol choices, and usage billing.

Official SDK

Typed proxy URLs for Node.js and Python.

proxy-builder-sdk builds correct targeting strings with validation, port selection, and Playwright helpers — on npm and PyPI.

Browse SDK docs →
Integrations

Copy-paste proxy setup for your stack.

Step-by-step guides for Python, Node.js, Playwright, Scrapy, Selenium, and 25+ more tools — with HTTP and SOCKS5 snippets for Premium and Elite.

Browse integrations →
Need something specific?

Talk to us about custom plans or compliance docs.

For 100+ GB plans, dedicated SLA, or compliance documentation, mention custom plan in the subject.

Email support@aethyn.io

We read every message and can point you to the right proxy setup, billing path, or integration guide.