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")

import { BrowserUse } from "browser-use-sdk/v3";

const client = new BrowserUse();
const browser = await client.browsers.create({ proxyCountryCode: "de" });
console.log(browser.cdpUrl);
console.log(browser.liveUrl);

// With an agent:
// const result = await client.run("Get the price of iPhone 16 on amazon.de", { proxyCountryCode: "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)

const browser = await client.browsers.create({ proxyCountryCode: null });

// With an agent:
// const result = await client.run("Go to http://localhost:3000", { proxyCountryCode: null });

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",
    },
)

import { BrowserUse } from "browser-use-sdk/v3";

const client = new BrowserUse();
const browser = await client.browsers.create({
  customProxy: {
    host: "proxy.example.com",
    port: 8080,
    username: "user",
    password: "pass",
  },
});