Run a task

Give a high-accuracy browser agent a goal and get the result.

Create an API key and export it:

export BROWSER_USE_API_KEY=your_key

Python

from browser_use_sdk.v4 import BrowserUse

client = BrowserUse()
run = client.runs.create(
    "Find the top Hacker News story",
    model="grok-4.5",
)
run = client.runs.wait_for_completion(run.id)
print(run.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",
  model: "grok-4.5",
});
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","model":"grok-4.5"}'

Install the SDK with pip install browser-use-sdk or npm install browser-use-sdk. Curl needs no installation.

Every new run implicitly creates a session for its conversation and live browser, plus a workspace for persistent files.

Copy API V4 docs

Give the compact context file to your coding agent.