Skip to content

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

better cloud docs + optimized docs images

Gregor Žuničfd31e90abc40
diff --git a/docs/cloud/pricing.mdx b/docs/cloud/pricing.mdx
new file mode 100644
index 000000000..afbb56481
--- /dev/null
+++ b/docs/cloud/pricing.mdx
@@ -0,0 +1,45 @@
+---
+title: "Pricing"
+description: "Browser Use Cloud API pricing structure and cost breakdown"
+icon: "dollar-sign"
+---
+
+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:
+
+| Model | Cost per Step |
+| -------------------------------- | ------------- |
+| GPT-4o | $0.03 |
+| GPT-4o mini | $0.01 |
+| GPT-4.1 | $0.03 |
+| GPT-4.1 mini | $0.01 |
+| O4 mini | $0.02 |
+| O3 | $0.03 |
+| Gemini 2.0 Flash | $0.01 |
+| Gemini 2.0 Flash Lite | $0.01 |
+| Gemini 2.5 Flash Preview (04/17) | $0.01 |
+| Gemini 2.5 Flash | $0.01 |
+| Gemini 2.5 Pro | $0.03 |
+| Claude 3.7 Sonnet (2025-02-19) | $0.03 |
+| Claude Sonnet 4 (2025-05-14) | $0.03 |
+| Llama 4 Maverick 17B Instruct | $0.01 |
+
+## Example Cost Calculation
+
+For example, using GPT-4.1 for a 10 step task:
+
+- Task initialization: $0.01
+- 10 steps × $0.03 per step = $0.30
+- **Total cost: $0.31**
+
+<Note>
+ You need an active subscription and an API key from
+ [cloud.browser-use.com/billing](https://cloud.browser-use.com/billing) to get
+ started.
+</Note>
diff --git a/docs/cloud/quickstart.mdx b/docs/cloud/quickstart.mdx
index 4e0148311..e1cf89506 100644
--- a/docs/cloud/quickstart.mdx
+++ b/docs/cloud/quickstart.mdx
@@ -4,54 +4,26 @@ description: "Learn how to get started with the Browser Use Cloud API"
icon: "cloud"
---
-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
+<img
+ className="block dark:hidden rounded-2xl"
+ src="/images/cloud-banner.png"
+ alt="Browser Use Cloud Banner"
+/>
+<img
+ className="hidden dark:block rounded-2xl"
+ src="/images/cloud-banner-dark.png"
+ alt="Browser Use Cloud Banner"
+/>
<Note>
You need an active subscription and an API key from
- [cloud.browser-use.com/billing](https://cloud.browser-use.com/billing)
+ [cloud.browser-use.com/billing](https://cloud.browser-use.com/billing). For
+ detailed pricing information, see our [pricing page](/cloud/pricing).
</Note>
-## 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:
-
-| Model | Cost per Step |
-| -------------------------------- | ------------- |
-| GPT-4o | $0.03 |
-| GPT-4o mini | $0.01 |
-| GPT-4.1 | $0.03 |
-| GPT-4.1 mini | $0.01 |
-| O4 mini | $0.02 |
-| O3 | $0.03 |
-| Gemini 2.0 Flash | $0.01 |
-| Gemini 2.0 Flash Lite | $0.01 |
-| Gemini 2.5 Flash Preview (04/17) | $0.01 |
-| Gemini 2.5 Flash | $0.01 |
-| Gemini 2.5 Pro | $0.03 |
-| Claude 3.7 Sonnet (2025-02-19) | $0.03 |
-| Claude Sonnet 4 (2025-05-14) | $0.03 |
-| Llama 4 Maverick 17B Instruct | $0.01 |
-
-### Example Cost Calculation
-
-For example, using GPT-4.1 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:
+To understand how the API works visit the [Run Task](/api-reference/run-task?playground=open) page.
```bash
curl -X POST https://api.browser-use.com/api/v1/run-task \
@@ -62,32 +34,11 @@ curl -X POST https://api.browser-use.com/api/v1/run-task \
}'
```
-The API returns a task ID that you can use to manage the task and check the live preview URL.
+`run-task` API returns a task ID, which you can query to get the task status, live preview URL, and the result output.
<Note>
- The task response includes a `live_url` that you can embed in an iframe to
- watch and control the agent in real-time.
+ To play around with the API, you can use the [Browser Use Cloud
+ Playground](https://cloud.browser-use.com/playground).
</Note>
-## Managing Tasks
-
-Control running tasks with these operations:
-
-<AccordionGroup>
- <Accordion title="Pause/Resume Tasks">
- Temporarily pause task execution with [`/api/v1/pause-task`](/cloud/api-v1/pause-task) and resume with
- [`/api/v1/resume-task`](/cloud/api-v1/resume-task). Useful for manual inspection or intervention.
- </Accordion>
-
- <Accordion title="Stop Tasks">
- Permanently stop a task using [`/api/v1/stop-task`](/cloud/api-v1/stop-task). The task cannot be
- resumed after being stopped.
- </Accordion>
-</AccordionGroup>
-
-For detailed API documentation, see the tabs on the left, which include the full coverage of the API.
-
-<Note>
- Need help? Contact our support team at [email protected] or join our
- [Discord community](https://link.browser-use.com/discord)
-</Note>
+For the full implementation guide see the [Implementation](/cloud/implementation) page.
diff --git a/docs/docs.json b/docs/docs.json
index d5122888a..6ccf72372 100644
--- a/docs/docs.json
+++ b/docs/docs.json
@@ -18,7 +18,7 @@
"navigation": {
"tabs": [
{
- "tab": "Documentation",
+ "tab": "Library",
"groups": [
{
"group": "Get Started",
@@ -57,10 +57,12 @@
"tab": "Cloud API",
"groups": [
{
- "group": "Cloud API v1",
+ "group": "Get Started",
+ "pages": ["cloud/quickstart", "cloud/search", "cloud/pricing"]
+ },
+ {
+ "group": "Guides",
"pages": [
- "cloud/quickstart",
- "cloud/search",
"cloud/implementation",
"cloud/custom-sdk",
"cloud/webhooks",
diff --git a/docs/images/browser-use-banner-dark.png b/docs/images/browser-use-banner-dark.png
index e70008638..5e49537d8 100644
Binary files a/docs/images/browser-use-banner-dark.png and b/docs/images/browser-use-banner-dark.png differ
diff --git a/docs/images/browser-use-banner.png b/docs/images/browser-use-banner.png
index 5355757ce..d2f48a9ef 100644
Binary files a/docs/images/browser-use-banner.png and b/docs/images/browser-use-banner.png differ
diff --git a/docs/images/checks-passed.png b/docs/images/checks-passed.png
index 3303c7736..bc4d9ea71 100644
Binary files a/docs/images/checks-passed.png and b/docs/images/checks-passed.png differ
diff --git a/docs/images/cloud-banner-dark.png b/docs/images/cloud-banner-dark.png
new file mode 100644
index 000000000..276c5326c
Binary files /dev/null and b/docs/images/cloud-banner-dark.png differ
diff --git a/docs/images/cloud-banner.png b/docs/images/cloud-banner.png
new file mode 100644
index 000000000..78bf5e12f
Binary files /dev/null and b/docs/images/cloud-banner.png differ
diff --git a/docs/images/laminar.png b/docs/images/laminar.png
index ded8ee403..abea110b3 100644
Binary files a/docs/images/laminar.png and b/docs/images/laminar.png differ