playlists

Fetch a list of playlists

Fetch a filtered, sorted, paginated list of playlists

get/playlists

Request

  • Base URL: https://phish.in/api/v2
  • URL: https://phish.in/api/v2/playlists
  • Auth: none declared

Query parameters

pageinteger

Page number for pagination (min: 1)

per_pageinteger

Number of items per page for pagination (min: 1, max: 1000)

sort'name:asc' | 'name:desc' | 'likes_count:asc' | 'likes_count:desc' | 'tracks_count:asc' | 'tracks_count:desc' | 'duration:asc' | 'duration:desc' | 'updated_at:asc' | 'updated_at:desc'

Sort by attribute and direction (e.g., 'likes_count:desc')

filter'all' | 'mine' | 'liked'

Filter by user ownership or user likes. Requires authentication.

Response

Fetch a list of playlists

idinteger required

ID of the playlist

slugstring required

The unique slug for the playlist

namestring required

The display name of the playlist

descriptionstring required

The description of the playlist

usernamestring required
durationinteger required

The total duration of all tracks in the playlist, in milliseconds

cover_art_track_idinteger required

ID of the track whose show cover art represents the playlist

cover_art_urlsunknown required
tracks_countinteger required

The number of tracks in the playlist

likes_countinteger required

The number of likes the playlist has received

created_atstring required

Timestamp of initial creation

updated_atstring required

Timestamp of most recent update

publishedboolean required

Indicates if the playlist is listed publicly for other users to browse and search

liked_by_userboolean required

Indicates if the current user has liked this playlist

Changes

No recorded changes to this operation across all 1 revision of this API.