API Reference

Create Browser

Create a new browser instance with specified memory allocation and optional start URL.

POST/browsers/create

Request Body

ParameterTypeRequiredDescription
namestringYesA descriptive name for the browser instance.
memorystringYesMemory allocation in MB (256, 512, 1024, or 2048).
startUrlstringNoInitial URL to navigate to when the browser starts.

Example Request

http
POST https://browserize.com/api/browsers/create
Authorization: Bearer sk-brz-YOUR_API_KEY
Content-Type: application/json

{
  "name": "Product Scraper",
  "memory": "512",
  "startUrl": "https://example.com"
}

Example Response

json
{
  "success": true,
  "id": "brw_123",
  "browser": {
    "id": "brw_123",
    "name": "Product Scraper",
    "status": "Running",
    "memory": 512,
    "cpu": 0,
    "uptime": "0m",
    "vnc_url": "example-vnc.browserize.com",
    "novnc_url": "example-novnc.browserize.com",
    "debug_url": "example-debug.browserize.com",
    "mcp_url": "example-mcp.browserize.com"
  }
}

Code Examples

bash
curl -X POST https://browserize.com/api/browsers/create \
  -H "Authorization: Bearer sk-brz-YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Product Scraper",
    "memory": "512",
    "startUrl": "https://example.com"
  }'
javascript
await fetch('https://browserize.com/api/browsers/create', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer sk-brz-YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    name: 'Product Scraper',
    memory: '512',
    startUrl: 'https://example.com'
  })
});
python
import requests

resp = requests.post(
    'https://browserize.com/api/browsers/create',
    headers={
        'Authorization': 'Bearer sk-brz-YOUR_API_KEY',
        'Content-Type': 'application/json'
    },
    json={
        'name': 'Product Scraper',
        'memory': '512',
        'startUrl': 'https://example.com'
    }
)
print(resp.json())