Skip to content

Open-source Python library for AI browser agents, plus Browser Use Cloud: stealth browsers and a hosted agent API.

4.1 KB
Raw Blame

Cloud Quickstart, Pricing & FAQ

This page keeps the v2 quickstart for existing integrations. For a new hosted-agent integration, use API v4. V4 is the current API and SDK path.

Table of Contents


Overview

Browser Use Cloud is the hosted platform for web automation. Stealth browsers with anti-fingerprinting, CAPTCHA solving, residential proxies in 195+ countries. Usage-based pricing via API keys.

Setup

Python

pip install browser-use-sdk
from browser_use_sdk import BrowserUse
client = BrowserUse()  # Uses BROWSER_USE_API_KEY env var

TypeScript

npm install browser-use-sdk
import BrowserUse from 'browser-use-sdk';
const client = new BrowserUse();  // Uses BROWSER_USE_API_KEY env var

cURL

export BROWSER_USE_API_KEY=your-key

First Task

SDK

result = await client.run("Search for top Hacker News post and return title and URL")
print(result.output)

cURL

curl -X POST https://api.browser-use.com/api/v2/tasks \
     -H "X-Browser-Use-API-Key: $BROWSER_USE_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{"task": "Search for the top Hacker News post and return the title and url."}'

Response: {"id": "<task-id>", "sessionId": "<session-id>"}

Structured Output

from pydantic import BaseModel

class HNPost(BaseModel):
    title: str
    url: str
    points: int

result = await client.run(
    "Find top Hacker News post",
    output_schema=HNPost
)
print(result.output)  # HNPost instance

Live View

Every session has a liveUrl:

curl https://api.browser-use.com/api/v2/sessions/<sessionId> \
     -H "X-Browser-Use-API-Key: $BROWSER_USE_API_KEY"

Open the liveUrl to watch the agent work in real-time.


Pricing

AI Agent Tasks

$0.01 init + per-step (varies by model):

Model Per Step
Browser Use LLM $0.002
Browser Use 2.0 $0.006
Gemini Flash Lite $0.005
GPT-4.1 Mini $0.004
O3 $0.03
Claude Sonnet 4.6 $0.05

Typical task: 10 steps = ~$0.03 (with Browser Use LLM)

V3 API (Token-Based)

Model Input/1M Output/1M
BU Mini (Gemini 3 Flash) ~$0.72 ~$4.20
BU Max (Claude Sonnet 4.6) ~$3.60 ~$18.00

Browser Sessions

  • All plans: $0.02/hour
  • Billed upfront, proportional refund on stop. Min 1 minute.

Skills

  • Creation: $2 (PAYG), $1 (Business). Refinements free.
  • Execution: $0.02 (PAYG), $0.01 (Business)

Proxies

  • Managed residential proxy: $5/GB
  • Direct connection or your own proxy: $0.20/GB

Plans

  • Pay as you go, no subscription. Concurrency grows with lifetime spend (10 to 1,000 sessions).
  • Legacy Business and Scaleup subscriptions keep their discounted rates.
  • Enterprise: Contact for ZDR, compliance, on-prem

Current prices: https://browser-use.com/pricing.md


FAQ & Troubleshooting

Slow tasks?

  • Switch models (Browser Use LLM is fastest)
  • Set start_url to skip navigation
  • Use closer proxy country

Agent failed?

  • Check liveUrl to see what happened
  • Simplify instructions
  • Set start_url

Login issues?

  • Profile sync (easiest): curl -fsSL https://browser-use.com/profile.sh | sh
  • Secrets (per-domain credentials)
  • 1Password (most secure, auto 2FA)

Blocked by site?

  • Stealth is on by default
  • Try different proxy country
  • Set flash_mode=False (slower but more careful)

Rate limited?

  • Auto-retry with backoff
  • Upgrade plan if consistent

Stop a session:

curl -X PATCH https://api.browser-use.com/api/v2/sessions/<id> \
     -H "X-Browser-Use-API-Key: $BROWSER_USE_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{"action": "stop"}'