Proxies

Residential proxies in 195+ countries. On by default.

A US residential proxy is active by default on every browser. To route through a different country, set proxy_country_code. See the API reference for all supported country codes.

Python

from browser_use_sdk.v3 import AsyncBrowserUse

client = AsyncBrowserUse()
browser = await client.browsers.create(proxy_country_code="de")
print(browser.cdp_url)   # ws://...
print(browser.live_url)  # debug view

# With an agent:
# result = await client.run("Get the price of iPhone 16 on amazon.de", proxy_country_code="de")

Disable proxies

If your use case does not need proxies, for example QA testing.

Python

browser = await client.browsers.create(proxy_country_code=None)

# With an agent:
# result = await client.run("Go to http://localhost:3000", proxy_country_code=None)

Custom proxy

Bring your own proxy server (HTTP or SOCKS5). Requires custom plan.

Python

from browser_use_sdk.v3 import AsyncBrowserUse

client = AsyncBrowserUse()
browser = await client.browsers.create(
    custom_proxy={
        "host": "proxy.example.com",
        "port": 8080,
        "username": "user",
        "password": "pass",
    },
)