Create Browser

Description

Creates a new profile. Supports name, group, OS, Chromium version, proxy, cookies, homepage, and fingerprint fields. Returns the new profile id.

Request

Method: POST

URL: /api/addBrowser

Content-Type: application/json

Common parameters

Field	Type	Required	Description
name	string	no	Display name (≤60 chars)
group	string	no	Group name
os	string	no	Win 7, Win 8, Win 10, Win 11
chrome_version	string/int	no	Major Chromium version
proxy.mode	int	no	0 default, 1 system, 2 custom
proxy.protocol	string	no	HTTP, HTTPS, SOCKS5
proxy.host / port / user / pass		no	Proxy endpoint
proxy.API	string	no	Rotating proxy extraction API
cookie.jsonStr	json	no	Cookie JSON array string
homepage.mode	int	no	0 off, 1 custom homepage
homepage.value	string	no	Homepage URL
ua.mode / ua.value		no	User-Agent
ua-language.*		no	Language; mode 2 = follow IP
time-zone.*		no	Timezone; mode 2 = follow IP
screen.*		no	Resolution
canvas / webgl / webgl-img / audio-context / fonts / …		no	Fingerprint modules (0 default, 1 random/custom)

Field names use kebab-case in JSON (e.g. ua-language, time-zone, audio-context) as in the client export.

Full parameter list

For every fingerprint field and value ranges, see Apifox or create a profile in the UI and copy JSON via Get full parameters.

Minimal example

{
  "name": "Shop-US-01",
  "group": "Default",
  "os": "Win 11",
  "chrome_version": 124,
  "proxy": {
    "mode": 2,
    "protocol": "HTTP",
    "host": "127.0.0.1",
    "port": "8080",
    "user": "",
    "pass": ""
  },
  "cookie": { "mode": 0, "jsonStr": "[]" },
  "homepage": { "mode": 0, "value": "" },
  "ua": {
    "mode": 0,
    "value": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/124.0.0.0 Safari/537.36"
  },
  "ua-language": { "mode": 2 },
  "time-zone": { "mode": 2 }
}

Response

{
  "success": true,
  "data": {
    "id": 1
  }
}

See: Launch browser · Update browser