Open Fingerprint Browser Window
Command description
Open the specified BitBrowser or AdsPower window and return the envId generated by the Runavelo extension.
Pass envId to subsequent commands such as Open Webpage, Get Open Webpage, Get All Open Webpages, and Download File in Browser.
Command Input Parameters
| input parameters | Input parameter type | Description |
|---|---|---|
| Browser Type | enum | BitBrowser, AdsPower |
| Browser Window ID | str | Window ID shown by BitBrowser or AdsPower; this is not the envId generated by the Runavelo extension |
| Server Port | int or str | Required local API port; usually 54345 for BitBrowser and 50325 for AdsPower |
| API Token | str | BitBrowser API token; required only when BitBrowser local API authentication is enabled |
| AdsPower API Key | str | AdsPower API key; required only when AdsPower local API security verification is enabled |
| Open Timeout | number or str | Maximum time to wait for the browser window to open and connect to the Runavelo extension, in seconds; defaults to 60 |
Command Output Parameters
| Output parameters | Output parameter type | Description |
|---|---|---|
| envId | str | The envId corresponding to the opened fingerprint browser window |
Install and enable the Runavelo browser extension in the target browser profile. Also enable the browser's local API and enter its actual port. Leave the authentication field empty when the local API does not require authentication.
Usage
- Copy the target browser window ID from BitBrowser or AdsPower.
- Enter the local API port: usually
54345for BitBrowser or50325for AdsPower. - Enter the API Token for an authenticated BitBrowser API, or the AdsPower API Key when AdsPower security verification is enabled.
- If the window starts slowly, increase Open Timeout in the advanced settings. The default is 60 seconds.
- Run this command and save its output
envId. - Pass that
envIdto subsequent webpage commands that should run in the same browser profile.
FAQ
If the window opens but no envId is returned, verify that the Runavelo browser extension is installed and enabled in that browser profile.
If the local API connection fails, verify that the BitBrowser or AdsPower client is running and its local API is enabled.
If BitBrowser authentication fails, verify the API Token. Leave the field empty when no token is configured.
If AdsPower reports Require api-key, enter the local API key in AdsPower API Key.
Related links
Operate Multiple Webpages Concurrently
Generation Notes
- Browser Window ID comes from BitBrowser or AdsPower, not from envId. Save the returned envId for subsequent webpage commands.
- Server Port is required. Enter API Token or AdsPower API Key only when the corresponding browser requires authentication.