docs
Api Reference

Playlist Module

Manage and explore public playlists.

Get Playlist

Fetch metadata for a public playlist.

const playlist = await deezer.playlist({ id: 908622995 });

export interface Playlist {
  id: number;
  title: string;
  description: string;
  duration: number;
  public: boolean;
  is_loved_track: boolean;
  collaborative: boolean;
  nb_tracks: number;
  unseen_track_count: number;
  fans: number;
  link: string;
  share: string;
  picture: string;
  picture_small: string;
  picture_medium: string;
  picture_big: string;
  picture_xl: string;
  checksum: string;
  creator: {
    id: number;
    name: string;
    tracklist: string;
    type: "user";
  };
  type: "playlist";
  tracks?: {
    data: Track[];
  };
}

Contents & Fans

Playlist Tracks

Get the list of tracks contained in a playlist.

const tracks = await deezer.playlist.tracks({ id: 908622995, limit, index });

Playlist Fans

Get the list of users who are fans of this playlist.

const fans = await deezer.playlist.fans({ id: 908622995, limit, index });

Community

Playlist Comments

Get the comments for a playlist.

const comments = await deezer.playlist.comments({ id: 908622995, limit, index });

Discovery

Playlist Radio

Get a radio stream based on the tracks in this playlist.

const radio = await deezer.playlist.radio({ id: 908622995, limit, index });

Track Module

Get detailed information about individual tracks.

Get Track

Fetch metadata for a specific track.

const track = await deezer.track({ id: 3135556 });

Get Track by ISRC

Fetch metadata for a specific track by its ISRC code.

const track = await deezer.track.isrc({ isrc: "GBDUW0000059" });

export interface Track {
  id: number;
  readable: boolean;
  title: string;
  title_short: string;
  title_version?: string;
  isrc?: string;
  link: string;
  share: string;
  duration: number;
  track_position?: number;
  disk_number?: number;
  rank: number;
  release_date?: string;
  explicit_lyrics: boolean;
  explicit_content_lyrics: number;
  explicit_content_display: number;
  preview: string;
  bpm?: number;
  gain?: number;
  available_countries?: string[];
  contributors?: Artist[];
  md5_image: string;
  artist: Artist;
  album?: Album;
  type: "track";
}

Alternative Track

Get an alternative version of a track.

const alternative = await deezer.track.alternative(3135556);

Artist Module

Fetch information about artists, their top tracks, albums, and more.

Charts Module

Access global or category-specific charts (rankings).

Copyright © 2026