Browser overview
Connect Puppeteer or Playwright to a remote Chrome over a CDP WebSocket.
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/wssAuthenticate by sending your API key as an Authorization: Bearer header when connecting.
Connect with Puppeteer
Connect puppeteer-core to the remote browser.
Connect with Playwright
Connect playwright-core over CDP.
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. See Browser pricing.