• Getting Started
  • Browser Configuration
  • Proxy Setting
  • Advanced Setting
  • Video Tutorial
  • FAQ
  • API

Update Browser Profile 

A brief description
  • without
request URL
  • {{url}}/v1/profile/update
request method
  • post
Request parameter example
{
    "token": "8b10364c4624d515b5401dbaba2f7b2d",
    "profileId": "C853FDE9-666F-4767-BD33-6117034E9E48",
    "tag": "test",
    "body": {
        "name": "myProfile update",
        "os": {
            "browserVer": [
                "96"
            ],
            "osType": [
                "Windows",
                "MacOS"
            ]
        },
        "orderby": "0",
        "notes": "profile notes",
        "iconId": "0",
        "proxyServer": {
            "type": "NOPROXY",
            "host": "127.0.0.1",
            "port": "1080",
            "username": "hello",
            "password": "world"
        },
        "extensions": {
            "enable": true,
            "list": [
                "0349b3ddca2e663e3e690bfffed187b9"
            ]
        },
        "webRtc": {
            "type": "FAKE",
            "fillOnStart": true,
            "wanSet": true,
            "lanSet": true,
            "publicIp": "",
            "localIps": [
                "192.168.1.10"
            ]
        },
        "userAgent": "user_agent_value",
        "screenWidth": "1920",
        "screenHeight": "1080",
        "langHdr": "en-US",
        "acceptLanguage": "en-US,en;q=0.9",
        "platform": "platform_value",
        "product": "Gecko",
        "appName": "Netscape",
        "hardwareConcurrency": "4",
        "mobileEmulation": false,
        "deviceType": "1",
        "hideWebdriver": false,
        "langBasedOnIp": false,
        "doNotTrack": false,
        "deviceMemory": "8",
        "pixelRatio": "1.0",
        "maskFonts": true,
        "fontSetting": {
            "dynamicFonts": false,
            "fontList": [
                "@Microsoft YaHei UI",
                "@宋体",
                "MS Outlook"
            ],
            "clientRects": true
        },
        "canvasDefType": "NOISEB",
        "audio": {
            "noise": true
        },
        "webgl": {
            "metadata": true,
            "noise": false,
            "vendor": "vendor_value",
            "renderer": "renderer_value"
        },
        "timeZoneFillOnStart": false,
        "timeZone": "Europe/Tallinn",
        "mediaDevices": {
            "setMediaDevices": true,
            "use_name": true,
            "videoInputs": {
                "count": "1",
                "device1": {
                    "label": "label value",
                    "deviceId": "deviceId value",
                    "groupId": "groupId value"
                }
            },
            "audioInputs": {
                "count": "2",
                "device1": {
                    "label": "label value",
                    "deviceId": "deviceId value",
                    "groupId": "groupId value"
                },
                "device2": {
                    "label": "label value",
                    "deviceId": "deviceId value",
                    "groupId": "groupId value"
                }
            },
            "audioOutputs": {
                "count": "2"
            }
        },
        "startUrl": "https://www.lalimao.com",
        "kernelVer": "90",
        "browserSettings": {
            "pepperFlash": true,
            "mediaStream": true,
            "webkitSpeech": true,
            "fakeUiForMedia": true,
            "gpuAndPepper3D": true,
            "ignoreCertErrors": true,
            "audioMute": true,
            "disableWebSecurity": true,
            "disablePdf": true,
            "touchEvents": true,
            "hyperlinkAuditing": true
        },
        "localCache": {
            "deleteCache": true,
            "deleteCookie": true,
            "clearCache": true,
            "clearHistory": true
        },
        "synSettings": {
            "synCookie": true,
            "extensionData": true,
            "synBookmark": true,
            "synHistory": true,
            "synExtension": true,
            "synKeepKey": true,
            "synLastTag": true
        },
        "leakProof": {
            "computerName": {
                "isUse": false,
                "value": "rand"
            },
            "macAddress": {
                "isUse": false,
                "value": "CC-F4-11-9B-08-04"
            }
        },
        "browserParams": "",
        "customDns": "",
        "remoteDebug": {
            "bindAllDebug": false,
            "debuggingPort": "",
            "logLevels": "99"
        },
        "browserApi": {
            "setBatteryStatus": false,
            "isCharging": true,
            "chargingTime": "0",
            "drainsTime": "Infinity",
            "batteryPercentage": "1",
            "autoGeoIp": true,
            "setLatitude": false,
            "setLongitude": false,
            "setAccuracy": false,
            "latitude": "51.48259",
            "longitude": "-0.00766",
            "accuracy": "1803.34",
            "setWebBluetooth": false,
            "setBluetoothAdapter": false,
            "speechSynthesis": false,
            "speechVoicesList": [
                {
                    "isUse": true,
                    "voiceURI": "voiceURI value 12",
                    "name": "name value 1",
                    "lang": "lang value 1",
                    "localService": true,
                    "default": false
                },
                {
                    "isUse": false,
                    "voiceURI": "222",
                    "name": "name value 2",
                    "lang": "lang value 2",
                    "localService": true,
                    "default": true
                }
            ]
        },
        "sslFingerprint": {
            "enableCustomSSL": true,
            "versionMin": "0",
            "versionMax": "1",
            "cipherSuites": [
                {
                    "isUse": true,
                    "v": "TLS_AES_256_GCM_SHA384"
                },
                {
                    "isUse": false,
                    "v": "TLS_RSA_WITH_3DES_EDE_CBC_SHA"
                },
                {
                    "isUse": false,
                    "v": "TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA"
                },
                {
                    "isUse": false,
                    "v": "TLS_AES_128_GCM_SHA256"
                },
                {
                    "isUse": false,
                    "v": "TLS_CHACHA20_POLY1305_SHA256"
                },
                {
                    "isUse": false,
                    "v": "TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256"
                },
                {
                    "isUse": false,
                    "v": "TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256"
                },
                {
                    "isUse": false,
                    "v": "TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384"
                },
                {
                    "isUse": false,
                    "v": "TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384"
                },
                {
                    "isUse": false,
                    "v": "TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305_SHA256"
                },
                {
                    "isUse": false,
                    "v": "TLS_ECDHE_RSA_WITH_CHACHA20_POLY1305_SHA256"
                },
                {
                    "isUse": false,
                    "v": "TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA"
                },
                {
                    "isUse": false,
                    "v": "TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA"
                },
                {
                    "isUse": false,
                    "v": "TLS_RSA_WITH_AES_128_GCM_SHA256"
                },
                {
                    "isUse": false,
                    "v": "TLS_RSA_WITH_AES_256_GCM_SHA384"
                },
                {
                    "isUse": false,
                    "v": "TLS_RSA_WITH_AES_128_CBC_SHA"
                },
                {
                    "isUse": false,
                    "v": "TLS_RSA_WITH_AES_256_CBC_SHA"
                }
            ]
        },
        "otherProtection": {
            "setPortScan": true,
            "localPortsExclude": "8000,12345,42069"
        },
        "header": {
            "setHeaderCustom": true,
            "list": [
                {
                    "isUse": true,
                    "name": "name1",
                    "value": "value",
                    "urlMatch": "urlMatch1",
                    "notExistAdd": false
                },
                {
                    "isUse": true,
                    "name": "name2",
                    "value": "value",
                    "urlMatch": "urlMatch2",
                    "notExistAdd": true
                }
            ]
        },
        "cmdcfg": {
            "openCommandLine": false,
            "commandLine": "",
            "closeCommandLine": true
        }
    }
}
Request json field description
ParameterRequiredTypeDescription
tokenYesstringauthentication token
profileIdYesstringBrowser Profile ID
tagnostringThe name of the group, if you don't want to use the name, you can also pass tagId (the ID of the group)
bodynoobjectThe first letter is not case sensitive
namenostringshow name
younoobjectoperating system
os.browserVernoarraybrowser version
os.browserVernoarraybrowser version
os.osTypenoarrayoperating system
os.osTypenoarrayoperating system
orderbynostringSort, the smaller the number, the higher the ranking
notesnostringRemarks
iconIdnostringIcon ID
proxyServernoobjectproxy settings
proxyServer.typenostringProxy type (NOPROXY, HTTP, SOCKS4, SOCKS5, HTTPS)
proxyServer.hostnostringIP address
proxyServer.portnostringport
proxyServer.usernamenostringlogged in user
proxyServer.passwordnostringlogin password
extensionsnoobjectPlugin configuration
extensions.enablenobooleanDisable inheritance of global settings
false: Inherit global settings
true: Disable inheritance of global settings (do not inherit)
extensions.listnoarrayDisables inheriting the plugin ID of global plugins
extensions.listnoarrayDisables inheriting the plugin ID of global plugins
webRtcnoobjectWebRTC
webRtc.typenostringWebRTC type
webRtc.fillOnStartnobooleanAuto detect IP
webRtc.wanSetnobooleanPublic network IP switch
webRtc.lanSetnobooleanIntranet IP switch
webRtc.publicIpnostringPublic IP
webRtc.localIpsnoarrayIntranet IP
webRtc.localIpsnoarrayIntranet IP
userAgentnostringUser-Agent
screenWidthnostringResolution width
screenHeightnostringResolution height
langHdrnostringlanguage
acceptLanguagenostringAccept-Language
platformnostringPlatform
productnostringProduct
appNamenostringappName
hardwareConcurrencynostringhardwareConcurrency
mobileEmulationnobooleanMobile emulation switch
deviceTypenostringMobile Emulation Type
0: Desktop
1: Mobile
hideWebdrivernobooleanhideWebdriver
langBasedOnIpnobooleanSet language based on IP
doNotTracknobooleando not track
deviceMemorynostringdeviceMemory
pixelRationostringDevicePixelRatio
maskFontsnobooleanEnable 【Font】Fingerprint Protection
fontSettingnoobjectset font
fontSetting.dynamicFontsnobooleanuse font list, each time dynamic random
false: use
true: not use
fontSetting.fontListnoarrayfont list
fontSetting.fontListnoarrayfont list
fontSetting.clientRectsnobooleanClientRects Fingerprint Enhanced Protection
canvasDefTypenostring【Canvas】Protection (Type)
NOISEA: Noise Mode A
BLOCK: Blocking Mode
NOISEB: Noise Mode B
NOISEC: Noise Mode C
OFF: Not enabled (not OFF is enabled)
audionoobjectAudioContext
audio.noisenobooleanEnable hardware fingerprint [AudioContext] protection (noise mode)
false: not enabled
true: enabled
webglnoobjectWebGL
webgl.metadataYesbooleanEnable [WebGL] metadata protection
webgl.noisenobooleanEnable [WebGL] image protection
webgl.vendornostringWebGL vendor
webgl.renderernostringWebGL renderer
timeZoneFillOnStartnobooleanEnable setting time zone based on IP
timeZonenostringManually specify the time zone
mediaDevicesnoobjectMedia Device Fingerprint Settings
mediaDevices.setMediaDevicesnobooleanNumber of custom media devices
mediaDevices.use_namenobooleanSpecify device name
mediaDevices.videoInputsnoobjectvideo input
mediaDevices.videoInputs.countnostringThe number of video input devices. If device1 is not set and count is not 0, device1 device parameters (label, deviceId, groupId) will be randomly generated
mediaDevices.videoInputs.device1noobjectVideo input device number 1 (0~1), corresponding to the number of counts
mediaDevices.videoInputs.device1.labelnostringvideo input device label
mediaDevices.videoInputs.device1.deviceIdnostringVideo input device deviceId
mediaDevices.videoInputs.device1.groupIdnostringVideo input device groupId
mediaDevices.audioInputsnoobjectaudio input
mediaDevices.audioInputs.countnostringThe number of audio input devices. If device is not set (1~4), device parameters (label, deviceId, groupId) will be randomly created according to the number of counts.
mediaDevices.audioInputs.device1noobjectAudio input device number 1 (0~4), corresponding to the number of counts
mediaDevices.audioInputs.device1.labelnostringaudio input device label
mediaDevices.audioInputs.device1.deviceIdnostringaudio input device deviceId
mediaDevices.audioInputs.device1.groupIdnostringAudio input device groupId
mediaDevices.audioInputs.device2noobjectAudio input device number 2 (0~4), corresponding to the number of counts
mediaDevices.audioInputs.device2.labelnostringaudio input device label
mediaDevices.audioInputs.device2.deviceIdnostringaudio input device deviceId
mediaDevices.audioInputs.device2.groupIdnostringAudio input device groupId
mediaDevices.audioOutputsnoobjectAudio output
mediaDevices.audioOutputs.countnostringThe number of audio output devices. If device is not set (1~4), device parameters (label, deviceId, groupId) will be randomly created according to the number of counts.
startUrlnostringDefault home page
kernelVernostringstart the kernel (version)
browserSettingsnoobjectOther configuration
browserSettings.pepperFlashnobooleanEnable Pepper Flash plugin
browserSettings.mediaStreamnobooleanEnable media (WebRTC audio/video) streaming
browserSettings.webkitSpeechnobooleanEnable speech input (x-webkit-speech)
browserSettings.fakeUiForMedianobooleanBypass the media stream information bar by selecting the default device for the media stream
browserSettings.gpuAndPepper3DnobooleanEnable GPU plugin and Pepper 3D rendering
browserSettings.ignoreCertErrorsnobooleanIgnore website certificate errors
browserSettings.audioMutenobooleanAudio mute
browserSettings.disableWebSecuritynobooleanDo not enforce same origin policy
browserSettings.disablePdfnobooleanDisable PDF extensions
browserSettings.touchEventsnobooleanEnable support for touch event feature detection
browserSettings.hyperlinkAuditingnobooleanHyperlink auditing can be used to track clicks on website links
localCachenoobjectlocal cache
localCache.deleteCachenobooleanDelete cache files before starting the browser
localCache.deleteCookienobooleanDelete cookies before starting your browser
localCache.clearCachenobooleanClear file cache when browser is closed
localCache.clearHistorynobooleanDelete history when browser is closed
synSettingsnoobjectSync settings
synSettings.synCookienobooleanSync save cookies
synSettings.extensionDataYesbooleanExtended data
synSettings.synBookmarknobooleanSync and save bookmarks
synSettings.synHistorynobooleanSync history
synSettings.synExtensionnobooleanSync extension
synSettings.synKeepKeynobooleanSync and save passwords
synSettings.synLastTagnobooleanSync recent tabs
leakProofnoobjectAnti-leak settings
leakProof.computerNamenoobjectcomputer name
leakProof.computerName.isUsenobooleancomputer name switch
leakProof.computerName.valuenostringComputer name value ( randrandomly generated if value is)
leakProof.macAddressnoobjectMac address
leakProof.macAddress.isUsenobooleanMac address switch
leakProof.macAddress.valuenostringMac address value ( randrandomly generated if value is)
browserParamsnostringCustomize startup browser parameters
customDnsnostringCustom DNS
remoteDebugnoobjectRemote debugging function
remoteDebug.bindAllDebugnobooleanport binding 0.0.0.0
remoteDebug.debuggingPortnostringRemote debug port
remoteDebug.logLevelsnostringDebug log level
1: VERBOSE
99: DISABLE
browserApinoobjectBrowser API Fingerprint Settings
browserApi.setBatteryStatusnobooleanSetting up the Battery Status API
browserApi.isChargingnobooleanIs it charging
browserApi.chargingTimenostringIt takes time for charging to complete "0", "Infinity"
browserApi.drainsTimenostringBattery can use time "3600", "18000", "10800", "12600", "Infinity"
browserApi.batteryPercentagenostringPercentage of battery power 0.01 ~ 1
browserApi.autoGeoIpnobooleanPopulate geolocation based on IP address
browserApi.setLatitudenobooleanLatitude switch
browserApi.setLongitudenobooleanLongitude switch
browserApi.setAccuracynobooleanPrecision switch
browserApi.latitudenostringLatitude value
browserApi.longitudenostringlongitude value
browserApi.accuracynostringAccuracy (US)
browserApi.setWebBluetoothnobooleanSet Web Bluetooth API (Switch)
browserApi.setBluetoothAdapternobooleanBluetooth Adapter (Switch)
browserApi.speechSynthesisnobooleanSet SpeechSynthesis API (switch)
browserApi.speechVoicesListnoarrayList of Speech Voices
browserApi.speechVoicesList.isUsenobooleanWhether to enable
browserApi.speechVoicesList.voiceURInostringvoiceURI
browserApi.speechVoicesList.namenostringname
browserApi.speechVoicesList.langnostringlang
browserApi.speechVoicesList.localServicenobooleanlocalService
browserApi.speechVoicesList.defaultnobooleandefault
sslFingerprintnoobjectSSL fingerprint settings
sslFingerprint.enableCustomSSLnobooleanEnable custom SSL fingerprint
sslFingerprint.versionMinnostringSSL Versioin min
0：TLSv1
1：TLSv1.1
2：TLSv1.2
3：TLSv1.3
sslFingerprint.versionMaxnostringSSL Versioin max
0：TLSv1.2
1：TLSv1.3
sslFingerprint.cipherSuitesnoarrayCipher Suites List
sslFingerprint.cipherSuites.isUsenostringIs it selected
sslFingerprint.cipherSuites.vnostringvalue
otherProtectionnoobjectother protection
otherProtection.setPortScannobooleanEnable port scan protection
otherProtection.localPortsExcludenostringWhitelist of specific ports (ports that are allowed to be scanned), you need to separate the whitelisted ports with commas (half-width), for example: 8000,12345,42069
headernoobjectHeader settings
header.setHeaderCustomnobooleanEnable Header customization
header.listnoarraylist
header.list.isUsenobooleanWhether to enable
header.list.namenostringname
header.list.valuenostringvalue
header.list.urlMatchnostringURL match
header.list.notExistAddnobooleannot exist add
cmdcfgnoobjectAssisted startup configuration
cmdcfg.openCommandLinenobooleanExecute the command line (switch) before starting the browser
cmdcfg.commandLinenostringCommand Line
cmdcfg.closeCommandLinenobooleanBrowser close kills the command line process
Example of successful return
{
  "data": {
    "profileId": "C853FDE9-666F-4767-BD33-6117034E9E48"
  },
  "code": 0,
  "msg": "OK"
}
Remark

Except token profileId that it is required, all other parameters are optional. If no parameter is passed, it will not be updated.

get free trial

We Offer 3-Day Free Trial for All New Users

No Limitations in Features

By clicking "accept", you agree to use Cookies to optimize the information presented to you, and analyze the traffic of our website.
If you want to opt out of our cookies, please read our Cookie Policy for your guidance.