> For the complete documentation index, see [llms.txt](https://cloudbrowser.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://cloudbrowser.gitbook.io/docs/get-started/quickstart.md).

# Quickstart

Get CloudBrowser up and running in less than 5 minutes! This guide will show you how to launch your first browser and start automating web tasks.

## Prerequisites

* A CloudBrowser API token (get yours at [cloudbrowser.ai](https://www.cloudbrowser.ai))
* Basic knowledge of REST APIs or one of our supported libraries

## Step 1: Get Your API Token

1. Sign up at [cloudbrowser.ai](https://www.cloudbrowser.ai)
2. Navigate to your dashboard
3. Copy your API token - you'll need it for authentication

## Step 2: Launch Your First Browser

### Using cURL (HTTP API)

```bash
curl -X POST https://production.cloudbrowser.ai/api/v1/Browser/Open \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "headless": false,
    "keepOpen": 300
  }'
```

### Using Node.js

```javascript
const response = await fetch('https://production.cloudbrowser.ai/api/v1/Browser/Open', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_TOKEN',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    headless: false,
    keepOpen: 300
  })
});

const result = await response.json();
console.log('Browser endpoint:', result.address);
```

### Using C#/.NET

```csharp
using CloudBrowserAiSharp.Puppeteer.Browser;
using CloudBrowserAiSharp.Puppeteer.Extensions;

var browser = await BrowserExtension.LaunchAsync("YOUR_API_TOKEN");
var page = await browser.FirstPage();

await page.GoToAsync("https://www.cloudbrowser.ai");
await browser.CloseAsync();
```

## Step 3: Connect to Your Browser

The API response will include an `address` field with your browser's WebSocket endpoint. Use this endpoint to connect with:

* **Puppeteer** (Node.js)
* **Playwright** (Node.js, Python, C#)
* **Selenium** (any language)
* **CDP** (Chrome DevTools Protocol)

## Example: Complete Web Automation

```javascript
const puppeteer = require('puppeteer');

// 1. Launch browser via CloudBrowser API
const response = await fetch('https://production.cloudbrowser.ai/api/v1/Browser/Open', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_TOKEN',
    'Content-Type': 'application/json'
  }
});

const { address } = await response.json();

// 2. Connect with Puppeteer
const browser = await puppeteer.connect({
  browserWSEndpoint: address
});

const page = await browser.newPage();

// 3. Automate your task
await page.goto('https://example.com');
await page.screenshot({ path: 'screenshot.png' });

// 4. Clean up
await browser.close();
```

## Next Steps

Now that you have your first browser running:

* 📚 Explore the [API Documentation](/docs/get-started/browser-management.md) for advanced configurations
* 🔮 Try [AI Functions](/docs/configurations/ai-functions.md) to process web content with AI
* 📦 Use our [client libraries](https://github.com/CloudBrowser-AI/GitBook/blob/master/libraries/README.md) for your preferred programming language
* ⚙️ Configure [proxies](/docs/configurations/use-your-own-proxies.md) and [browser settings](https://github.com/CloudBrowser-AI/GitBook/blob/master/configurations/README.md)

## Need Help?

* Check our [troubleshooting guide](https://github.com/CloudBrowser-AI/GitBook/blob/master/troubleshooting/README.md)
* Review [best practices](/docs/cloud-service/best-practices.md)