With the API v1.5 in Undetectable, you will be able to get a list of profiles, create, launch, 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
Démarrage du profil
Chemin : /profile/start/<profileID>
Méthode : GET
Description : Démarre le profil avec l’ID <profileID> spécifié. Vous pouvez ajouter des paramètres à l’URL :
chrome_flags et passer n’importe quel drapeau de démarrage que vous souhaitez, il suffit de les encoder en URL, par exemple :
start-pages et spécifier les pages de démarrage, il suffit de les encoder en URL, par exemple : ?start-pages=https%3A%2F%2Fgoogle.com%2Chttps%3A%2F%2Fya.ru
Fermeture du profil
Chemin : /profile/stop/<profileID>
Méthode : GET
Description : Arrête le profil avec l’ID <profileID> spécifié
Mise à jour du profil
Chemin : /profile/update/<profileID>
Méthode : POST
Description : Met à jour les informations du profil avec l’ID de profil spécifié <profileID>. Tous les paramètres sont facultatifs et peuvent être absents.
Format : JSON
Suppression du profil
Chemin : /profile/delete/<profileID>
Méthode : GET
Description : Supprime le profil avec l’ID de profil spécifié <profileID>.
Effacement des données du profil
Chemin : /profile/cleardata/<profileID>
Méthode : GET
Description : Efface toutes les données (cookies, historique, notes, cache, etc.) du profil avec l’ID de profil spécifié <profileID>.
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 du profil
Chemin : /profile/cookies/<profileID>
Méthode : GET
Description : Récupère les cookies du profil avec l’ID de profil spécifié <profileID>.
Envoi vers le cloud
Chemin : /profile/tocloud
Méthode : POST
Description : Envoie les profils sélectionnés vers le cloud.
Format : JSON
Rendre local
Chemin : /profile/tolocal
Méthode : POST
Description : Rend les profils sélectionnés locaux.
Format : JSON
Mise à jour du navigateur
Chemin : /profile/updatebrowser/<profileID>
Méthode : GET
Description : Met à jour la version du navigateur dans le profil avec l’ID de profil spécifié <profileID>.
Format : JSON
Liste des configurations
Chemin : /configslist
Méthode : GET
Description : Renvoie la liste des configurations actives.
Format : JSON
Liste des groupes
Chemin : /groupslist
Méthode : GET
Description : Renvoie la liste des groupes
Format : JSON
Informations sur le profil
Chemin : /profile//<profileID>
Méthode : GET
Description : Récupère les informations sur le profil avec l’ID de profil sélectionné <profileID>
Format : JSON
Check IP
Chemin: /profile/checkconnection/<profileID>
Méthode: GET
Description: Checks the connection in the profile with the selected , if the check fails, an error is returned
Format: 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
Exemples
Puppeteer (Node.js)
Exécution d’un profil avec un nom spécifique et ouverture de la page undetectable.io dans ce profil avec Node.js Puppeteer :
Selenium (Python)
Exécution de profils se trouvant dans un dossier spécifique et ouverture de plusieurs sites avec Python + Selenium :