Skip to main content
The cursor path and clicks recorded with the clip’s screen recording, mapped onto the clip’s playback timeline (cuts applied). Positions are percentages of the screen dimensions (0-100) — the same coordinate space as zoom focus points, so an event’s position can be used directly as a focusPoint.
All times are milliseconds on the clip’s playback timeline — the video as watched, with cuts applied. It is the same timeline as get_transcript, thumbnails, and previews, so nothing needs converting. A start at or past the end of the clip is rejected with a 400.

​
get_mouse_events

Get the mouse events from the clip’s screen recording. Move events are sampled (clicks are always kept); events during cut-out footage are dropped. Returns an empty list when the recording has no mouse data (camera-only clips, uploads, older recorder versions).
​
string
required
Video ID
​
string
required
Clip ID
​
integer
Sampling interval for move events in ms (default 100). Pass 0 for every recorded event — can be tens of thousands on long recordings.
​
enum<string>[]
Event kinds to return — clicks, moves. Default: both. Use ["clicks"] for click positions only.