Targeting
Country, city, ISP, and session control — all expressed as suffixes on the username. No SDK required; works with any HTTP client that supports proxy auth.
Country
Append -country-XX using the lowercase ISO 3166-1 alpha-2 code.
aethyn-d9e2c-country-us # United States aethyn-d9e2c-country-de # Germany aethyn-d9e2c-country-jp # Japan
Without a country suffix, exits are drawn worldwide.
City & ISP (Elite only)
Premium routes by country. Elite supports finer granularity:
# City — append after country aethyn-d9e2c-country-us-city-newyork # ISP — append after country (Elite only) aethyn-d9e2c-country-us-isp-comcast
Sessions
By default each request gets a fresh exit. Add -session-ID to pin a request to a sticky exit reusable for the next lifetime minutes.
# Sticky for 10 minutes aethyn-d9e2c-country-us-session-a3xq-lifetime-10 # Different session ID = different exit aethyn-d9e2c-country-us-session-b9k2-lifetime-30
Session IDs are arbitrary strings — your code generates them. Two requests with the same session-ID within the lifetime window will use the same exit IP.
Lifetime
Sticky sessions live for 1–1440 minutes (up to 24 hours). Default is 30 minutes if not specified.
# 5 minute sticky ...-session-X-lifetime-5 # 24-hour sticky (1440 minutes = max) ...-session-X-lifetime-1440
Order
Suffixes can be combined freely but should follow this order for clarity: base · country · city · isp · session · lifetime.
Related resources
- Official proxy SDK — proxy-builder-sdk for Node.js and Python — typed URLs, sticky sessions, and Playwright helpers.
- Proxy locations — Country-level exits across 195+ markets; city/ISP on Elite.
- Sticky sessions — Hold one IP for account workflows and multi-step forms.
- Elite residential proxies — Curated high-trust pool with city and ISP targeting for hard anti-bot targets.
- Integrations hub — Copy-paste proxy setup for Python, Node.js, Playwright, Scrapy, and 25+ developer tools.