Skip to main content

Subscribe to stream events (NDJSON)

GET 
/api/v1/live/streams/:stream_id/events

Long-lived NDJSON stream of real-time events for one stream. Each line is a JSON object with an event field:

  • {"event": "watching", ...} — current stream state snapshot
  • {"event": "break_detected", ...} — new ad boundary found
  • {"event": "scene", ...} — segment analysis complete
  • {"event": "aggregate", ...} — burst aggregation updated
  • {"event": "burst_done", ...} — burst processing finished
  • {"event": "keepalive"} — idle heartbeat (ignore)

The connection closes when the stream transitions to stopped or is deleted.

Request​

Responses​

Successful Response