Skip to main content

Creating Browser Profiles (Bulk)

Description: This method is used to create new multiple browser profiles in the specified workspace and the folder.
Each profile can have its own configuration, including screen size, hardware emulation, language, timezone, proxy, and other parameters.
All fields are optional if another is not specified.

Request parameters:

ParameterTypeFormatDefaultDescription
countintegerint32Number of profiles to create
workspaceIdintegerint64-1Workspace identifier. -1 means the default workspace.
folderIdstringuuid(empty)Folder identifier (optional).
screenstring(empty)Screen configuration settings. The allowed values are: “auto” to use value from fingerprint, “ignore” to use system value or “width x height” to use custom screen resolution (auto, ignore, or width x height)
cpustring(empty)CPU configuration settings. The allowed values are: “auto” to use value from fingerprint, “ignore” to use system value or integer number to use custom processor core count (auto, ignore, or number of cores)
memorystring(empty)Memory configuration settings. The allowed values are: “auto” to use value from fingerprint, “ignore” to use system value or integer number to custom memory size in megabytes (auto, ignore or memory size in MB)
languagestring(empty)Browser language settings. The allowed values are: “auto” to use value from fingerprint, “ignore” to use system value or custom language value (auto, ignore, or locale Russian - ru English (United States) - en-US German - de French - fr Spanish - es English (United Kingdom) - en-GB
geoLocationstring(empty)Geographic location settings. The allowed values are: “auto” to use value from fingerprint, “ignore” to use system value. You can also specify from one to seven floating point numbers that represent the following geo coordinates: Latitude, Longitude, Altitude, Accuracy, AltitudeAccuracy, Heading, Speed, Radius. Some coordinates can be skipped. For example, the following sequence is valid: 10, , 40, , 60, 70 - means Latitude = 10, Longitude = random, Altitude = 40, Accuracy = random, AltitudeAccuracy = 60, Heading = 70, Speed = random, Radius = random (auto, ignore or coordinates (latitude, longitude, etc.))
timeZonestring(empty)Time zone settings. The allowed values are: “auto” to use value from fingerprint, “ignore” to use system value or custom timezone value (auto, ignore, or specific value (e.g. Europe/Moscow))
webGlstring(empty)WebGL configuration settings. The allowed values are: “auto” to use value from fingerprint, “ignore” to use system value. (auto or ignore)
webGpustring(empty)WebGPU configuration settings. The allowed values are: on to enable or off to disable this feature.(on or off)
webRtcstring(empty)WebRTC configuration settings. The allowed values are: ‘Emulate’ to use value from fingerprint, ‘Real’ to use system value or “Hide” to disable this feature.(Emulate, Real or Hide)
domRectstring(empty)DOM Rectangle configuration settings. The allowed values are: “Ignore” to disable this feature or “Noise” to use dom rect noising.(Ignore or Noise)
audiostring(empty)Audio configuration settings. The allowed values are: “on” to enable or “off” to disable this feature. (on or off)
fontsstring(empty)Font configuration settings. The allowed values are: “on” to enable or “off” to disable this feature. (on or off)
batterystring(empty)Battery configuration settings. The allowed values are: “on” to enable or “off” to disable this feature. (on or off)
pluginsstring(empty)Browser plugins configuration. The allowed values are: “on” to enable or “off” to disable this feature. (on or off)
proxyServerIdstringuuid(empty)Proxy server identifier (optional).
speechVoicesstring(empty)Speech voices configuration. The allowed values are: “on” to enable or “off” to disable this feature. (on or off)
tagsstring(empty)Profile tags separated by spaces or commas. (e.g. 1 2 3 4)

Example request:

POST
CURL:

curl 'http://localhost:8160/v1/profiles/create_bulk?count=&workspaceId=-1&folderId=&screen=&cpu=&memory=&language=&geoLocation=&timeZone=&webGl=&webGpu=&webRtc=&domRect=&audio=&fonts=&battery=&plugins=&proxyServerId=&speechVoices=&tags=' \
--request POST \
--header 'Api-Token: YOUR_SECRET_TOKEN'

C#:

using System.Net.Http.Headers;
var client = new HttpClient();
var request = new HttpRequestMessage
{
Method = HttpMethod.Post,
RequestUri = new Uri("http://localhost:8160/v1/profiles/create_bulk?count=&workspaceId=-1&folderId=&screen=&cpu=&memory=&language=&geoLocation=&timeZone=&webGl=&webGpu=&webRtc=&domRect=&audio=&fonts=&battery=&plugins=&proxyServerId=&speechVoices=&tags="),
Headers =
{
{ "Api-Token", "YOUR_SECRET_TOKEN" },
},
};
using (var response = await client.SendAsync(request))
{
response.EnsureSuccessStatusCode();
var body = await response.Content.ReadAsStringAsync();
Console.WriteLine(body);
}

Cube:

http://localhost:8160/v1/profiles/create_bulk?count=&workspaceId=-1&folderId=&screen=&cpu=&memory=&language=&geoLocation=&timeZone=&webGl=&webGpu=&webRtc=&domRect=&audio=&fonts=&battery=&plugins=&proxyServerId=&speechVoices=&tags=

Additionally:
User-Agent: {-Profile.UserAgent-}
Api-Token: Token from UserArea2

Response API:

Response codeResult
200 OKSuccess
500 ErrorInternal Server Error

Success Response (200 OK):

Returns an array of IDs for the newly created profiles:

[
"123e4567-e89b-12d3-a456-426614174000"
]

Error Response (500):

{
"message": null
}