Quickstart
Send your first request through the Aethyn tunnel in three steps. The whole flow takes under a minute once your account is provisioned.
1. Get your credentials
Sign in to the dashboard and open Premium Residential or Elite Residential. Each account has a single set of Aethyn credentials that work across both products — they look like aethyn-XXXXX for the username and a generated password.
2. Make your first request
Aethyn speaks standard username:password@host:port proxy auth. Drop the URL into any HTTP client.
curl -x "aethyn-XXXXX:YOUR_PASSWORD@proxy.aethyn.io:2099" \
https://api.example.com/v1/ordersThat's it. Your request is now exiting through a residential IP. Run it a few times — each request gets a fresh exit by default.
3. Add targeting
Country, city, and session targeting all live in the username. Add suffixes to control where and how your traffic exits.
# Worldwide rotating aethyn-XXXXX # US exit, every request a new IP aethyn-XXXXX-country-us # DE exit, sticky session for 10 minutes aethyn-XXXXX-country-de-session-abc123-lifetime-10
Read the full targeting reference for the complete list of suffixes.
Next
Once you've verified the basics, look into HTTP vs SOCKS5 for protocol choice, and billing for how usage shows up in your dashboard.
Related resources
- Official proxy SDK — proxy-builder-sdk for Node.js and Python — typed URLs, sticky sessions, and Playwright helpers.
- Integrations hub — Copy-paste proxy setup for Python, Node.js, Playwright, Scrapy, and 25+ developer tools.
- Python Requests — Copy-paste proxy config for scripts and notebooks.
- cURL — Verify your exit IP and credentials from the terminal.
- Solution guides — Step-by-step how-to guides for scraping, monitoring, and automation with residential proxies.