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 Standard Residential or Premium 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:5499" \
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-ttl-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.