Use the TTL parameter when you want a residential proxy to keep the same IP for a period of time. This is useful for continuous logins, multi-step account activity, or any browsing session that should remain in the same location.
What TTL Means for You
TTL is how long you want the current IP to remain unchanged, measured in minutes. After extracting a proxy, add -ttl-minutes to the end of the complete proxy username.
Parameter format: -ttl-{minutes}
Example: -ttl-60 requests a 60-minute sticky session.
Supported Ranges
| Targeting level | Valid TTL range | Details |
| Country or region | 1–1440 minutes | Supports sticky sessions of up to 24 hours |
| State or city | 1–120 minutes | The maximum TTL is 120 minutes when state- or city-level targeting is used |
Invalid values: ttl-0, ttl-1441, and values outside the range supported by the selected targeting level will not create a valid session. TTL must be an integer.
How to Add a TTL Parameter
1. On the QuarkIP Residential Proxy page, select a country or region. Select a state or city if more precise targeting is required, and set Rotation to Sticky.
2. Select HTTP or SOCKS5, choose the required quantity, and click “Extract.”
3. Find the complete proxy username in the extracted details and add the TTL parameter at the end. You do not need to change the host, port, or password.
Original username:
customer-authuser-country-US-sessid-example
Username with a 60-minute TTL:
customer-authuser-country-US-sessid-example-ttl-60
4. Enter the host, port, complete modified username, and password in BitBrowser or your preferred proxy tool. Keep everything in the original username and only add the TTL value at the end.
5. Open the browser and visit an IP-checking website. Check again later; during the TTL period, the system attempts to retain the same exit IP.
TTL Examples
-ttl-30: Requests a session of about 30 minutes for short logins or ordinary browsing
-ttl-60: Requests a session of about 60 minutes for longer account workflows or tests
-ttl-120: Requests a session of about 120 minutes and is the maximum for state- or city-level targeting
-ttl-1440: Requests a session of up to 24 hours and is available only for country- or region-level targeting; actual stability depends on exit-resource availability
Stability and Limitations
- TTL is the requested IP retention time. It cannot guarantee that the IP will remain available for the full period under every condition.
- Residential proxy sessions use real residential devices. A device may go offline, and availability can be affected by the exit country, time of use, and network congestion.
- TTL values of 120 minutes or less generally provide better availability. Longer country-level TTL values are supported, but the actual retention result depends on the proxy resources available at the time.
- If the proxy cannot connect, return to QuarkIP and extract a new proxy. Then configure your tool with the new complete username.
- After the TTL expires, reopening a page or reconnecting may return a new exit IP. Extract another proxy and set a new TTL if you need another sticky period.
