List songs
- MCP tool
list_songs- CLI
kinetune songs 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.
Songs with their cover, duration and analysis status
A song must be analyzed (analysis.status "ready") before videos can be made. 50 per page by default: pass q to search, and limit/offset to page. cover_art.url is the cover at up to 1536 px (JPEG; width and height describe it), preview_url a 640 px and thumbnail_url a 160 px WebP. Image links are signed for 7 days and stay the same all day, so they can be cached.
AuthorizationBearer <token>An organization API key (kt_live_…) or an OAuth access token
artist_id?stringOnly this artist’s songs
1 <= length <= 120q?stringPart of the song title or artist name
length <= 100limit?integerResults per page, 1-100 (default 50)
1 <= value <= 100offset?integerHow many results to skip
0 <= value <= 9007199254740991status?stringOnly songs whose analysis has this status (ready = usable for videos)
"pending""processing""ready""failed"sort?stringtitle (default): by artist then title; newest: latest uploads first
"title""newest"curl -X GET 'https://kinetune.com/api/v1/songs'