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 Playlist resource and the Get Fans operation, it retrieves a list of users who are fans of a specified playlist. This can be useful for applications that want to analyze or display the audience engagement of playlists, such as marketing dashboards, fan analytics tools, or social music apps.

For example, you might use this node to:

  • Fetch all fans of a popular playlist to understand its reach.
  • Display fan information alongside playlist details in a music discovery app.
  • Aggregate fan counts across multiple playlists for reporting purposes.

Properties

Name Meaning
Resource ID The unique identifier of the playlist whose fans you want to retrieve (e.g., "1234567").
Return All Whether to return all fans or limit the number of results returned.
Offset The starting position in the list of fans from which to begin returning results (default 0).
Limit The maximum number of fan records to return if not returning all (default 50).

Output

The output is a JSON array where each element represents a fan user object associated with the specified playlist. Each user object contains public user data as provided by the Deezer API (such as user id, name, etc.). The node does not output binary data.

Example output structure (simplified):

[
  {
    "id": 12345,
    "name": "Fan User Name",
    "link": "https://www.deezer.com/user/12345",
    ...
  },
  ...
]

Dependencies

  • Requires an OAuth2 API credential for Deezer to authenticate requests.
  • Uses the Deezer public API endpoint https://api.deezer.com.
  • The node internally uses helper functions to obtain an access token and make HTTP requests to Deezer.

Troubleshooting

  • Authentication errors: Ensure the OAuth2 credentials are correctly configured and valid. Expired or invalid tokens will cause request failures.
  • Invalid Resource ID: Providing a non-existent or incorrect playlist ID will result in errors or empty results.
  • Rate limiting: Deezer API may limit the number of requests; if you encounter rate limit errors, consider adding delays or reducing request frequency.
  • Pagination issues: If Return All is false and Limit is set too low, you may not get the full list of fans. Use Return All to fetch all fans.
  • Network errors: Check your network connectivity and proxy settings if requests fail unexpectedly.

Links and References

Discussion