Deezer icon

Deezer

Access public song data via the Deezer API

Overview

This node integrates with the Deezer API to access public music data. Specifically, for the Artist resource and the Get Related Artists operation, it retrieves a list of artists related to a specified artist by their ID. This is useful for music discovery workflows, recommendation systems, or building playlists based on similar artists.

Practical examples:

  • Given an artist ID, fetch related artists to suggest new music to users.
  • Enrich a music database with connections between artists.
  • Automate playlist creation by including related artists' tracks.

Properties

Name Meaning
Resource ID The unique identifier of the artist whose related artists you want to retrieve (string).
Return All Whether to return all related artists or limit the number of results (boolean).
Offset The starting position in the list of related artists from which to begin returning results (number, minimum 0). Only shown if "Return All" is false.
Limit Maximum number of related artists to return (number, minimum 1). Only shown if "Return All" is false.

Output

The output is a JSON array where each item represents a related artist object as returned by the Deezer API. Each artist object typically includes details such as artist ID, name, picture URLs, and other metadata describing the artist.

No binary data is output 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 provided credentials before making API calls.

Troubleshooting

  • Common issues:

    • Invalid or expired OAuth2 credentials will cause authentication failures.
    • Providing an incorrect or non-existent artist ID will result in empty or error responses.
    • Rate limiting by Deezer API may occur if too many requests are made in a short time.
  • Error messages:

    • Errors from the Deezer API are propagated; typical messages include "Invalid access token" or "Resource not found".
    • To resolve, verify that the OAuth2 credentials are valid and that the artist ID exists.
    • Use the "Return All" property carefully to avoid large data requests that might trigger rate limits.

Links and References

Discussion