With the API v1.5 in Undetectable, you will be able to get a list of profiles, create, start, update, and close them. Additionally, with the obtained information, you can connect various automation tools, such as Puppeteer, Playwright, and others, to profiles on the Chromium core.
By default, the local server runs on port 25325. If this port is occupied, it will start on another port. You can check the port in the program settings and change it if necessary.
To access the local server, use the IP 127.0.0.1, localhost, or the local IP within your network, and the port from the settings, plus the path you want to execute. For example, http://localhost:25325/status.
All API responses look like:
where <status code> and <status> reflect the status:
<return object> - various data sent by the API, for example, a list of profiles.
Errors have the following format:
Requests
Status
Path: /status
Method: GET
Description: Returns the status of the local server, whether it is running or not.
List of Profiles
Path: /list
Method: GET
Description: Returns a list of profiles available in the program on the Chromium browser.
Create Profile
Path: /profile/create
Method: POST
Description: Creates a profile with the selected parameters. All parameters are optional and may not be present. The list of browsers for the command: Chrome, Edge, FireFox, IE, Opera, Safari, Yandex. The list of OS for the command: Windows, Windows 7, Windows 8, Windows 8.1, Windows 10, Android, iPhone, iPad, Linux, Mac. If there are no configurations with the selected OS or Browser, a random OS or Browser type will be used.
Format: JSON
Iniciar perfil
Ruta: /profile/start/<profileID>
Método: GET
Descripción: Inicia el perfil con el <profileID> seleccionado. Puede agregar parámetros a la URL:
chrome_flags y pasar cualquier bandera de inicio que desee, solo asegúrese de codificarlas en URL encoding, por ejemplo:
start-pages y especificar las páginas de inicio, solo asegúrese de codificarlas en URL encoding, por ejemplo: ?start-pages=https%3A%2F%2Fgoogle.com%2Chttps%3A%2F%2Fya.ru
Cerrar perfil
Ruta: /profile/stop/<profileID>
Método: GET
Descripción: Detiene el perfil con el <profileID> seleccionado
Actualizar perfil
Ruta: /perfil/actualizar/<IDperfil>
Método: POST
Descripción: Actualiza la información en el perfil con el <IDperfil> especificado. Todos los parámetros son opcionales y pueden no estar presentes.
Formato: JSON
Eliminar perfil
Ruta: /perfil/eliminar/<IDperfil>
Método: GET
Descripción: Elimina el perfil con el <IDperfil> seleccionado.
Limpiar datos en el perfil
Ruta: /perfil/limpiardatos/<IDperfil>
Método: GET
Descripción: Limpia todos los datos (cookies, historial, notas, caché, etc.) del perfil con el <IDperfil> seleccionado.
Clear profile cookies
Path: /profile/clearcookies/<profileID>
Method: GET
Description: Clear only cookies from profile with selected <profileID>
Clear profile cache
Path: /profile/clearcache/<profileID>
Method: GET
Description: Clear only cache from profile with selected <profileID>
Cookies del perfil
Ruta: /perfil/cookies/<IDperfil>
Método: GET
Descripción: Solicita las cookies del perfil con el <IDperfil> seleccionado.
Enviar a la nube
Ruta: /perfil/alanube
Método: POST
Descripción: Envía los perfiles seleccionados a la nube.
Formato: JSON
Hacer local
Ruta: /perfil/alocal
Método: POST
Descripción: Convierte los perfiles seleccionados en locales.
Formato: JSON
Actualizar versión del navegador
Ruta: /perfil/actualizarnavegador/<IDperfil>
Método: GET
Descripción: Actualiza la versión del navegador en el perfil con el <IDperfil> seleccionado.
Formato: JSON
Lista de configuraciones
Ruta: /listadeconfiguraciones
Método: GET
Descripción: Devuelve una lista de configuraciones activas.
Formato: JSON
Lista de grupos
Ruta: /groupslist
Método: GET
Descripción: Devuelve una lista de grupos
Formato: JSON
Información del perfil
Ruta: /profile/getinfo/<profileID>
Método: GET
Descripción: Solicita información sobre el perfil con el <profileID> seleccionado
Formato: JSON
Check IP
Ruta: /profile/checkconnection/<profileID>
Methode: GET
Descripción: Checks the connection in the profile with the selected , if the check fails, an error is returned
Formato: JSON
Get timezones list
Path: /timezoneslist
Method: GET
Description: Returning timezones list
Format: JSON
Get proxies list
Path: /proxies/list
Method: GET
Description: Returning proxies list
Format: JSON
Add proxy
Path: /proxies/add
Method: POST
Description: Add a proxy to the proxy manager, the parameters login, password, ipchangelink are optional, the rest are required
Format: JSON
Delete proxy
Path: /proxies/delete/<ProxyID>
Method: GET
Description: Removes a proxy with the selected ID. Proxy will be deleted for all profiles with that proxy, the same as during normal deletion from the manager
Format: JSON
Update proxy
Path: /proxies/update/<ProxyID>
Method: POST
Description: Updates the proxy with the selected ID, all parameters are optional
Format: JSON
Ejemplos
Puppeteer (Node.js)
Node.js Puppeteer Iniciar un perfil con un nombre específico y abrir la página undetectable.io en ese perfil:
Selenium (Python)
Python + Selenium Iniciar perfiles en una carpeta específica y abrir varios sitios web: