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 pricing consists of two components:

1. Task Initialization Cost: $0.01 per started task
2. Task Step Cost: Additional cost based on the specific model used for each step

​

LLM Model Step Pricing

The following table shows the total cost per step for each available LLM model:

​

Example Cost Calculation

For example, using GPT-4o for a 10 step task:

• Task initialization: $0.01
• 10 steps × $0.03 per step
• Total cost: $0.31

​

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 include 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 you can use with your preferred HTTP client.