API Overview

Virtual Browser exposes HTTP APIs to create, launch, and control isolated Chromium profiles. Use Playwright or Puppeteer over CDP after launchBrowser for full page automation.

Pro feature

API and MCP require Pro and a signed-in client. Copy http://localhost:{port} and api-key from the API menu (port is dynamic, often near 9000).

REST-style endpoints on a local server. Authoritative references:

• Apifox: https://2uzg2znjfy.apifox.cn/
• KDocs: https://www.kdocs.cn/l/cq4lGX94cYk1

If the site and online docs differ, prefer the online version.

Base URL

http://localhost:{port}

Replace {port} with the value shown in the client.

Headers

Content-Type: application/json
api-key: YOUR_API_KEY

api-key is required on v2.1.5+.

Capabilities

Area	Actions
Profiles	CRUD, launch, stop, cache/data cleanup, running state
Cookies	Get / update JSON cookies
Fingerprint	Randomize / update fingerprint fields
Groups	List, add, rename, delete groups
Extensions	List, install, remove CRX
Platform accounts	List, add, delete, bulk update
MCP	Streamable HTTP at /mcp — MCP guide

Example

GET /api/getBrowserList HTTP/1.1
Host: localhost:9000
api-key: YOUR_API_KEY

Guides

• CLI mode — headless API service
• Automation API — Playwright sample
• Plans & features
• API index — full endpoint list