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 |
state
State or province. Requires country.
Format: lowercase, underscores for spaces (new_york, california)
city
City name. Requires country.
Format: lowercase, underscores for spaces (los_angeles, new_york)
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 |
ttl
Session duration in minutes (1-60). Default: 30.
timeout
Connection timeout in seconds (1-120). Default: 30.
Complete Example
sub_xxx-country-US-state-california-city-los_angeles-session-task01-ttl-15-timeout-60:[email protected]:1318
