API Endpoints
Profiles
Create profiles

Base URL

POST
https://v1.empr.cloud/api/v1/folders/{folderId}/profiles

Request

Request Headers

Headers
Название
Тип / Значение
Описание
X-Token
String
Authorization token
Content-Type
application/json

URL Parameters

Query parameters
Название
Тип / Значение
Описание
folderId
String
ID of the folder where the profile is created

Request Body

To create a profile, a fingerprint is required. See Get Fingerprint

Body
Название
Тип / Значение
Описание
profile_name
String
Profile name
profile_notes
String
Profile notes
profile_tags
Array
Array of profile tags
proxy_id
String
ID of the proxy assigned to the profile
profile_status
Array
Array of profile status in the format ['name', 'color']
platform
String
Profile operating system. Available values: Windows, Mac, Linux
browser
String
Browser engine for the profile. Available values: Chrome
fingerprint
Object
Object with the profile fingerprint

Required parameters of fingerprint object

Body
Название
Тип / Значение
Описание
webrtc_pref
String/Object
WebRTC mode. Available values: auto, off or manual. Selecting manual requires passing an object of the form: {manual: '127.0.0.1'}
webgl_pref
String/Object
WebGL mode. The available values are: real, off, or noise. Selecting noise requires passing an object of the form: {noise: 1.36065635}. The value of the noise key must be of type float with 8 digits after the dot
canvas_pref
String/Object
Canvas mode. The available values are: real, off or noise. Selecting noise requires passing an object of the form: {noise: 1.36065612}. The value of the noise key must be of type float with 8 digits after the dot
ports_protection
Array
Array with port values of type Number

Additional parameters of fingerprint object

Body
Название
Тип / Значение
Описание
audio_input
Number
Number of audio input devices
audio_output
Number
Number of audio output devices
video_input
Number
Number of video input devices

Request example

