Developer docs

Get a song’s analysis

MCP tool
get_song_analysis
CLI
kinetune songs analysis
GET
/api/v1/songs/{song_id}/analysis

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.

Word-timed lyrics, tempo, beats, sections, hook and the parts a video can be cut to

parts lists where a video can start and end without cutting a word: each section (Verse 1, Chorus 1…), clips of about 15 seconds cut between the lines of long sections (kind "clip", parent: its section) and each verse with the chorus after it (kind "pair"); pass a part’s start and end as a video’s trim (start_seconds, end_seconds), picking one at least as long as the video type’s minimum (a lyric video 8 seconds, a music video 15). default_part is the one the app starts on: the sung part nearest 15 seconds. lyrics.text is the song’s lyrics to edit: yours as you gave them, or the transcription a line per phrase (lyrics.yours says which).

Authorization

headerAuthorizationBearer <token>

An organization API key (kt_live_…) or an OAuth access token

Path Parameters

song_id*string

The song id

Length1 <= length <= 120

Query Parameters

min_seconds?number

The parts for a video at least this long: a music video 15 (its clips are cut no shorter). Default 8, a lyric video

Range8 <= value <= 600

Response Body

OK

Example Request
curl -X GET 'https://kinetune.com/api/v1/songs/string/analysis'
Example Response
Empty