Unofficial Tidal API

class tidal_unofficial.TidalUnofficial(options={})[source]

Instantiate a Tidal object.

Parameters

options (dict) – Dictionary containing the options for the API call.

static album_art_to_url(uuid)[source]

Get valid urls to album art.

Parameters

uuid (string) – Album art uuid (can be found as cover property in album object)

Returns

Dictionary containing album arts in different sizes.

Return type

dict

static artist_pic_to_url_4_3(uuid)[source]

Get valid urls to artist pictures (4:3).

Parameters

uuid (string) – Artist picture uuid (can be found as picture property in artist object)

Returns

Dictionary containing artist pictures in different sizes.

Return type

dict

static artist_pic_to_url_box_1_1(uuid)[source]

Get valid urls to artist pictures (1:1).

Parameters

uuid (string) – Artist picture uuid (can be found as picture property in artist object)

Returns

Dictionary containing artist pictures in different sizes.

Return type

dict

get_album(id)[source]

Get an albums’s data by its ID.

Parameters

id (str) – Album ID

Returns

Dictionary containing all the information about an album.

Return type

dict

get_album_tracks(id)[source]

Get an albums’s tracks by its ID.

Parameters

id (str) – Album ID

Returns

List containing all the tracks from an album.

Return type

list

get_artist(id)[source]

Get an artist’s data by its ID.

Parameters

id (str) – Artist ID

Returns

Dictionary containing all the information about an artist.

Return type

dict

get_artist_albums(id, limit=25, offset=0)[source]

Get an artist’s albums, EPs and singles by its ID.

Parameters

  • id (str) – Artist ID

  • limit (int) – Results limit (default 25)

  • offset (int) – Results offset

Returns

List containing all the albums, EPs and singles from an artist.

Return type

list

get_artist_compilations(id, limit=25, offset=0)[source]

Get compliations that an artist has appeared on by artist id.

Parameters

  • id (str) – Artist ID

  • limit (int) – Results limit (default 25)

  • offset (int) – Results offset

Returns

List containing all the compliations that an artist has appeared on.

Return type

list

get_artist_top_tracks(id, limit=25, offset=0)[source]

Get an artist’s top tracks its id.

Parameters

  • id (str) – Artist ID

  • limit (int) – Results limit (default 25)

  • offset (int) – Results offset

Returns

List containing the artist’s top N tracks.

Return type

list

Get TIDAL’s featured albums (internal API).

Returns

Dictionary containing all the currently featured albums.

Return type

dict

get_new_albums()[source]

Get new albums on TIDAL.

Returns

List containing the newest albums (no fixed number).

Return type

list

get_playlist_info(uuid)[source]

Get a playlist’s data by its UUID.

Parameters

uuid – Playlist’s UUID

Returns

Dictionary containing all the information about a playlist.

Return type

dict

get_playlist_tracks(uuid, limit=25, offset=0)[source]

Get a playlist’s tracks by its UUID.

Parameters

  • uuid – Playlist’s UUID

  • offset (int) – Results offset

Returns

List containing the tracks from a playlist.

Return type

list

get_similar_artists(id, limit=25, offset=0)[source]

Get artists similar to another by its ID.

Parameters

  • id (str) – Artist ID

  • limit (int) – Results limit (default 25)

  • offset (int) – Results offset

Returns

List containing all the artists similar to another.

Return type

list

get_staff_pick_albums()[source]

Get staff picked albums on TIDAL.

Returns

List containing the current staff picked albums (no fixed number).

Return type

list

get_top_albums()[source]

Get TIDAL’s top 20 albums.

Returns

List containing the current top 20 albums.

Return type

list

get_track(id)[source]

Get a track’s data by its ID.

Parameters

id (str) – Track ID

Returns

Dictionary containing all the information about a track.

Return type

dict

get_video(id)[source]

Get a video’s data by its ID.

Parameters

id (str) – Video ID

Returns

Dictionary containing all the information about a video.

Return type

dict

search(query, search_type, limit=25, offset=0)[source]

Search for artists, albums, tracks, or playlists.

Parameters

  • query (str) – Search query

  • search_type – Search type (‘artists’, ‘albums’, ‘tracks’, ‘playlists’)

  • limit (int) – Results limit

  • offset (int) – Results offset

Returns

Dictionary containing the list of items (item properties are dependent on search type).

Return type

dict