Public read API for current endpoints

This documentation describes the public read endpoints under /api/request/. Responses are JSON unless noted otherwise.

Endpoints API Terms Imprint Privacy policy Terms of use

playlist_v2.php

/api/request/playlist_v2.php
GET

Central song listing API. It can return all songs, a playlist, an album, an artist/persona profile, or a mood feed. Without a main filter, it returns the current song feed.

ParameterTypeDescription
playliststringPlaylist UUID.
albumintegerAlbum ID.
artistintegerArtist or persona ID.
moodintegerOptional mood filter; used alone, it returns a mood feed.
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

  • playlistType can be songs, playlist, album, artist_profile, or mood depending on context.
  • Depending on the mode, additional fields such as albumId, artistProfileId, artistProfileType, artistProfileUsesAi, moodId, or moodCover may be present.

song_v2.php

/api/request/song_v2.php
GET

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 400 if id is missing and 404 if the song does not exist.
  • Playback counters are returned in snake_case and camelCase for compatibility.

albums.php

/api/request/albums.php
GET

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
GET

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
GET

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
GET

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
GET

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

  • Returns 400 if account is missing or invalid and 404 if the account has no public profile.

home_overview_feed.php

/api/request/home_overview_feed.php
GET

Public home overview with counters, latest songs, info posts, and mixed feed. Logged-in users receive additional viewer context.

ParameterTypeDescription
feed_limitinteger5 to 30, default 30.
feed_pageintegerPage number starting at 1.
 
GET https://music.boocord.com/api/request/home_overview_feed.php?feed_limit=10&feed_page=1

image.php

/api/request/image.php
GET

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

  • Only local images below files/ are allowed; external URLs are blocked.
  • Accepted source formats: JPEG, PNG, WEBP, GIF.
  • Possible error codes: 400, 403, 404, 415, 422.