List a video's raw events
The raw, auditable event stream for one video: every play, pause, ended, and conversion, one row at a time. No vanity metric sits on top of it.
This endpoint is paginated. Read events.total for the count, then walk the pages with page and per_page. ip_hash is always null in the API response.
Requires a token with the analytics:read scope.
Server: https://app.trackplay.io/api/v1
Authorizations
A scoped token minted in Settings → API tokens. Send it as Authorization: Bearer tplt_… or X-API-Key: tplt_….
Path Parameters
The video's numeric ID.
Query Parameters
Start of the range, as an ISO date. Defaults to 7 days ago.
End of the range, as an ISO date. Defaults to today.
Timezone the range is read in, as an IANA name. Defaults to UTC.
Return only this event type, e.g. play, pause, ended, or conversion. Omit to return every type.
Which page to return. Defaults to 1.
Rows per page. Defaults to 100. Capped at 500.
x <= 500