proxy_country_code. See the API reference for all supported country codes.
Disable proxies
If your use case does not need proxies, for example QA testing.Custom proxy
Bring your own proxy server (HTTP or SOCKS5).Blocked? Get a fresh IP
Browser Use does not rotate the IP within a running session. When a site starts blocking you, stop the session and create a new one — each session gets a fresh residential IP from the country pool automatically.- New session = new IP. Recreating the browser is the supported way to rotate.
- Keep your login across the rotation by passing the same
profile_id— the fresh IP loads the saved cookies and localStorage. - Switch country (
proxy_country_code) to leave a blocked regional pool entirely. - Custom proxies can rotate per request on their side — use the
custom_proxyconfig above with a rotating endpoint.
Further reading
- We stealth benchmarked every major cloud browser provider — how proxy quality affects bypass rates