Skip to main content

​
Stealth by default

Every Browser Use Cloud session runs on stealth infrastructure. No configuration needed.
  • Anti-detect browser fingerprinting — undetectable as automation
  • Automatic CAPTCHA solving — CAPTCHAs are handled transparently
  • Ad and cookie banner blocking — clean pages, faster execution
  • Cloudflare / anti-bot bypass — works on protected sites
Stealth is always on. You do not need to configure anything. If you are searching for “captcha” — it is handled automatically.

​
Country proxies

A US residential proxy is always active by default — no configuration needed. To route through a different country, set proxyCountryCode on the session or inline via sessionSettings. 
from browser_use_sdk import AsyncBrowserUse

client = AsyncBrowserUse()

# Via session — US proxy is the default
session = await client.sessions.create(proxy_country_code="us")
result = await client.run("Get the price of iPhone 16 on amazon.com", session_id=session.id)

# Or inline via session_settings (auto-creates session)
result = await client.run(
    "Get the price of iPhone 16 on amazon.com",
    session_settings={"proxyCountryCode": "us"},
)
Common country codes: us, gb, de, fr, jp, au, br, in, kr, ca, es, it, nl, se, sg.
The default is always us. This applies to auto-sessions (run() without a session_id), manually created sessions, and browser sessions — unless you explicitly set a different country code.

​
Custom proxy

Bring your own proxy server (HTTP or SOCKS5). 
from browser_use_sdk import AsyncBrowserUse, CustomProxy

client = AsyncBrowserUse()
session = await client.sessions.create(
    custom_proxy=CustomProxy(
        url="http://proxy.example.com:8080",
        username="user",
        password="pass",
    ),
)
Proxy is a session-level setting. All tasks in the same session use the same proxy. See Models & Pricing for proxy costs.

​
Disabling proxies

Disabling the proxy is not recommended. Residential proxies are a core part of Browser Use’s stealth infrastructure and significantly reduce the chance of being blocked or fingerprinted. Only disable them if you have a specific reason (e.g. testing against localhost, or your target site allowlists your server IP).
To opt out of the built-in proxy, pass proxyCountryCode as null explicitly. This works for sessions, tasks (via sessionSettings), and browser sessions. 
from browser_use_sdk import AsyncBrowserUse, SessionSettings

client = AsyncBrowserUse()

# Session — no proxy
session = await client.sessions.create(proxy_country_code=None)

# Task with inline session settings — no proxy
result = await client.run(
    "Go to http://localhost:3000 and check the homepage",
    session_settings=SessionSettings(proxy_country_code=None),
)

# Browser session — no proxy
browser = await client.browsers.create(proxy_country_code=None)
For the V3 API: 
from browser_use_sdk.v3 import AsyncBrowserUse

client = AsyncBrowserUse()
result = await client.run(
    "Go to http://localhost:3000 and check the homepage",
    proxy_country_code=None,
)
The US proxy is active by default on every session. To disable it for an auto-session (v2), pass sessionSettings with proxyCountryCode: null — omitting sessionSettings entirely leaves the default US proxy on.