Quick start

pip install browser-use-sdk

npm install browser-use-sdk

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"}'

from browser_use_sdk.v3 import BrowserUse

client = BrowserUse()
browser = client.browsers.create(proxy_country_code="us")
print(browser.cdp_url)

# When finished:
client.browsers.stop(browser.id)

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

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

// When finished:
await client.browsers.stop(browser.id);

browser=$(curl -sS https://api.browser-use.com/api/v4/browsers \
  -H "X-Browser-Use-API-Key: $BROWSER_USE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"proxyCountryCode":"us"}')

export BROWSER_SESSION_ID=$(echo "$browser" | jq -r .id)
export BROWSER_USE_CDP_URL=$(echo "$browser" | jq -r .cdpUrl)

# Connect Playwright or Puppeteer to $BROWSER_USE_CDP_URL, then stop:
curl -X PATCH \
  "https://api.browser-use.com/api/v4/browsers/$BROWSER_SESSION_ID" \
  -H "X-Browser-Use-API-Key: $BROWSER_USE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"action":"stop"}'