Usage

Stealth & Proxies

Our browser infrastructure is stealth by default, automatically using cookie blockers and captcha solvers.

You can use proxies set to a country of your choice to bypass virtually all anti-scraping measures.

Proxy Pricing: Proxy data is charged separately at $4-10/GB depending on your plan. See Pricing for details.

Proxy Configuration

Proxy is a session-level setting. You cannot set proxyCountryCode on individual tasks.

  • When you create a task without a sessionId, an auto-session is created with US proxy by default
  • To use a different proxy location, you must create a session first with your desired proxyCountryCode
  • All tasks within a session inherit the session’s proxy settings

Using Custom Proxy Location

1// Step 1: Create session with your desired proxy location
2const session = await client.sessions.createSession({
3    proxyCountryCode: "gb"  // UK proxy (see below for all country codes)
4});
5
6// Step 2: Create task in that session
7const task = await client.tasks.createTask({
8    task: "Navigate to protected site",
9    llm: "browser-use-llm",
10    sessionId: session.id  // Task uses the session's UK proxy
11});
12
13// Clean up when done
14await client.sessions.stopSession(session.id);

Default Behavior (Auto-Session)

If you create a task without specifying a sessionId, an auto-session is created with US proxy by default:

1// This automatically uses US proxy - you CANNOT change this per-task
2const task = await client.tasks.createTask({
3    task: "Navigate to protected site",
4    llm: "browser-use-llm"
5    // No sessionId = auto-session with US proxy
6});

Available Country Codes

Common proxy locations include:

  • us - United States (default for auto-sessions)
  • gb - United Kingdom
  • de - Germany
  • fr - France
  • jp - Japan
  • au - Australia

We support 200+ country codes. See the API Reference for the full list.