Read a video's retention curve
The share of viewers still watching at each point through the video. Plot it to see the exact second your VSL loses people.
Each bucket carries watch_pct as a fraction between 0 and 1, not a percent. 0.5 means half of viewers reached that point. Multiply by 100 to render a percentage.
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 30 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.
How many points to divide the video into. Defaults to 100. Capped at 200.
x <= 200