WebSocket Parameters
Use these query parameters on the CDP WebSocket URL to configure your Evomi Scraping Browser sessions.
Base Format
wss://browser.evomi.com?key=YOUR_API_KEY[¶m=value...] ⚠️
Always keep your API key secret. Rotate keys from your dashboard if exposed.
Parameters
| Name | Type | Example | Default | Description |
|---|---|---|---|---|
key |
string | key=evm_123... |
— (required) | Your Evomi API key authorizing the browser session |
os |
enum | os=windows |
provider default | Target OS fingerprint: windows, apple, unix |
proxy_country |
ISO 3166-1 alpha-2 | proxy_country=US |
dynamic | Route traffic via integrated proxy for the specified country |
adblock |
boolean | adblock=true |
false |
Enable built‑in ad/tracker blocking for cleaner pages and fewer popups |
solve_cloudflare |
boolean | solve_cloudflare=false |
true |
Toggle automatic Cloudflare Turnstile solving |
ℹ️
Parameters are optional unless marked required. Invalid values are ignored or coerced to defaults.
Examples
# Windows fingerprint, US proxy routing, adblock on
wss://browser.evomi.com?key=YOUR_API_KEY&os=windows&proxy_country=US&adblock=true
# Disable Turnstile solving for debugging
wss://browser.evomi.com?key=YOUR_API_KEY&solve_cloudflare=false
# Minimal: just your key
wss://browser.evomi.com?key=YOUR_API_KEYBehavior Notes
- Sessions are ephemeral; reconnect to create a fresh environment.
- Anti‑bot evasion is enabled by default and requires no code changes.
- Integrated proxy usage and CAPTCHA solving may affect usage accounting.
Combine parameters for maximum stealth. Example:
os=windows&proxy_country=US&adblock=true.