Quickstart

The Browser Use Cloud API lets you create and manage browser automation agents programmatically. Each agent can execute tasks and provide real-time feedback through a live preview URL.

​

Prerequisites

​

Pricing

The Browser Use Cloud API is priced at $0.05 per step that agent executes.

​

Creating Your First Agent

Create a new browser automation task by providing instructions in natural language:

curl -X POST https://api.browser-use.com/api/v1/run-task \
  -H "Authorization: Bearer your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "task": "Go to google.com and search for Browser Use"
  }'

The API returns a task ID that you can use to manage the task and check the live preview URL.

​

Managing Tasks

Control running tasks with these operations:

For detailed API documentation, see the tabs on the left, which includes the full coverage of the API.

​

Building your own client (OpenAPI)

The best way to build your own client is to use our OpenAPI specification to generate a type-safe client library.

​

Python

Use openapi-python-client to generate a modern Python client:

# Install the generator
pipx install openapi-python-client --include-deps

# Generate the client
openapi-python-client generate --url http://api.browser-use.com/openapi.json

This will create a Python package with full type hints, modern dataclasses, and async support.

​

TypeScript/JavaScript

For TypeScript projects, use openapi-typescript to generate type definitions:

# Install the generator
npm install -D openapi-typescript

# Generate the types
npx openapi-typescript http://api.browser-use.com/openapi.json -o browser-use-api.ts

This will create TypeScript definitions that you can use with your preferred HTTP client.