Deezer icon

Deezer

Access public song data via the Deezer API
Join our community

Actions43

Overview

This node integrates with the Deezer API to retrieve public music-related data. Specifically, for the Artist resource and the Get Fans operation, it fetches a list of users who are fans of a particular artist identified by their Resource ID. This is useful for scenarios where you want to analyze or engage with an artist's fanbase, such as marketing campaigns, fan engagement analytics, or building personalized music experiences.

Practical example:
You could use this node to get all fans of a popular artist to send them targeted notifications or to analyze demographic trends among the fanbase.

Properties

Name Meaning
Resource ID The unique identifier of the artist 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.
Limit The maximum number of fan records to return if not returning all.

Output

The output is a JSON array where each element represents a user object corresponding to a fan of the specified artist. Each user object contains details about the fan as provided by the Deezer API.

If the Return All property is set to true, the node will paginate through all available fans and return the complete list; otherwise, it returns up to the specified limit starting from the offset.

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).
  • Requires n8n environment configured with the appropriate Deezer OAuth2 credentials.

Troubleshooting

  • Common issues:

    • Invalid or expired OAuth2 token may cause authentication failures.
    • Providing an incorrect or non-existent Resource ID will result in empty or error responses.
    • Exceeding API rate limits may cause request failures.

  • Error messages:

    • Errors returned from the Deezer API will be included in the output if "Continue on Fail" is enabled.
    • Authentication errors typically indicate issues with the OAuth2 credentials setup.
    • Pagination parameters (Offset and Limit) must be valid numbers; invalid values may cause errors.

To resolve these:

  • Ensure your Deezer OAuth2 credentials are correctly configured and valid.
  • Verify the Resource ID corresponds to an existing artist.
  • Adjust pagination parameters within allowed ranges.

Links and References

Discussion