Skip to main content
By default, each request to our proxy server generates a new IP address. However, you can use session parameters to maintain the same IP address for multiple requests. This feature is useful for tasks that require a stable connection, such as web resources with session-based authentication.
Session Parameters We offer the session parameter to ensure you keep the same IP for all following requests.

​
Thesessionparameter

  • A unique alphanumeric string, 6 to 15 characters long.
  • Optimized for the highest overall success rate.
  • May change IP address in favor of stability.
  • Works with the lifetime parameter.
When specifying any geo targeting parameters, the first request will use the specified parameters, and all subsequent requests will use the same IP address. If you change the targeting while maintaining the same session, the IP address will remain the same.

​
Thelifetimeparameter

  • Specifies the duration for the session in minutes.
  • Maximum value is 120 minutes.
  • After the specified time, the IP address will change.
  • If not specified, the session will last for 40 minutes by default.
If you specify a higher lifetime value than the maximum allowed, the request will return a 412 error code.

​
Examples

Below are examples of using Sticky sessions in different programming languages: CURL, Python, and JavaScript.
  • CURL
  • Python
  • Javascript
# Using session parameter
curl -x USERNAME-session-abc123:[email protected]:7776 https://ipecho.net/plain

# Using session with lifetime (60 minutes)
curl -x USERNAME-session-abc123-lifetime-60:[email protected]:7776 https://ipecho.net/plain

# Session with geo targeting
curl -x USERNAME-cc-US-session-abc123:[email protected]:7776 https://ipecho.net/plain