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:PASSWORD@proxy.capzy.ai:823

Available 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.

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 return the same IP until the interval elapses.

# Sticky US session: hold one IP for the 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:PASSWORD@proxy.capzy.ai:10001
# Repeat calls on the same port return the same IP until the interval elapses.

Per-request rotation

For a fresh IP on every request, use the standard port (823 for HTTP, 824 for SOCKS5) without 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:PASSWORD@proxy.capzy.ai:823
  echo
done
# -> three different exit IPs