List Looks

MCP tool: list_looks
CLI: kinetune looks list

GET

/api/v1/looks

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.

Browse Official, Community and your own Looks

A Look is a complete, reusable lyric-video design. Pass its id as {"mode":"existing","id":…} to reuse it exactly. A Look that shows an artist (featured_artist) is private and only serves that artist's songs: choosing for a song, pass its artist_id to leave out Looks that show another artist.

Authorization

headerAuthorizationBearer <token>

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

Query Parameters

scope?string

Which library; default all

Value in"all""official""community""mine"

category?string

A category id from get_options

Lengthlength <= 40

lyric_style?string

A lyric style id from get_options (how the lyrics move)

Lengthlength <= 40

artist_id?string

The artist of the song you are choosing for: Looks that show another artist are left out

Length1 <= length <= 120

q?string

Search words

Lengthlength <= 100

sort?string

Value in"newest""popular"

limit?integer

Range1 <= value <= 100

offset?integer

Range0 <= value <= 9007199254740991

Response Body

Example Request

curl -X GET 'https://kinetune.com/api/v1/looks'

Example Response

Empty

AuthorizationCopy Anchor Link

Query ParametersCopy Anchor Link

Response BodyCopy Anchor Link

Authorization

Query Parameters

Response Body