ByteZero Residential Proxy Parameters

ByteZero proxies support advanced geotargeting and customization via username-based injectables. These parameters can be chained together in the username for precise targeting and behavior tuning.

Basic Proxy Format

λ curl --proxy username:PASSWORD@residential-bridge.bytezero.io:1111 https://ipinfo.io

Available Parameters

Parameter	Values / Format	Notes
`country`	ISO country code(s) e.g. `US`, `NL`, `DE`	Multi-country allowed with comma: `NL,DE,BE`
`city`	City name	Can be used alone or with `country` for higher accuracy
`zip`	Postal code	Can be used standalone
`state`	State/Region name	Optional
`mobile`	`true`, `false`	Request mobile IPs only
`spacex`	`true`, `false`	Route through Starlink / SpaceX IPs
`speed`	`fast`, `medium`, `slow`, `any`	Target proxies based on network speed
`asn`	ASN number or name	Target specific networks
`session`	Custom session ID	Enables sticky sessions
`time`	Duration in seconds	Session lifetime
`fingerprint`	`windows`, `macos`, `mobile`	TCP/IP fingerprinting emulation

Example Username Strings

These are injected in the username part of the proxy URL and can be chained together using dashes (-):

Single Parameter

username-country-us

Multiple Parameters (Chained)

username-country-us-city-seattle-zip-98101-speed-fast-mobile-true-session-abc123-time-60

Using Only ZIP (no country)

username-zip-98101

TCP/IP Fingerprint Emulation

username-country-nl-fingerprint-windows

Notes

Each parameter is optional and can be used alone.

zip, city, state, and asn do not require country, but combining them increases location accuracy.

Sticky sessions are enabled by using a session-<id> (no need to add sticky-true).

All parameters are parsed via the username, so structure matters.

Full Example with `curl`

λ curl --proxy username-country-us-spacex-true:xQhfS7HOev@residential-bridge.bytezero.io:1111 https://ipinfo.io

This returns a US IP from SpaceX/Starlink.

Residential Proxy Parameters

ByteZero Residential Proxy Parameters#

Basic Proxy Format#

Available Parameters#

Example Username Strings#

Single Parameter#

Multiple Parameters (Chained)#

Using Only ZIP (no country)#

TCP/IP Fingerprint Emulation#

Notes#

Full Example with curl#