Browser Management

Fresh

All endpoints use http://localhost:40185/api/v1/browser/... with POST method.

Create Browser

URL: /browser/create

Key Parameters

Parameter	Required	Type	Description
serialName	Yes	string	Environment name (max 100 chars)
browserOs	Yes	int	1=Windows, 2=Mac
groupId	No	string	Group ID
tagIds	No	array[string]	Tag IDs
remark	No	string	Remark (max 1500 chars)
cookie	No	string	Cookie (JSON or Netscape format)
accountPlatform	No	string	https://www.tiktok.com/ or https://www.facebook.com/
accountUsername	No	string	Account username
accountPassword	No	string	Account password
accountTOTPSecret	No	string	2FA secret key
openLastPage	No	int	Restore last visit: 1=Yes, 2=No
openSpecPage	No	int	Open specified URL: 1=Yes, 2=No
openTabs	No	string	URLs to open (separated by ;)
browserUa	No	string	Custom User-Agent
simulateConfig	No	object	Fingerprint simulation config
proxyId	No	string	Existing proxy ID
proxyConfig	No	object	Proxy info
browserStartArg	No	string	Browser startup parameters

Simulation Config (SimulateConfig)

Controls browser fingerprint including: timezone, language, resolution, WebRTC, geolocation, canvas, WebGL, hardware acceleration, AudioContext, media devices, ClientRects, SpeechVoices, hardware concurrency, device memory, Do Not Track, Bluetooth, battery, and port scan protection.

Proxy Types

typeId	Proxy Type
-1	Direct connection
1	SOCKS5
2	HTTP
3	HTTPS
20	IPIDEA
21	IPHTML
22	kookeey
23	Lumatuo

Response

{ "code": 0, "data": { "id": "497548067550006541" } }

---

Update Browser

URL: /browser/update

Same parameters as Create, plus id (required). Only provided fields are updated.

---

Delete Browser

URL: /browser/delete

Parameter	Required	Type	Description
envIds	Yes	array[string]	Browser IDs (max 100)

Response

{
  "data": {
    "successIds": ["id1"],
    "busyIds": ["id2"],
    "serverErrIds": ["id3"]
  }
}

---

Get Browser List

URL: /browser/list

Parameter	Required	Type	Description
page	No	int	Page number (default 1)
pageSize	No	int	Items per page (1-100, default 10)
ids	No	array[string]	Filter by IDs (max 100)
serialName	No	string	Filter by name
remark	No	string	Filter by remark

---

Launch Browser

URL: /browser/start

Parameter	Required	Type	Description
id	Yes	string	Browser ID

---

Close Browser

URL: /browser/close

Parameter	Required	Type	Description
id	Yes	string	Browser ID

---

Transfer Browsers

URL: /browser/transfer

Parameter	Required	Type	Description
ids	Yes	array[string]	Browser IDs
targetUserId	Yes	string	Target user ID

---

Check Browser Status

URL: /browser/status

Parameter	Required	Type	Description
id	Yes	string	Browser ID

---

Clear Browser Cache

URL: /browser/cache/clear

Parameter	Required	Type	Description
id	Yes	string	Browser ID

---

Move Browser Group

URL: /browser/group/move

Parameter	Required	Type	Description
ids	Yes	array[string]	Browser IDs
groupId	Yes	string	Target group ID

---

Get Environment Cookies

URL: /browser/cookies

Parameter	Required	Type	Description
id	Yes	string	Browser ID

Error Codes

Code	Description
44002	Maximum package environments reached
44003	Maximum user environments reached
44004	Maximum daily environments reached
45006	Incorrect proxy information
45003	Proxy not allowed
45004	Proxy verification failed
43028	Sub-user group permission denied