Artist - antoineraulin/deezer-api GitHub Wiki

An artist object

INFO ACTIONS ARTIST METHODS

INFO

Retrieve information from an album

deezer.get("artist",{id: "27"}) //will retrieve information from artist #27

Result :

Name Description Type
id The artist's Deezer id int
name The artist's name string
link The url of the artist on Deezer url
share The share link of the artist on Deezer url
picture The url of the artist picture. Add 'size' parameter to the url to change size. Can be 'small', 'medium', 'big', 'xl' url
picture_small The url of the artist picture in size small. url
picture_medium The url of the artist picture in size medium. url
picture_big The url of the artist picture in size big. url
picture_xl The url of the artist picture in size xl. url
nb_album The number of artist's albums int
nb_fan The number of artist's fans int
radio true if the artist has a smartradio boolean
tracklist API Link to the top of this artist url

ACTIONS

Related actions

user / artists
Usage Description Required params
deezer.post("user",{method:"artists",artist_id:"artist_id"}) Add an artist to the user's favorites artist_id
The id of the artist
int
deezer.delete("user",{method:"artists",artist_id:"artist_id"}) Remove an artist from the user's favorites artist_id
The id of the artist
int

ARTIST METHODS

  • top:

    Description

    Get the top 5 tracks of an artist

    deezer.get("artist",{method:"top",id: "27"})

    Result

    Name Description Type
    id The track's Deezer id int
    readable true if the track is readable in the player for the current user boolean
    title The track's fulltitle string
    title_short The track's short title string
    title_version The track version string
    link The url of the track on Deezer url
    duration The track's duration in seconds int
    rank The track's Deezer rank int
    explicit_lyrics Whether the track contains explicit lyrics boolean
    preview The url of track's preview file. This file contains the first 30 seconds of the track url
    contributors Return a list of contributors on the track list
    artist artist object containing : id, name object
    album album object containing : id, title, cover, cover_small, cover_medium, cover_big, cover_xl object
  • albums:

    Description

    Return a list of artist's albums. Represented by an array of Album objects

    deezer.get("artist",{method:"albums",id: "27"})

    Result

    Name Description Type
    id The Deezer album id int
    title The album title string
    link The url of the album on Deezer url
    cover The url of the album's cover. Add 'size' parameter to the url to change size. Can be 'small', 'medium', 'big', 'xl' url
    cover_small The url of the album's cover in size small. url
    cover_medium The url of the album's cover in size medium. url
    cover_big The url of the album's cover in size big. url
    cover_xl The url of the album's cover in size xl. url
    genre_id The album's first genre id (You should use the genre list instead). NB : -1 for not found int
    fans The number of album's Fans int
    release_date The album's release date date
    record_type The record type of the album (EP / ALBUM / etc..) string
    explicit_lyrics Whether the album contains explicit lyrics boolean
  • comments:

    Description

    Return a list of artist's comments. Represented by an array of Comment objects

    deezer.get("artist",{method:"comments",id: "27"})

    Result

    Name Description Type
    id The comment's Deezer id int
    text The content of the comment string
    date The date the comment was posted timestamp
    author user object containing : id, name, link, picture, picture_small, picture_medium, picture_big, picture_xl object
  • fans:

    Description

    Return a list of artist's fans. Represented by an array of User objects

    deezer.get("artist",{method:"fans",id: "27"})

    Result

    Name Description Type
    id The user's Deezer ID int
    name The user's Deezer nickname string
    link The url of the profil for the user on Deezer url
    picture The url of the user's profil picture. Add 'size' parameter to the url to change size. Can be 'small', 'medium', 'big', 'xl' url
    picture_small The url of the user's profil picture in size small. url
    picture_medium The url of the user's profil picture in size medium. url
    picture_big The url of the user's profil picture in size big. url
    picture_xl The url of the user's profil picture in size xl. url
  • related:

    Description

    Return a list of related artists. Represented by an array of Artist objects

    deezer.get("artist",{method:"related",id: "27"})

    Result

    Name Description Type
    id The artist's Deezer id int
    name The artist's name string
    link The url of the artist on Deezer url
    picture The url of the artist picture. Add 'size' parameter to the url to change size. Can be 'small', 'medium', 'big', 'xl' url
    picture_small The url of the artist picture in size small. url
    picture_medium The url of the artist picture in size medium. url
    picture_big The url of the artist picture in size big. url
    picture_xl The url of the artist picture in size xl. url
    nb_album The number of artist's albums int
    nb_fan The number of artist's fans int
    radio true if the artist has a smartradio boolean
  • radio:

    Description

    Return a list of tracks. Represented by an array of Track object

    deezer.get("artist",{method:"radio",id: "27"})

    Result

    Name Description Type
    id The track's Deezer id int
    readable true if the track is readable in the player for the current user boolean
    title The track's fulltitle string
    title_short The track's short title string
    title_version The track version string
    duration The track's duration in seconds int
    rank The track's Deezer rank int
    explicit_lyrics Whether the track contains explicit lyrics boolean
    preview The url of track's preview file. This file contains the first 30 seconds of the track url
    artist artist object containing : id, name, picture, picture_small, picture_medium, picture_big, picture_xl object
    album album object containing : id, title, cover, cover_small, cover_medium, cover_big, cover_xl object
  • playlists:

    Description

    Return a list of tracks. Represented by an array of Track object

    deezer.get("artist",{method:"playlists",id: "27"})

    Result

    Name Description Type
    id The playlist's Deezer id int
    title The playlist's title string
    public If the playlist is public or not boolean
    link The url of the playlist on Deezer url
    picture The url of the playlist's cover. Add 'size' parameter to the url to change size. Can be 'small', 'medium', 'big', 'xl' url
    picture_small The url of the playlist's cover in size small. url
    picture_medium The url of the playlist's cover in size medium. url
    picture_big The url of the playlist's cover in size big. url
    picture_xl The url of the playlist's cover in size xl. url
    checksum The checksum for the track list string
    user user object containing : id, name object
⚠️ **GitHub.com Fallback** ⚠️