Capzy Targeting & rotation
Pick a country, pick a pool, and decide whether an IP stays put for a session or changes on every request. Country and rotation are controlled through the username and the port.
Country targeting
Pin the exit to a country by appending a __cr.{country} suffix to your username, using a 2-letter ISO code. For example, capzy_u12345__cr.us routes through United States IPs only.
# US-only exit: add __cr.us to the username
curl -s https://api.ipify.org \
--proxy http://capzy_u12345__cr.us:[email protected]:823Available countries and their IP counts are listed in the dashboard under proxy settings. You can also set a default country there instead of using the username suffix.
| Username / parameter | Description |
|---|---|
capzy_u12345 | Base username. No suffix uses your account default pool and no country pin. |
capzy_u12345__cr.us | Country pin. Replace us with any available 2-letter ISO country code, e.g. __cr.gb, __cr.de. |
sessid.checkout-1 | Named session ID on a standard port. Reuse the ID to keep an exit for about 30 minutes. The dashboard builder accepts letters, numbers, hyphens and underscores. |
sessttl.60 | Sticky port session interval in minutes, from 1 to 120. Overrides the account rotation interval for this request. Use with a port in the 10000–20000 range. |
anon.1 | Use anonymous proxies only. Can reduce the available pool. |
Start the parameter suffix with __ once. Separate each name and value with a dot, and combine parameters with semicolons: capzy_u12345__cr.us;sessid.checkout-1;anon.1. Quote proxy URLs in shell commands so semicolons remain part of the username. URL-encode credentials when constructing URLs programmatically.
Pools
Each plan or sub-user maps to exactly one pool. They are mutually exclusive:
- datacenter — fast, low-cost datacenter IPs.
- residential — real residential IPs. The default pool.
- residential_premium — a cleaner, higher-trust residential tier.
- mobile — carrier mobile (4G/5G) IPs.
The pool is assigned in the dashboard for your plan or sub-user, not selected per request.
Sticky sessions
A sticky session holds one IP for a rotation_interval (about 30 minutes by default, configurable from 1 to 120 minutes). Get a sticky IP by connecting on a session port in the 10000–20000 range. Requests on the same port normally reuse the same IP until the interval elapses. Add sessttl.60 to the username for a 60-minute interval in this request; without it, the account default applies.
# Sticky US session: request a 60-minute rotation interval.
# Use a session port in the 10000-20000 range as the sticky port.
curl -s https://api.ipify.org \
--proxy 'http://capzy_u12345__cr.us;sessttl.60:[email protected]:10001'
# An offline exit can be replaced before the interval ends.Session IDs
Alternatively, append sessid.{id} to the username and use the standard HTTP port 823 or SOCKS5 port 824. Reusing the ID keeps an exit for about 30 minutes. A different ID starts another session. Use a sticky port with sessttl when you need a custom interval.
# Named US session: reuse the same ID for about 30 minutes.
curl --proxy 'http://capzy_u12345__cr.us;sessid.checkout-1:[email protected]:823' https://api.ipify.org
# Change checkout-1 to start a separate session.Per-request rotation
For a fresh IP on every request, use the standard port (823 for HTTP, 824 for SOCKS5) without sessid or a sticky session port. Each request draws a new exit.
# Rotating: a fresh IP on every request via the standard port.
for i in 1 2 3; do
curl -s https://api.ipify.org \
--proxy http://capzy_u12345__cr.us:[email protected]:823
echo
done
# -> three different exit IPs__cr.{country} to the username to pick the country, then use a named session or sticky port to reuse an IP. See Connecting for the full URL format.