YouTube audience retention
The retention curve for one video: what share of viewers is still watching at each point of the video, plus how that compares with similar videos on YouTube. Rows are ordered by elapsedVideoTimeRatio, from 0 (start) to 1 (end).
This reads the YouTube Analytics API, which needs its own OAuth permission (yt-analytics.readonly). SmartlyQ only began requesting it on 28 July 2026, so channels connected before that answer 403 CONNECTION_SCOPE_MISSING with reconnect_required: true until the account is reconnected. Requires scope analytics:read.
Authorizations
API key from Developer dashboard (Bearer token).
Query Parameters
A connected YouTube channel (social account id).
YouTube video id (the v= value from its URL).
Start of the range, YYYY-MM-DD. Defaults to 28 days before end_date.
End of the range, YYYY-MM-DD. Defaults to yesterday.