1const url =
2  "https://v1.empr.cloud/api/v1/folders/{folderId}/profiles"; 
3
4const body = {
5  "profile_name": "Test profile",
6  "profile_notes": "",
7  "profile_tags": [],
8  "proxy_id": null,
9  "new_profile_tags": [],
10  "profile_status": null,
11  "browser": "Chrome",
12  "platform": "MacOS",
13  "fingerprint": {
14    "major": 120,
15    "os": "macos",
16    "webrtc_pref": "auto",
17    "canvas_pref": "real",
18    "webgl_pref": "real",
19    "client_rects": null,
20    "ports_protection": [],
21    "geolocation": null,
22    "media_devices": null,
23    "screen": {
24      "width": 1440,
25      "height": 900,
26      "pixel_ratio": 1,
27      "avail_width": 1440,
28      "avail_height": 825,
29      "avail_top": 25,
30      "avail_left": 0,
31      "color_depth": 24,
32      "pixel_depth": 24
33    },
34    "fonts": [],
35    "hints": {
36      "architecture": "x86",
37      "bitness": 64,
38      "model": "",
39      "platform": "macOS",
40      "platform_version": "11.7.10",
41      "ua_full_version": "120.0.6099.62",
42      "mobile": false
43    },
44    "navigator": {
45      "hardware_concurrency": 4,
46      "device_memory": 8,
47      "max_touch_points": 1,
48      "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36",
49      "platform": "macos",
50      "timezone": null,
51      "language": "auto",
52      "languages": [],
53      "quota": 72673841970
54    },
55    "webgl": {
56      "unmasked_renderer": "ANGLE (Intel Inc., Intel(R) HD Graphics 6000, OpenGL 4.1)",
57      "unmasked_vendor": "Google Inc. (Intel Inc.)",
58      "extensions": [
59        "ANGLE_instanced_arrays",
60        "EXT_blend_minmax",
61        "EXT_color_buffer_half_float",
62        "EXT_disjoint_timer_query",
63        "EXT_float_blend",
64        "EXT_frag_depth",
65        "EXT_shader_texture_lod",
66        "EXT_texture_compression_rgtc",
67        "EXT_texture_filter_anisotropic",
68        "EXT_sRGB",
69        "OES_element_index_uint",
70        "OES_fbo_render_mipmap",
71        "OES_standard_derivatives",
72        "OES_texture_float",
73        "OES_texture_float_linear",
74        "OES_texture_half_float",
75        "OES_texture_half_float_linear",
76        "OES_vertex_array_object",
77        "WEBGL_color_buffer_float",
78        "WEBGL_compressed_texture_s3tc",
79        "WEBGL_compressed_texture_s3tc_srgb",
80        "WEBGL_debug_renderer_info",
81        "WEBGL_debug_shaders",
82        "WEBGL_depth_texture",
83        "WEBGL_draw_buffers",
84        "WEBGL_lose_context",
85        "WEBGL_multi_draw"
86      ],
87      "extra": {
88        "uniform_buffer_offset_alignment": 256,
89        "max_elements_vertices": 1048575,
90        "max_elements_indices": 150000,
91        "max_draw_buffers": 8,
92        "min_program_texel_offset": -8,
93        "max_program_texel_offset": 7,
94        "max_color_attachments": 8,
95        "max_vertex_texture_image_units": 16,
96        "max_texture_image_units": 16,
97        "max_3d_texture_size": 2048,
98        "max_texture_lod_bias": 16,
99        "max_fragment_uniform_components": 4096,
100        "max_vertex_uniform_components": 4096,
101        "max_array_texture_layers": 2048,
102        "max_varying_components": 60,
103        "max_transform_feedback_separate_components": 4,
104        "max_transform_feedback_interleaved_components": 64,
105        "max_samples": 4,
106        "max_vertex_uniform_blocks": 15,
107        "max_fragment_uniform_blocks": 15,
108        "max_combined_uniform_blocks": 30,
109        "max_uniform_buffer_bindings": 72,
110        "max_uniform_block_size": 65536,
111        "max_combined_vertex_uniform_components": 249856,
112        "max_combined_fragment_uniform_components": 249856,
113        "max_vertex_output_components": 128,
114        "max_fragment_input_components": 128,
115        "max_element_index": 4294967295,
116        "max_texture_size": 16384,
117        "max_vertex_attribs": 16,
118        "max_vertex_uniform_vectors": 1024,
119        "max_varying_vectors": 15,
120        "max_combined_texture_image_units": 32,
121        "max_fragment_uniform_vectors": 1024,
122        "max_cube_map_texture_size": 16384,
123        "max_renderbuffer_size": 16384,
124        "max_viewport_width": 16384,
125        "max_viewport_height": 16384,
126        "aliased_line_width_range_min": 1,
127        "aliased_line_width_range_max": 1,
128        "aliased_point_size_range_min": 1,
129        "aliased_point_size_range_max": 255.875,
130        "max_server_wait_timeout": 0
131      }
132    },
133    "webgpu": {
134      "vendor": "intel",
135      "architecture": "gen-8",
136      "limits": {
137        "maxBindGroups": 4,
138        "maxBufferSize": 2147483648,
139        "maxVertexBuffers": 8,
140        "maxColorAttachments": 8,
141        "maxVertexAttributes": 16,
142        "maxTextureArrayLayers": 256,
143        "maxTextureDimension1D": 8192,
144        "maxTextureDimension2D": 8192,
145        "maxTextureDimension3D": 2048,
146        "maxBindingsPerBindGroup": 1000,
147        "maxComputeWorkgroupSizeX": 1024,
148        "maxComputeWorkgroupSizeY": 1024,
149        "maxComputeWorkgroupSizeZ": 64,
150        "maxSamplersPerShaderStage": 16,
151        "maxVertexBufferArrayStride": 2048,
152        "maxUniformBufferBindingSize": 65536,
153        "maxInterStageShaderVariables": 16,
154        "maxInterStageShaderComponents": 60,
155        "maxComputeWorkgroupStorageSize": 32768,
156        "maxStorageBuffersPerShaderStage": 8,
157        "maxUniformBuffersPerShaderStage": 12,
158        "minStorageBufferOffsetAlignment": 256,
159        "minUniformBufferOffsetAlignment": 256,
160        "maxComputeWorkgroupsPerDimension": 65535,
161        "maxSampledTexturesPerShaderStage": 16,
162        "maxStorageTexturesPerShaderStage": 8,
163        "maxComputeInvocationsPerWorkgroup": 1024,
164        "maxDynamicStorageBuffersPerPipelineLayout": 8,
165        "maxDynamicUniformBuffersPerPipelineLayout": 10
166      }
167    },
168    "crc": "7048a23e"
169  }
170}
171
172const options = {
173  method: "POST",
174  headers: {
175    "X-Token": "Your Token", 
176    "Content-Type": "application/json"
177  }, 
178  body: JSON.stringify(body)
179};
180
181fetch(url, options)
182  .then((response) => {
183    response.json().then((data) => {
184      console.log(data);
185    });
186  })
187  .catch((error) => {
188    console.error(error);
189  });

Response

Response body

Response
Название
Тип / Значение
Описание
data
Array<Profile>
Array with the created profiles
usage
Object
Object with usage data of the tariff

Response example

