Parameters

Append parameters to the username with - delimiter:

{username}-{param}-{value}-{param}-{value}:{password}@{host}:{port}

Quick Reference

Parameter	Values	Default	Description
`country`	ISO 3166-1 alpha-2	random	Country code
`state`	lowercase + underscore	-	State/province (requires country)
`city`	lowercase + underscore	-	City name (requires country)
`session`	4-20 alphanumeric	-	Session ID for sticky IP
`ttl`	1-60	30	Session duration (minutes)
`timeout`	1-120	30	Connection timeout (seconds)

country

ISO 3166-1 alpha-2 country code.

Code	Country	Code	Country
`US`	United States	`JP`	Japan
`GB`	United Kingdom	`DE`	Germany
`CA`	Canada	`AU`	Australia
`FR`	France	`SG`	Singapore

sub_xxx-country-US:pass@gate.turnoxy.com:1318

state

State or province. Requires country. Format: lowercase, underscores for spaces (new_york, california)

sub_xxx-country-US-state-california:pass@gate.turnoxy.com:1318

city

City name. Requires country. Format: lowercase, underscores for spaces (los_angeles, new_york)

sub_xxx-country-US-city-los_angeles:pass@gate.turnoxy.com:1318

# With state for precision
sub_xxx-country-US-state-california-city-los_angeles:pass@gate.turnoxy.com:1318

If city conflicts with state, the system falls back to state-level targeting.

session

Keep the same IP across requests.

Mode	Parameters	Behavior
Rotating	(none)	New IP each request
Sticky	`session`	Same IP for 30 min
Sticky + TTL	`session` + `ttl`	Same IP for specified duration
Timed Rotation	`ttl` only	Auto-rotate every N minutes

# Sticky session
sub_xxx-session-order123:pass@gate.turnoxy.com:1318

# Sticky with custom TTL
sub_xxx-session-order123-ttl-10:pass@gate.turnoxy.com:1318

ttl

Session duration in minutes (1-60). Default: 30.

sub_xxx-session-task01-ttl-15:pass@gate.turnoxy.com:1318

timeout

Connection timeout in seconds (1-120). Default: 30.

sub_xxx-timeout-60:pass@gate.turnoxy.com:1318

Complete Example

sub_xxx-country-US-state-california-city-los_angeles-session-task01-ttl-15-timeout-60:pass@gate.turnoxy.com:1318

See Errors for validation errors.

Getting Started

Authentication

Proxies

Examples

Reference

Quick Reference

country

state

city

session

ttl

timeout

Complete Example

​Quick Reference

​country

​state

​city

​session

​ttl

​timeout

​Complete Example

Quick Reference

country

state

city

session

ttl

timeout

Complete Example