List videos
- MCP tool
list_videos- CLI
kinetune videos list
Try it with your own API key: it runs on that key's workspace, so a real key reads your real songs, videos and credits. Reads and quotes only; nothing is charged.
Videos, newest first, with status and thumbnails
A page at a time (limit, default 50): next_cursor is null on the last page, otherwise pass it as cursor for the next one with the same filters. counts says how many videos match song_id, artist_id and q: all, and by type (lyric_video, canvas, music_video). Each video's outputs carry aspect_ratio, poster_url, poster_seconds and web_url (for thumbnails and previews); get_video has the download links. A video that is waiting has queue: why (plan_limit or render_capacity), its place in line or about how long.
AuthorizationBearer <token>An organization API key (kt_live_…) or an OAuth access token
song_id?stringOnly this song’s videos
1 <= length <= 120artist_id?stringOnly videos of this artist’s songs
1 <= length <= 120type?string"lyric-video""canvas""music-video"q?stringSearch the song title, artist name, Look name or video id
1 <= length <= 100limit?integer1 <= value <= 100cursor?stringnext_cursor from the previous page
1 <= length <= 200curl -X GET 'https://kinetune.com/api/v1/videos'