Launch Browser

Description

Starts a profile. On success returns debuggingPort for Playwright/Puppeteer CDP connection.

Request

Method: POST

URL: /api/launchBrowser

Body: provide one of:

Field	Type	Required	Description
id	int	no*	Profile ID
name	string	no*	Profile name
remark	string	no*	Remark

*At least one identifier is required.

Example

{
  "id": 1
}

curl --location 'http://localhost:9000/api/launchBrowser' \
  --header 'api-key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{"id":1}'

Response

Success

{
  "success": true,
  "debuggingPort": 443
}

Connect Playwright:

await chromium.connectOverCDP(`http://localhost:${debuggingPort}`);

Error

{
  "success": false,
  "error": "Browser list is empty or not found."
}

See: Stop browser · Is running · Automation API