songs

List songs

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.

get/api/v1/songs

Request

  • Base URL: https://kinetune.com
  • URL: https://kinetune.com/api/v1/songs
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://kinetune.com/api/auth/oauth2/authorize, token URL https://kinetune.com/api/auth/oauth2/token, scopes: music:read, videos:read)

Query parameters

artist_idstring

Only this artist’s songs

qstring

Part of the song title or artist name

limitinteger

Results per page, 1-100 (default 50)

offsetinteger

How many results to skip

status'pending' | 'processing' | 'ready' | 'failed'

Only songs whose analysis has this status (ready = usable for videos)

sort'title' | 'newest'

title (default): by artist then title; newest: latest uploads first

Response

OK

Changes

No recorded changes to this operation across all 1 revision of this API.