Skip to main content
GET
/
browser
/
stream
Live browser session with event streaming (SSE)
curl --request GET \
  --url https://scraping-api.55-tech.com/browser/stream \
  --header 'X-API-Key: <api-key>'
"event: connected\ndata: {\"type\":\"connected\",\"url\":\"https://example.com\",\"agent_id\":\"scraping-us5\"}\n\nevent: ws_message\ndata: {\"type\":\"ws_message\",\"data\":\"{\\\"price\\\":1.95}\",\"ws_id\":\"1234\"}\n\n"

Authorizations

X-API-Key
string
header
required

API key passed in the X-API-Key header.

Headers

X-Target-URL
string

Target URL (no encoding needed). Recommended for URLs with query parameters.

X-Capture
string
default:network,ws,console

Comma-separated event types to stream: network, ws, dom, console.

X-DOM-Selector
string

CSS selector to watch for DOM mutations (requires dom in X-Capture).

X-Network-Filter
string

Regex filter for network URLs. Only matching responses are streamed.

X-WS-Filter
string

Regex filter for WebSocket URLs. Only matching connections are streamed.

X-JS-After-Load
string

JavaScript to execute after page load (e.g. click a button, trigger navigation).

X-Wait-Strategy
string
default:load

When the page is ready before streaming starts: load, networkidle, or selector.

X-Wait-Selector
string

CSS selector to wait for (with X-Wait-Strategy: selector).

X-Proxy
string

Route through a proxy (http:// or socks5://).

X-Block-Resources
string

Comma-separated resource types to block: image, font, stylesheet, media.

Cookies to inject (name=value; name2=value2).

X-Cookies
string

Cookies as JSON array for full control.

X-Geo
string

Target countries as comma-separated ISO codes (e.g. US,DE,AT). Aliases: X-Geo-CC, X-CC, X-Country, X-Geo-Strict.

X-Agent
string

Route through specific agent(s) by slug (e.g. de1) or comma-separated list for random pick (e.g. de1,at5,us3).

X-Timeout
string

Override request timeout in seconds (default: 30).

Response

SSE event stream. Events: connected, network, ws_open, ws_message, ws_close, dom, console, error, done.

The response is of type string.