1{
2    "data": {
3        "owner": "***privacy***",
4        "id": "***privacy***",
5        "folder_id": "***privacy***",
6        "proxy_id": null,
7        "profile_name": "Test profile",
8        "profile_notes": "",
9        "profile_status": null,
10        "profile_tags": [],
11        "browser": "chrome",
12        "platform": "macos",
13        "fingerprint": {
14            "major": 120,
15            "os": "macos",
16            "screen": {
17                "width": 1440,
18                "height": 900,
19                "pixel_ratio": 1.0,
20                "avail_width": 1440,
21                "avail_height": 825,
22                "avail_top": 25,
23                "avail_left": 0,
24                "color_depth": 24,
25                "pixel_depth": 24
26            },
27            "fonts": [],
28            "webrtc_pref": "auto",
29            "canvas_pref": "real",
30            "webgl_pref": "real",
31            "media_devices": null,
32            "ports_protection": [],
33            "geolocation": null,
34            "client_rects": null,
35            "hints": {
36                "architecture": "x86",
37                "bitness": 64,
38                "model": "",
39                "platform": "macOS",
40                "platform_version": "11.7.10",
41                "mobile": false,
42                "ua_full_version": "120.0.6099.62"
43            },
44            "navigator": {
45                "hardware_concurrency": 4,
46                "device_memory": 8.0,
47                "max_touch_points": 1,
48                "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36",
49                "platform": "macos",
50                "timezone": null,
51                "language": "auto",
52                "languages": [],
53                "quota": 72673841970
54            },
55            "webgl": {
56                "unmasked_renderer": "ANGLE (Intel Inc., Intel(R) HD Graphics 6000, OpenGL 4.1)",
57                "unmasked_vendor": "Google Inc. (Intel Inc.)",
58                "extensions": [
59                    "ANGLE_instanced_arrays",
60                    "EXT_blend_minmax",
61                    "EXT_color_buffer_half_float",
62                    "EXT_disjoint_timer_query",
63                    "EXT_float_blend",
64                    "EXT_frag_depth",
65                    "EXT_shader_texture_lod",
66                    "EXT_texture_compression_rgtc",
67                    "EXT_texture_filter_anisotropic",
68                    "EXT_sRGB",
69                    "OES_element_index_uint",
70                    "OES_fbo_render_mipmap",
71                    "OES_standard_derivatives",
72                    "OES_texture_float",
73                    "OES_texture_float_linear",
74                    "OES_texture_half_float",
75                    "OES_texture_half_float_linear",
76                    "OES_vertex_array_object",
77                    "WEBGL_color_buffer_float",
78                    "WEBGL_compressed_texture_s3tc",
79                    "WEBGL_compressed_texture_s3tc_srgb",
80                    "WEBGL_debug_renderer_info",
81                    "WEBGL_debug_shaders",
82                    "WEBGL_depth_texture",
83                    "WEBGL_draw_buffers",
84                    "WEBGL_lose_context",
85                    "WEBGL_multi_draw"
86                ],
87                "extensions_v2": null,
88                "extra": {
89                    "uniform_buffer_offset_alignment": 256,
90                    "max_elements_vertices": 1048575,
91                    "max_elements_indices": 150000,
92                    "max_draw_buffers": 8,
93                    "min_program_texel_offset": -8,
94                    "max_program_texel_offset": 7,
95                    "max_color_attachments": 8,
96                    "max_vertex_texture_image_units": 16,
97                    "max_texture_image_units": 16,
98                    "max_3d_texture_size": 2048,
99                    "max_texture_lod_bias": 16,
100                    "max_fragment_uniform_components": 4096,
101                    "max_vertex_uniform_components": 4096,
102                    "max_array_texture_layers": 2048,
103                    "max_varying_components": 60,
104                    "max_transform_feedback_separate_components": 4,
105                    "max_transform_feedback_interleaved_components": 64,
106                    "max_samples": 4,
107                    "max_vertex_uniform_blocks": 15,
108                    "max_fragment_uniform_blocks": 15,
109                    "max_combined_uniform_blocks": 30,
110                    "max_uniform_buffer_bindings": 72,
111                    "max_uniform_block_size": 65536,
112                    "max_combined_vertex_uniform_components": 249856,
113                    "max_combined_fragment_uniform_components": 249856,
114                    "max_vertex_output_components": 128,
115                    "max_fragment_input_components": 128,
116                    "max_element_index": 4294967295.0,
117                    "max_texture_size": 16384,
118                    "max_vertex_attribs": 16,
119                    "max_vertex_uniform_vectors": 1024,
120                    "max_varying_vectors": 15,
121                    "max_combined_texture_image_units": 32,
122                    "max_fragment_uniform_vectors": 1024,
123                    "max_cube_map_texture_size": 16384,
124                    "max_renderbuffer_size": 16384,
125                    "max_viewport_width": 16384,
126                    "max_viewport_height": 16384,
127                    "aliased_line_width_range_min": 1.0,
128                    "aliased_line_width_range_max": 1.0,
129                    "aliased_point_size_range_min": 1.0,
130                    "aliased_point_size_range_max": 255.875,
131                    "max_server_wait_timeout": 0
132                }
133            },
134            "webgpu": {
135                "vendor": "intel",
136                "architecture": "gen-8",
137                "limits": {
138                    "maxBindGroups": 4,
139                    "maxBufferSize": 2147483648.0,
140                    "maxVertexBuffers": 8,
141                    "maxColorAttachments": 8,
142                    "maxVertexAttributes": 16,
143                    "maxTextureArrayLayers": 256,
144                    "maxTextureDimension1D": 8192,
145                    "maxTextureDimension2D": 8192,
146                    "maxTextureDimension3D": 2048,
147                    "maxBindingsPerBindGroup": 1000,
148                    "maxComputeWorkgroupSizeX": 1024,
149                    "maxComputeWorkgroupSizeY": 1024,
150                    "maxComputeWorkgroupSizeZ": 64,
151                    "maxSamplersPerShaderStage": 16,
152                    "maxVertexBufferArrayStride": 2048,
153                    "maxUniformBufferBindingSize": 65536,
154                    "maxInterStageShaderVariables": 16,
155                    "maxInterStageShaderComponents": 60,
156                    "maxComputeWorkgroupStorageSize": 32768,
157                    "maxStorageBuffersPerShaderStage": 8,
158                    "maxUniformBuffersPerShaderStage": 12,
159                    "minStorageBufferOffsetAlignment": 256,
160                    "minUniformBufferOffsetAlignment": 256,
161                    "maxComputeWorkgroupsPerDimension": 65535,
162                    "maxSampledTexturesPerShaderStage": 16,
163                    "maxStorageTexturesPerShaderStage": 8,
164                    "maxComputeInvocationsPerWorkgroup": 1024,
165                    "maxDynamicStorageBuffersPerPipelineLayout": 8,
166                    "maxDynamicUniformBuffersPerPipelineLayout": 10
167                }
168            },
169            "crc": "7048a23e"
170        },
171        "running": false,
172        "pinned": false,
173        "worktime": 0,
174        "last_run_at": null,
175        "created_at": "2024-01-06T15:59:36.070341Z",
176        "updated_at": "2024-01-06T15:59:36.070341Z",
177        "recovered": 0,
178        "is_received": false,
179        "app_version": "0.0.0",
180        "proxy": null
181    },
182    "usage": {
183        "users": 1,
184        "profiles": 1
185    }
186}

