Quick start

Run a hosted agent or launch a cloud browser.

Browser Use Agents

Give an agent a task and get the result.

Browser Infrastructure

Launch a cloud browser and connect to it from your code.

Both Cloud paths use API V4. Choose whether Browser Use drives the browser or your Playwright or Browser Use code connects directly over CDP. For a local agent, use the open-source library.

Get an API key and export it:

export BROWSER_USE_API_KEY=your_key

Check your key (no install)

This one request starts a cloud browser that stops itself after 5 minutes. Open the liveUrl it returns to watch it.

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 '{"timeout": 5}'

To stop it early, put the returned id in place of BROWSER_ID:

curl -sS -X PATCH https://api.browser-use.com/api/v4/browsers/BROWSER_ID \
  -H "X-Browser-Use-API-Key: $BROWSER_USE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"action":"stop"}'

A 401 means the key is wrong or not exported in this shell.

Install the SDK

Use Python 3.10 or newer for the Python SDK. Skip installation if you use curl.

Python

pip install --upgrade browser-use-sdk playwright

Run Browser Use Agents

Python

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)

These examples omit model and modelParams. US projects created on or after 16 November 2026 use BU 4.0 with High reasoning. Older US projects keep their existing default, and EU defaults are unchanged. See Models for the full default and availability rules.

Use Browser Infrastructure

These examples connect to the managed browser’s existing context and stop it in finally, including when connecting or navigating fails.

Python

from browser_use_sdk.v4 import BrowserUse
from playwright.sync_api import sync_playwright

with BrowserUse() as client:
    session = client.browsers.create(proxy_country_code="us")
    try:
        if not session.cdp_url:
            raise RuntimeError("The browser did not return a CDP URL")
        with sync_playwright() as p:
            browser = p.chromium.connect_over_cdp(session.cdp_url)
            context = browser.contexts[0]
            page = context.pages[0] if context.pages else context.new_page()
            page.goto("https://example.com")
            print(page.title())
    finally:
        client.browsers.stop(session.id)

Disconnecting CDP does not stop the managed browser. Use client.browsers.stop(session.id) as above, or call PATCH /api/v4/browsers/{id} with {"action":"stop"}.

For curl and additional connection options, follow the Browser Infrastructure quickstart.

Copy for an LLM

Give your coding agent the compact API V4 context.