Proxies & geo

The proxy query parameter on the CDP URL selects where the browser's traffic exits. Choose the included data pool, your own proxies, a saved endpoint, a BYO inline proxy, or direct egress.

The proxy parameter

Add ?proxy=<value> to the connection URL. The value decides your egress for the whole session:

proxy value	Description
`capzy`	The included data pool that ships with your Browser plan. Metered against your plan's included GB, then per-GB overage.
`proxies`	Your standalone Residential Proxies plan, if you have one. Egress and billing follow that plan.
`none`	Direct egress from the browser pod's own IP. No proxy, no country control.
`<uuid>`	A proxy you saved in the dashboard, referenced by its id. Egress uses that saved configuration.
`scheme://user:pass@host:port`	A bring-your-own proxy, inlined. For example http://user:pass@gw.example.com:8000 or socks5://host:1080.

Country targeting

For the Capzy data sources, append an ISO country code to target an exit country: proxy=capzy-US for the included pool, or proxy=proxies-GB for your standalone Residential Proxies plan. Without a suffix the source picks an exit for you.

Examples

proxy-examples.txt

# Included Capzy data pool
wss://USER:PASS@browser.capzy.ai/cdp?proxy=capzy

# Included pool, exit in the United States
wss://USER:PASS@browser.capzy.ai/cdp?proxy=capzy-US

# Your standalone Residential Proxies plan, exit in Great Britain
wss://USER:PASS@browser.capzy.ai/cdp?proxy=proxies-GB

# Direct pod IP, no proxy
wss://USER:PASS@browser.capzy.ai/cdp?proxy=none

# A proxy you saved in the dashboard
wss://USER:PASS@browser.capzy.ai/cdp?proxy=6b1f2c40-...

# Bring your own proxy, inlined
wss://USER:PASS@browser.capzy.ai/cdp?proxy=http://user:pass@gw.example.com:8000

Named proxies fail hard

If a named source (capzy, proxies, or a saved <uuid>) is unavailable, the connection is rejected. It never silently falls back to direct egress, so your real pod IP is never leaked in place of the proxy you asked for.

BYO inline vs the included pool

Use an inline scheme://user:pass@host:port proxy when you already have egress you want to reuse. Traffic through a BYO proxy is billed by your provider, not by us. The included capzy pool is the simplest option: it is metered on real egress bytes against your plan, with per-GB overage. See Limits & billing for how usage is counted.

Connecting

Profiles