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.

bash
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:

bash
# City — append after country
aethyn-d9e2c-country-us-city-newyork

# ISP — append after country (Elite only)
aethyn-d9e2c-country-us-isp-comcast
Note
City and ISP suffixes resolve to the closest available match. If no exit matches, the tunnel falls back to the country.

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.

bash
# 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.

bash
# 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.