Deezer icon

Deezer

Access public song data via the Deezer API

Overview

This node interacts with the Deezer API to retrieve information about users and their followings. Specifically, the "Get Followings" operation under the "User" resource fetches the list of users that a specified user is following. This can be useful in scenarios where you want to analyze or display social connections on Deezer, such as building a music social network dashboard, tracking influencers, or aggregating followed artists and users.

For example, you could use this node to:

  • Retrieve all users followed by the logged-in user.
  • Fetch followings of any specific user by their user ID.
  • Paginate through large lists of followings using offset and limit parameters.

Properties

Name Meaning
Return My User Boolean option to choose whether to return the followings of the logged-in user (true) or a specific user (false).
User ID The Deezer user ID of the specific user whose followings you want to retrieve (required if "Return My User" is false).
Return All Whether to return all followings or limit the number of results returned.
Offset The starting index (offset) from which to return followings when not returning all.
Limit Maximum number of followings to return when not returning all.

Output

The output is a JSON array where each item represents a user that the target user is following. Each user object typically contains standard Deezer user fields such as user ID, name, and other public profile details.

If binary data were involved (not applicable here), it would represent media files or images, but this operation only returns JSON user data.

Dependencies

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

Troubleshooting

  • Common issues:

    • Invalid or expired OAuth2 token: Ensure your Deezer OAuth2 credentials are valid and refreshed.
    • Incorrect user ID: If specifying a user ID, verify it exists and is accessible.
    • Rate limiting by Deezer API: If many requests are made rapidly, you may hit rate limits; implement delays or reduce request frequency.
  • Error messages:

    • Errors returned from the Deezer API will be included in the output if "Continue On Fail" is enabled.
    • Typical errors include authentication failures, invalid parameters, or network issues.
    • To resolve, check credentials, parameter correctness, and network connectivity.

Links and References

Discussion