Proxies - Browser Use

A US residential proxy is active by default on every session. To route through a different country, set proxy_country_code.

from browser_use_sdk.v3 import AsyncBrowserUse

client = AsyncBrowserUse()
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 result = await client.run("Get the price of iPhone 16 on amazon.de", {
  proxyCountryCode: "de",
});

Common country codes: us, gb, de, fr, jp, au, br, in, kr, ca.

Disable proxies

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

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

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.

from browser_use_sdk.v3 import AsyncBrowserUse

client = AsyncBrowserUse()
session = await client.sessions.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 session = await client.sessions.create({
  customProxy: {
    host: "proxy.example.com",
    port: 8080,
    username: "user",
    password: "pass",
  },
});