Run a task - Browser Use

Create an API key and export it:

export BROWSER_USE_API_KEY=your_key

from browser_use_sdk.v4 import BrowserUse

with BrowserUse() as client:
    run = client.runs.create("Find the top Hacker News story")
    result = client.runs.wait_for_completion(run.id)
    print(result.result)

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

const client = new BrowserUse();
const run = await client.runs.create({
  task: "Find the top Hacker News story",
});
const result = await client.runs.waitForCompletion(run.id);
console.log(result.result);

curl https://api.browser-use.com/api/v4/runs \
  -H "X-Browser-Use-API-Key: $BROWSER_USE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"task":"Find the top Hacker News story"}'

Install the latest SDK with pip install --upgrade browser-use-sdk or npm install browser-use-sdk@latest. Curl needs no installation. Every new run implicitly creates a session for its conversation and live browser, plus a workspace for persistent files.

Verify an account by email

Set agentmail to give the V4 agent its own inbox. The agent can use that address for a signup, read the verification email, and enter the code:

from browser_use_sdk.v4 import BrowserUse

with BrowserUse() as client:
    run = client.runs.create(
        "Create an account at example.com with your inbox. Read the verification email and enter its code.",
        agentmail=True,
    )

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

const client = new BrowserUse();
const run = await client.runs.create({
  task: "Create an account at example.com with your inbox. Read the verification email and enter its code.",
  agentmail: true,
});

curl https://api.browser-use.com/api/v4/runs \
  -H "X-Browser-Use-API-Key: $BROWSER_USE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"task":"Create an account at example.com with your inbox. Read the verification email and enter its code.","agentmail":true}'

See 2FA for existing accounts, SMS forwarding, saved profiles, and human takeovers.

A task starts a run inside a session and the run reads and writes persistent workspace files

A task starts a run inside a session and the run reads and writes persistent workspace files

Copy API V4 docs

Give the compact context file to your coding agent.