Skip to main content
Chapter timestamps use seconds on the final video timeline. Chapter IDs are not stable, so chapter updates always replace the complete list rather than targeting individual chapters.

​
get_chapters

Get every chapter on a video, ordered by timestamp.
​
string
required
Video ID

​
set_chapters

Replace every chapter on a video. Timestamps must be non-negative, ascending, and within the video duration. Pass an empty chapters array to clear all chapters.
​
string
required
Video ID
​
object[]
required
Complete replacement array of {timestampSeconds, title, description} objects