---
title: "List Looks"
method: GET
path: "/api/v1/looks"
tags: ["looks"]
---

# List Looks

`GET /api/v1/looks`

## Request

- Base URL: `https://kinetune.com`
- URL: `https://kinetune.com/api/v1/looks`
- 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: `library:read`, `videos:read`)

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.

## Query parameters

- `scope` 'all' | 'official' | 'community' | 'mine': Which library; default all
- `category` string: A category id from get_options
- `lyric_style` string: A lyric style id from get_options (how the lyrics move)
- `artist_id` string: The artist of the song you are choosing for: Looks that show another artist are left out
- `q` string: Search words
- `sort` 'newest' | 'popular'
- `limit` integer
- `offset` integer

## Response `200`

OK

## Other responses

- `201`: Created
- `400`: Invalid request
- `401`: Missing or invalid credentials
- `402`: Not enough credits
- `403`: Missing scope
- `404`: Not found
- `409`: Conflict
- `422`: Unprocessable
- `503`: Temporarily unavailable (AI video): nothing was held; try again after Retry-After seconds

---

[API](https://skmtc.dev/kinetune/apis/kinetune-api.md) · [All operations](https://skmtc.dev/kinetune/apis/kinetune-api/llms.txt) · [OpenAPI document](https://skmtc.dev/kinetune/apis/kinetune-api/revisions/372c8e87d1ff?raw)