Boocord Music API

Media URLs

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;

playlist_v2.php

/api/request/playlist_v2.php

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.

ParameterTypeDescription
playliststringPlaylist UUID.
albumintegerAlbum ID.
artistintegerArtist or persona ID.
moodintegerOptional mood filter; used alone, it returns songs for that mood.
genreintegerOptional genre ID from genres.php.
searchstringSearches song, artist, mood, and album.
offsetintegerDefault 0.
limitintegerDefault 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

Notes

  • songs: song objects. path: audio. thumbnail: cover. See Media URLs. hasMore indicates further pages; total may be absent.
  • playlistType depends on the filter, e.g. songs, playlist, album, artist_profile or mood.
  • Optional fields by mode: albumId, artistProfileId, artistProfileType, artistProfileUsesAi, moodId, moodCover.

song_v2.php

/api/request/song_v2.php

Returns detail data for exactly one song.

ParameterTypeDescription
idintegerRequired. Song ID.
GET https://music.boocord.com/api/request/song_v2.php?id=991

Notes

  • Returns the song directly, without a song wrapper, including genres, license details and comment_count.
  • path: audio URL, not a filename for a fixed folder. thumbnail: cover URL.
  • HTTP 400: missing id. HTTP 404: song not found.
  • Play counts use both snake_case and camelCase for compatibility.

albums.php

/api/request/albums.php

Album listing with search, artist filter, mood filter, and sorting.

ParameterTypeDescription
searchstringSearches album name, description, or artist.
artistintegerFilters by artist ID.
moodintegerOnly albums with at least one song in this mood.
sortstringlatest, title, or songs. Default latest.
offsetintegerDefault 0.
limitinteger1 to 100, default 24.
GET https://music.boocord.com/api/request/albums.php?artist=7&sort=songs

artists.php

/api/request/artists.php

Directory for artist and persona profiles.

ParameterTypeDescription
kindstringartist or persona. Default artist.
searchstringSearches name, nickname, and description.
offsetintegerDefault 0.
limitinteger1 to 100, default 24.
GET https://music.boocord.com/api/request/artists.php?kind=persona

get_moods.php

/api/request/get_moods.php

Returns all available moods/categories. No pagination and no query parameters.

GET https://music.boocord.com/api/request/get_moods.php

accounts.php

/api/request/accounts.php

Directory for public account profiles. Only profiles with public status are returned.

ParameterTypeDescription
searchstringSearches username, display name, and description.
offsetintegerDefault 0.
limitinteger1 to 100, default 24.
GET https://music.boocord.com/api/request/accounts.php?search=tim

account_playlists.php

/api/request/account_playlists.php

Returns playlists of a public account profile including profile metadata.

ParameterTypeDescription
accountintegerRequired. Account ID of a public profile.
searchstringOptional filter over playlist name and description.
offsetintegerDefault 0.
limitinteger1 to 100, default 24.
GET https://music.boocord.com/api/request/account_playlists.php?account=5

Notes

  • HTTP 400: account missing or invalid. HTTP 404: no public profile.

public_playlists.php

/api/request/public_playlists.php

Paginated browser for playlists owned by public account profiles.

ParameterTypeDescription
searchstringSearches playlist names, descriptions, usernames, and display names.
sortstringpopular, newest, songs, or name. Default popular.
offsetintegerDefault 0.
limitinteger1 to 48, default 18.
GET https://music.boocord.com/api/request/public_playlists.php?sort=popular&limit=18

Notes

  • Includes public song counts, follower counts and, when signed in, your follow status.

charts.php

/api/request/charts.php

Song rankings by plays or favorites. Personal rankings require authentication.

ParameterTypeDescription
chartstringglobal_weekly (default), global_total, favorites, user_total or user_weekly. mode is an alternative parameter name.
searchstringOptional search across songs and profile, category and album names.
genreintegerOptional genre ID.
offsetintegerDefault 0.
limitinteger1 to 100, default 20.
GET https://music.boocord.com/api/request/charts.php?chart=global_weekly&limit=20

Notes

  • Response: songs, chartMode, playlistType="charts", hasMore. Each song has chart_value and chartValue. total appears only on the last page.
  • Weekly charts start Monday (UTC). Public charts exclude private songs.
  • HTTP 403: personal charts without sign-in. HTTP 429 + Retry-After: too many requests.

genres.php

/api/request/genres.php

Read genres without signing in. Only genres with public songs are returned, most songs first.

ParameterTypeDescription
searchstringSearches genre name, model label and parent genre name.
offsetintegerDefault 0.
limitinteger1 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

Notes

  • genres: list. total: match count. hasMore: more pages. Next page: offset + limit.
  • Fields: id, name, model_label, parent_id, parent_name, description, cover_path, song_count (public songs only).
  • parent_id, parent_name, description and cover_path may be null.
  • Matching songs: pass genre=ID to playlist_v2.php or charts.php. Genres differ from moods/categories.
  • No matches: genres=[], total=0, hasMore=false. Server error: HTTP 500 with error.

image.php

/api/request/image.php

Safe resize route for local files below files/. The endpoint scales images to a bounding box and returns cached image data.

ParameterTypeDescription
srcstringRequired. Relative path below files/.
sizestringRequired. 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

Notes

  • Local images under files/ only. No external URLs.
  • Source formats: JPEG, PNG, WEBP, GIF.
  • HTTP errors: 400, 403, 404, 415, 422.