Live story stream (server-sent events)
text/event-stream endpoint that pushes story changes as they happen. Emits event: story.new when a cluster first appears and event: story.updated when an existing cluster changes. Each event id is the change timestamp; send it as the Last-Event-ID request header (or a since query param) to resume after a disconnect. Each data field is one StorySummary JSON object. Optional topics and tier query params filter which events are delivered, in both replay and live broadcast. The same URL also accepts a WebSocket upgrade (Upgrade: websocket) with the same filters plus since for replay; each WebSocket message is a JSON string { id, type, story }. SSE heartbeat comments have the form ": ping lastEventId=<id or none>" so idle clients can detect missed events.
Request
- Base URL: https://techsnif.com
- URL: https://techsnif.com/api/stream
- Auth: none declared
Query parameters
Comma-separated topic slugs (e.g. ai,security). Only events whose story topics intersect the list are delivered.
Minimum headline tier. Only events with story tier at or above this value are delivered (3 = top stories). Stories without a tier count as 0.
Response
SSE stream of story.new and story.updated events
Changes
No recorded changes to this operation across all 1 revision of this API.