Overview

GET /wss opens a WebSocket connection to a remote Chrome DevTools Protocol (CDP) browser. It upgrades the HTTP connection to a WebSocket, letting you drive a real browser with automation libraries like Puppeteer or Playwright.

Use this when a workload needs full, interactive browser control — multi-step flows, logins, or anything a single /fetch can't reach. For one-shot screenshots or short action sequences, prefer Screenshots & actions.

Endpoint

wss://request.usestring.ai/v1/wss

Authenticate by sending your API key as an Authorization: Bearer header when connecting.

Proxy tier & geolocation

Customize the session's proxy route with optional query parameters on the connect URL:

wss://request.usestring.ai/v1/wss?proxy=standard&countryCode=DE

• proxy — premium (default) routes the session through residential proxies; standard routes through datacenter proxies and bills bandwidth at half the premium rate. Use standard for targets that don't require residential exits.
• countryCode — an ISO 3166-1 alpha-2 country code routes the session's traffic through an exit in that country (default US). Validated against the same country list as /fetch and normalized to uppercase.

An invalid value — or an unrecognized parameter — closes the connection with code 1008 and the validation error as the close reason, instead of silently falling back to the defaults.

Session limits

• Maximum lifetime: 30 minutes. Every session is forcefully closed 30 minutes after it opens, regardless of activity — reconnect to continue.
• Inactivity timeout: 5 minutes. A session with no activity for 5 minutes is closed early.
• Bandwidth cap. Sessions also enforce a bandwidth limit; exceeding it closes the connection.
• Domain access control applies to every navigation in the session using the same rules as /fetch.

Billing

CDP sessions are billed by resource usage — bandwidth transferred and connection time — summed per session and charged when the session ends. The bandwidth rate depends on the session's proxy tier: $10.00/GB on premium (the default), $5.00/GB on standard. See Browser pricing.