Version 1 · JSON Schema
One stretch of continuous listening. Every field is cumulative: the latest update for a segmentId replaces all earlier ones.
| Field | Type | Required | Description |
|---|---|---|---|
segmentId |
string | yes | Stable for the life of the segment. |
segmentStart |
number | yes | Position where the segment opened (seconds) |
position |
number | yes | Current position (seconds) |
mediaDuration |
number | no | The media’s actual length (seconds) |
playbackRate |
number | yes | |
listenTimeReal |
number | yes | Wall-clock time listened in this segment (seconds) |
listenTimePlayback |
number | yes | Real time multiplied by playback rate (seconds) |
startedAt |
string (date-time) | yes | When the segment opened. |
updatedAt |
string (date-time) | yes | When this state was captured. |
closed |
boolean | yes |