Skip to main content
A US residential proxy is enabled by default. The browser’s traffic passes through that residential IP before reaching the website, so the website sees the proxy’s location—not your server’s. A cloud browser routing its traffic through a residential proxy before reaching a website A cloud browser routing its traffic through a residential proxy before reaching a website Set browser_settings / browserSettings when you create a V4 run to choose another country:
The current TypeScript SDK type requires proxyCountryCode whenever browserSettings is present. Use "us" to keep the default, or null to disable the managed proxy.
The API accepts the lowercase two-letter country codes enumerated by ProxyCountryCode in the current V4 OpenAPI schema. Unsupported values are rejected when the run is created.

Disable proxies

Pass null for QA or internal sites that do not need a residential proxy:

Custom proxy

Custom HTTP and SOCKS5 proxies require an active subscription. See the pricing page for current commercial terms.
A custom proxy overrides proxyCountryCode and must be passed again when a follow-up provisions a new browser. See the Create run reference for the complete settings object.