POST /browser

Creates a browser and returns a CDP WebSocket endpoint. Only available in remote mode.

URL: POST /browser

Auth: X-API-Key header or Authorization: Bearer header

Request body

{
  "headless": true,
  "os": "windows",
  "browser_name": "chrome",
  "browser_version_min": 146,
  "browser_version_max": 146,
  "proxy": "http://user:pass@host:port"
}

Response

{
  "success": true,
  "data": {
    "browser_id": "br_59245e8658532863",
    "ws_endpoint": "ws://your-server/cdp/br_59245e8658532863"
  }
}

Connect to the returned ws_endpoint with any CDP client. The browser ID acts as the auth token — no additional authentication needed on the CDP connection.