Use path for audio and thumbnail for the cover, exactly as returned by the API. There is no fixed song folder. Resolve relative paths against https://music.boocord.com/; keep absolute URLs unchanged.
const base = 'https://music.boocord.com/'; const audioUrl = new URL(song.path, base).href; const coverUrl = song.thumbnail ? new URL(song.thumbnail, base).href : null;
Central song listing API. It can return all songs, a playlist, an album, an artist/persona profile, or songs for a mood. Without a main filter, it returns the current song listing.
| Parameter | Type | Description |
|---|---|---|
playlist | string | Playlist UUID. |
album | integer | Album ID. |
artist | integer | Artist or persona ID. |
mood | integer | Optional mood filter; used alone, it returns songs for that mood. |
genre | integer | Optional genre ID from genres.php. |
search | string | Searches song, artist, mood, and album. |
offset | integer | Default 0. |
limit | integer | Default 20. |
GET https://music.boocord.com/api/request/playlist_v2.php?playlist=9b66d5d3-1f2c-4af0-a13a-4f6e64a5db61 GET https://music.boocord.com/api/request/playlist_v2.php?album=12 GET https://music.boocord.com/api/request/playlist_v2.php?artist=7&search=night GET https://music.boocord.com/api/request/playlist_v2.php?mood=3&limit=10
Returns detail data for exactly one song.
| Parameter | Type | Description |
|---|---|---|
id | integer | Required. Song ID. |
GET https://music.boocord.com/api/request/song_v2.php?id=991
Album listing with search, artist filter, mood filter, and sorting.
| Parameter | Type | Description |
|---|---|---|
search | string | Searches album name, description, or artist. |
artist | integer | Filters by artist ID. |
mood | integer | Only albums with at least one song in this mood. |
sort | string | latest, title, or songs. Default latest. |
offset | integer | Default 0. |
limit | integer | 1 to 100, default 24. |
GET https://music.boocord.com/api/request/albums.php?artist=7&sort=songs
Directory for artist and persona profiles.
| Parameter | Type | Description |
|---|---|---|
kind | string | artist or persona. Default artist. |
search | string | Searches name, nickname, and description. |
offset | integer | Default 0. |
limit | integer | 1 to 100, default 24. |
GET https://music.boocord.com/api/request/artists.php?kind=persona
Returns all available moods/categories. No pagination and no query parameters.
GET https://music.boocord.com/api/request/get_moods.php
Directory for public account profiles. Only profiles with public status are returned.
| Parameter | Type | Description |
|---|---|---|
search | string | Searches username, display name, and description. |
offset | integer | Default 0. |
limit | integer | 1 to 100, default 24. |
GET https://music.boocord.com/api/request/accounts.php?search=tim
Returns playlists of a public account profile including profile metadata.
| Parameter | Type | Description |
|---|---|---|
account | integer | Required. Account ID of a public profile. |
search | string | Optional filter over playlist name and description. |
offset | integer | Default 0. |
limit | integer | 1 to 100, default 24. |
GET https://music.boocord.com/api/request/account_playlists.php?account=5
Paginated browser for playlists owned by public account profiles.
| Parameter | Type | Description |
|---|---|---|
search | string | Searches playlist names, descriptions, usernames, and display names. |
sort | string | popular, newest, songs, or name. Default popular. |
offset | integer | Default 0. |
limit | integer | 1 to 48, default 18. |
GET https://music.boocord.com/api/request/public_playlists.php?sort=popular&limit=18
Song rankings by plays or favorites. Personal rankings require authentication.
| Parameter | Type | Description |
|---|---|---|
chart | string | global_weekly (default), global_total, favorites, user_total or user_weekly. mode is an alternative parameter name. |
search | string | Optional search across songs and profile, category and album names. |
genre | integer | Optional genre ID. |
offset | integer | Default 0. |
limit | integer | 1 to 100, default 20. |
GET https://music.boocord.com/api/request/charts.php?chart=global_weekly&limit=20
Read genres without signing in. Only genres with public songs are returned, most songs first.
| Parameter | Type | Description |
|---|---|---|
search | string | Searches genre name, model label and parent genre name. |
offset | integer | Default 0. |
limit | integer | 1 to 500, default 24. |
GET https://music.boocord.com/api/request/genres.php?limit=24 GET https://music.boocord.com/api/request/genres.php?search=rock&offset=0&limit=24
Safe resize route for local files below files/. The endpoint scales images to a bounding box and returns cached image data.
| Parameter | Type | Description |
|---|---|---|
src | string | Required. Relative path below files/. |
size | string | Required. Either N or WxH. Internally limited to 16 to 1024 pixels per side. |
GET https://music.boocord.com/api/request/image.php?src=files/covers/skyline.webp&size=512x512