> ## Documentation Index
> Fetch the complete documentation index at: https://browseruse-0aece648-codex-deterministic-rerun-docs.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# API Reference

> Authenticate and start using the Browser Use REST API.

## Authentication

All requests require an API key in the `X-Browser-Use-API-Key` header:

```
X-Browser-Use-API-Key: bu_your_key_here
```

Get a key at [cloud.browser-use.com/settings](https://cloud.browser-use.com/settings?tab=api-keys\&new=1). Keys start with `bu_`.

## Base URL

```
https://api.browser-use.com/api/v3
```

## Quick example

```bash Create a session theme={null}
curl -X POST https://api.browser-use.com/api/v3/sessions \
  -H "X-Browser-Use-API-Key: bu_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"task": "Find the top 3 trending repos on GitHub today"}'
```

```bash Get session result (replace SESSION_ID) theme={null}
curl https://api.browser-use.com/api/v3/sessions/SESSION_ID \
  -H "X-Browser-Use-API-Key: bu_your_key_here"
```

## Environment variable

Set the key once so SDKs pick it up automatically:

```bash theme={null}
export BROWSER_USE_API_KEY=bu_your_key_here
```

***

Prefer the SDK? See the [Agent docs](/cloud/agent/quickstart) — the SDK has all API endpoints available as methods, including `client.browsers.create()`.

<CodeGroup>
  ```bash Python theme={null}
  pip install browser-use-sdk
  ```

  ```bash TypeScript theme={null}
  npm install browser-use-sdk
  ```
</CodeGroup>