Deezer icon

Deezer

Access public song data via the Deezer API
Join our community

Actions43

Overview

This node integrates with the Deezer API to access public music data. Specifically, for the Artist resource and Get Playlist operation, it retrieves playlists associated with a given artist by their ID. This is useful when you want to gather curated or user-generated playlists related to an artist, for example, to analyze popular playlists featuring that artist or to build a music discovery app.

Practical examples:

  • Fetch all playlists that include songs from a specific artist.
  • Use the playlists data to recommend similar artists or tracks.
  • Aggregate playlist metadata for reporting or analytics.

Properties

Name Meaning
Resource ID The unique identifier of the artist whose playlists you want to retrieve (string).
Return All Whether to return all available playlists or limit the number of results (boolean).
Offset The starting position in the list of playlists to return (number, minimum 0).
Limit Maximum number of playlists to return if not returning all (number, minimum 1).

Output

The node outputs an array of JSON objects representing playlists related to the specified artist. Each object contains playlist details as returned by the Deezer API, such as playlist ID, title, description, number of tracks, and other metadata.

If Return All is true, the node paginates through all available playlists; otherwise, it returns up to the specified limit starting from the offset.

No binary data output is produced by this operation.

Dependencies

  • Requires an OAuth2 API credential for Deezer to authenticate requests.
  • Uses the Deezer public API endpoint (https://api.deezer.com).
  • The node internally obtains an access token via the configured OAuth2 credentials.
  • No additional environment variables are required beyond the OAuth2 setup.

Troubleshooting

  • Common issues:

    • Invalid or expired OAuth2 token: Ensure your Deezer OAuth2 credentials are valid and refreshed.
    • Incorrect artist ID: Verify the artist ID exists on Deezer; invalid IDs will cause errors.
    • Rate limiting by Deezer API: If many requests are made rapidly, you may hit rate limits.

  • Error messages:

    • Errors from the Deezer API will be returned in the output JSON under an error field if "Continue On Fail" is enabled.
    • Authentication errors typically indicate problems with the OAuth2 credentials.
    • Pagination parameters (offset, limit) must be within valid ranges; otherwise, the API may reject the request.

Links and References

Discussion