Skip to main content
Sessions let you control how long you hold the same residential IP. Two modes:
  • Rotating — every request gets a fresh IP (default)
  • Sticky — the same IP is held for a configurable TTL via a session token

Rotating (default)

Without a session modifier, each request pulls a new IP:
curl -x "http://adminpcowe:maskxsndyb@pr-eu.proxies.fo:13337" https://api.ipify.org
curl -x "http://adminpcowe:maskxsndyb@pr-eu.proxies.fo:13337" https://api.ipify.org
# Each call returns a different IP.
Good for: search scraping, broad crawls, SERP collection — anywhere you want to spread load across many IPs.

Sticky sessions

Append -session-<id> to your username. The <id> is any string you choose — same ID, same IP:
# All three requests exit through the same IP
curl -x "http://adminpcowe-session-5s5d4xud:maskxsndyb@pr-eu.proxies.fo:13337" https://api.ipify.org
curl -x "http://adminpcowe-session-5s5d4xud:maskxsndyb@pr-eu.proxies.fo:13337" https://httpbin.org/headers
curl -x "http://adminpcowe-session-5s5d4xud:maskxsndyb@pr-eu.proxies.fo:13337" https://example.com

Session TTL

Control how long the session holds the same IP with -ttl-<minutes>:
adminpcowe-session-5s5d4xud-ttl-15:maskxsndyb
The session holds for that many minutes from the first request. After the TTL expires, the next request with that session ID starts a new session with a fresh IP. Residential uses ttl-<minutes>. Datacenter uses duration-<seconds> — see Datacenter. If the assigned IP drops off the network before the TTL expires, a new IP is assigned and the session continues seamlessly — no retry needed from your end.

Combining with targeting

Session and TTL stack after country / state / city:
adminpcowe-country-us-city-westlakevillage-session-5s5d4xud-ttl-15:maskxsndyb
That pins a Westlake Village IP for 15 minutes.

Picking session IDs

Use alphanumeric strings, 6–16 characters. Same ID = same IP. Good examples: 5s5d4xud, bot-nyc-01, a4f8c2e1, sess-7xk9m2 Avoid:
  • Spaces or special characters ($, @, :, /) — these break URL parsing
  • Sequential IDs (session-1, session-2) if you want session isolation
  • Reusing IDs across unrelated workflows

Code examples

import secrets, requests

session_id = secrets.token_hex(4)  # e.g. "5s5d4xud"
username = f"adminpcowe-country-us-city-westlakevillage-session-{session_id}-ttl-15"
proxy = f"http://{username}:maskxsndyb@pr-eu.proxies.fo:13337"

s = requests.Session()
s.proxies = {"http": proxy, "https": proxy}

# All three calls use the same Westlake Village IP for 15 minutes
for _ in range(3):
    print(s.get("https://api.ipify.org").text)

When to use each mode

ScenarioMode
Scraping many pages across many sitesRotating
Logging into an account and navigatingSticky
Adding items to a cart and checking outSticky
Querying an API that rate-limits per IPRotating
Anything that checks session cookies against IPSticky
Use the shortest TTL that covers your workflow. Shorter sessions recycle IPs faster and reduce the chance of a single flagged IP affecting many requests.