Types

Profile
Название
Тип / Значение
Описание
owner
String
The owner of the profile
id
String
The ID of the profile
folder_id
String
The ID of the folder
proxy_id
UUID | null
The ID of the proxy (null if none)
profile_name
String
The name of the profile
profile_notes
String
The notes for the profile
profile_status
UUID | null
The status of the profile (null if not applicable)
profile_tags
UUID[]
Array of UUIDs representing the tags associated with the profile
browser
String
The browser used by the profile
platform
String
The platform used by the profile (macos/windows/linux)
fingerprint
Fingerprint
The fingerprint used by the profile
running
Boolean
Whether the profile is currently running
pinned
Boolean
Whether the profile is currently pinned
worktime
Number
The worktime of the profile in seconds
last_run_at
Timestamp?
The last time the profile was run
created_at
Timestamp
The time the profile was created
updated_at
Timestamp
The time the profile was last updated
proxy
Proxy | null
The proxy used by the profile
Fingerprint
Название
Тип / Значение
Описание
major
Number
The major version of the fingerprint
os
String
The operating system of the fingerprint
screen
Screen
The screen details of the fingerprint
fonts
String[]
Array of fonts installed in the system
webrtc_pref
String
WebRTC settings
canvas_pref
String
Canvas settings
webgl_pref
String
WebGL settings
media_devices
null
Media devices information
ports_protection
string[]
Array of protected ports
geolocation
null
Geolocation settings
client_rects
null
Client rects settings
hints
...
Hints about the device
navigator
...
Navigator information
webgl
...
WebGL information
webgpu
...
WebGPU information
crc
String
CRC value
Screen
Название
Тип / Значение
Описание
width
Number
The width of the screen
height
Number
The height of the screen
pixel_ratio
Number
The pixel ratio of the screen
avail_width
Number
The available width of the screen
avail_height
Number
The available height of the screen
avail_top
Number
The available top position of the screen
avail_left
Number
The available left position of the screen
color_depth
Number
The color depth of the screen
pixel_depth
Number
The pixel depth of the screen