Introduction
Vision provides the ability to launch a “one-time” profile. This profile will be launched immediately after the launch request is executed, and upon closure, this profile will be deleted and unavailable for subsequent use. At the same time, data from the profile (cookies) will be included in the response to the profile closure request.
This feature is useful for automation specialists whose work does not involve using a profile after its initial launch and subsequent shutdown.
Important! All parameters described below are optional.
No parameters are required to start the profile; specify them only if you need to start the profile with specific values.
Base URL for launching Instant profile
Use the GET method to run the profile without parameters. In this case, the profile will be run with a random fingerprint, and the OS fingerprint will match yours.
Use the POST method to launch the profile with the parameters specified in the request body.
Base URL for stopping Instant profile
Request
Request headers
Request body
Fingerprint object
Navigator object
Screen object
webgl_renderer parameter
You can get a list of available graphics cards by sending a request to the Local API. More details are available here.
media_devices object
geolocation object
noise object
If noise does not need to be applied to any of the above parameters, the noise object can be omitted.
If noise needs to be specified for only one or two of the three parameters, the remaining parameters do not need to be specified in the noise object.
canvas parameter
If you need to disable Canvas, set the value to off. If you need Real mode, do not specify the canvas parameter in the fingerprint object.
webgl parameter
If you need to disable WebGL, set the value to off. If you need Real mode, do not specify the webgl parameter in the fingerprint object.
webrtc parameter
If you need to disable WebRTC, set the value to off. If you need to specify the value Manual, specify the IP address in string format, for example, 1.1.1.1. If you need Auto mode, do not specify the webrtc parameter in the fingerprint object.
ports_protection parameter
behavior object
Start Instant profile
Examples of requests to launch an Instant profile without parameters
1const url =
2 "http://127.0.0.1:3030/start/instant";
3
4const options = {
5 method: "GET",
6 headers: {
7 "X-Token": "Your Token",
8 },
9};
10
11fetch(url, options)
12 .then((response) => {
13 response.json().then((data) => {
14 console.log(data);
15 });
16 })
17 .catch((error) => {
18 console.error(error);
19 });Response
Response data
Response example
1{
2 success: true,
3 profile_id: "039e50ce-6748-43c3-81ca-9d16aece007e",
4 port: 61453
5}Examples of requests to launch an Instant profile with all parameters
1const url =
2 "http://127.0.0.1:3030/start/instant";
3
4const body = {
5 "name": "Profile 1",
6 "os": "macos",
7 "version": 142,
8 "smart": "standard",
9 "fingerprint": {
10 "navigator": {
11 "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/142.0.0.0 Safari/537.36",
12 "language": "en-GB",
13 "languages": [
14 "en-GB",
15 "en",
16 "en-US",
17 "en"
18 ],
19 "timezone": "America/New_York",
20 "hardware_concurrency": 8,
21 "device_memory": 8
22 },
23 "screen": {
24 "resolution": "1920x1080",
25 "pixel_ratio": 2
26 },
27 "webgl_renderer": "Apple M3",
28 "media_devices": {
29 "audio_input": 1,
30 "audio_output": 1,
31 "video_input": 1
32 },
33 "geolocation": {
34 "latitude": 40.7128,
35 "longitude": -74.006,
36 "accuracy": 100
37 },
38 "noise": {
39 "canvas": true,
40 "webgl": true,
41 "client_rects": true
42 },
43 "canvas": "off",
44 "webgl": "off",
45 "webrtc": "1.1.1.1",
46 "ports_protection": [
47 3389,
48 5900,
49 5901
50 ]
51 },
52 "proxy": "socks5://user:pass@1.1.1.1:5555",
53 "extensions": [
54 "C:\\extension1",
55 "C:\\extension2"
56 ],
57 "cookies": [
58 {
59 "domain": ".google.com",
60 "name": "1P_JAR",
61 "value": "2021-11-10-11",
62 "path": "/",
63 "expires": 1639134293,
64 "secure": true,
65 "http_only": false,
66 "same_site": "none"
67 }
68 ],
69 "behavior": {
70 "urls": [
71 "https://google.com/"
72 ],
73 "args": [
74 "--flag"
75 ],
76 "headless": false,
77 "remote_debugging_port": 61374,
78 "timeout": 3
79 }
80}
81
82const options = {
83 method: "POST",
84 headers: {
85 "X-Token": "Your Token",
86 "Content-Type": "application/json"
87 },
88 body: JSON.stringify(body)
89};
90
91fetch(url, options)
92 .then((response) => {
93 response.json().then((data) => {
94 console.log(data);
95 });
96 })
97 .catch((error) => {
98 console.error(error);
99 });Response
Response data
Response example
1{
2 success: true,
3 profile_id: "b437dea0-e465-4a18-b2b4-db2521df9eae",
4 port: 60756
5}Stop Instant profile
Example of stopping an Instant profile
Please note that instead of PROFILE_ID, you need to insert the ID of the Instant profile that is running!
1const url =
2 "http://127.0.0.1:3030/stop/instant/PROFILE_ID";
3
4const options = {
5 method: "GET",
6 headers: {
7 "X-Token": "Your Token",
8 },
9};
10
11fetch(url, options)
12 .then((response) => {
13 response.json().then((data) => {
14 console.log(data);
15 });
16 })
17 .catch((error) => {
18 console.error(error);
19 });Response
Response data
Response example
1{
2 success: true,
3 profile_id: "75b4f9e6-fa6a-45a9-b272-f35d06a749d1",
4 folder_id: "00000000-0000-0000-0000-000000000000",
5 cookies: [{
6 "domain": ".google.com",
7 "name": "1P_JAR",
8 "value": "2021-11-10-11",
9 "path": "/",
10 "expires": 1639134293,
11 "secure": true,
12 "http_only": false,
13 "same_site": "none"
14 }]
15}