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 ttl minutes.

# Sticky for 10 minutes
aethyn-d9e2c-country-us-session-a3xq-ttl-10

# Different session ID = different exit
aethyn-d9e2c-country-us-session-b9k2-ttl-30

Session IDs are arbitrary strings — your code generates them. Two requests with the same session-ID within the TTL window will use the same exit IP.

TTL

Sticky sessions live for 1–30 minutes. Default is 10 minutes if not specified.

# 5 minute sticky
...-session-X-ttl-5

# 30 minute sticky (max)
...-session-X-ttl-30

Order

Suffixes can be combined freely but should follow this order for clarity: base · country · city · isp · session · ttl.