Deezer icon

Deezer

Access public song data via the Deezer API
Join our community

Actions43

Overview

This node allows users to search for tracks on Deezer using various keyword and filter criteria. It is useful when you want to find specific music tracks based on keywords, sorting preferences, and detailed filters such as artist name, album, duration, or tempo. For example, you could use this node to search for all tracks by a particular artist with a minimum duration or to find tracks sorted by rating.

Properties

Name Meaning
Search The keyword term to search for in the track data.
Order The order in which to sort the search results. Options include: Album Ascendent/Descendent, Artist Ascendent/Descendent, Duration Ascendent/Descendent, Ranking, Rating Ascendent/Descendent, Track Ascendent/Descendent.
Filters A collection of optional filters to narrow down the search results:
- With Artist: Filter tracks by artist name.
- With Album (required): Filter tracks by album name.
- With Track: Filter tracks by track name.
- With Label: Filter tracks by label name.
- With Duration Minimum: Minimum duration of tracks (in seconds).
- With Duration Maximum: Maximum duration of tracks (in seconds).
- With Tempo(BPM) Minimum: Minimum tempo in beats per minute.
- With Tempo(BPM) Maximum: Maximum tempo in beats per minute.
Return All Whether to return all matching results or limit the number of results returned.
Offset The offset index from which to start returning results (used if not returning all).
Limit The maximum number of results to return (used if not returning all).

Output

The output is a JSON array where each item represents a track object returned from the Deezer API search endpoint. Each track object contains metadata about the track such as title, artist, album, duration, rating, and other relevant details provided by Deezer.

If binary data were involved (e.g., audio files), it would be summarized here, but this node only returns JSON metadata about tracks.

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 errors. Refresh or re-authenticate the Deezer credentials.
    • Providing invalid filter values (e.g., non-numeric duration or BPM) may result in API errors.
    • If no results are returned, verify that the keyword and filters are correctly specified and that the offset/limit parameters are within valid ranges.

  • 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 issues with the OAuth2 token.
    • Rate limiting or quota exceeded errors may occur if too many requests are made in a short time.

Links and References

Discussion