# WebSocket Parameters

Source: https://docs.evomi.com/scraping-products-instructions/scraping-browser/websocket-parameters/

Use these query parameters on the CDP WebSocket URL to configure your Evomi Scraping Browser sessions.

## Base Format
```text
wss://browser.evomi.com?key=YOUR_API_KEY[&param=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

```text
# 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_KEY
```

## Behavior Notes

- Sessions are ephemeral; reconnect to create a fresh environment.
- Managed browser compatibility features are enabled by default and require no code changes.
- Integrated proxy usage and CAPTCHA solving may affect usage accounting.

Combine parameters to match your testing environment. Example: `os=windows&proxy_country=US&adblock=true`.