Deezer icon

Deezer

Access public song data via the Deezer API
Join our community

Actions43

Overview

The Deezer node's Album Search operation allows users to search for albums on the Deezer music platform using a keyword and various filters. This operation is useful when you want to find albums matching specific criteria such as artist name, album title, track name, label, duration range, or tempo (BPM) range. It supports sorting results by different orders like album name, artist name, duration, ranking, rating, or track count.

Common scenarios:

  • Finding albums by a particular artist or label.
  • Searching for albums within a certain duration or BPM range.
  • Retrieving albums sorted by popularity or rating.
  • Integrating Deezer album search into music discovery workflows.

Example use case:
You want to build a playlist of albums released by a specific label with tracks longer than 3 minutes and sort them by rating descending. You can configure this node to search albums with those filters and get relevant results from Deezer.

Properties

Name Meaning
Keyword The keyword term to search for in albums (required).
Order How to order the search results. Options: Album Ascendent, Album Descendent, Artist Ascendent, Artist Descendent, Duration Ascendent, Duration Descendent, Ranking, Rating Ascendent, Rating Descendent, Track Ascendent, Track Descendent. (required)
Filters Optional filters to narrow down search results:
- With Artist: Filter albums by artist name.
- With Album: Filter albums by album name (required if filters used).
- With Track: Filter albums containing a specific track.
- With Label: Filter albums by record label.
- With Duration Minimum: Minimum duration of album tracks (in seconds).
- With Duration Maximum: Maximum duration of album 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 returned (required).
Offset The offset index of the first result to return (used if not returning all).
Limit Maximum number of results to return (used if not returning all).

Output

The output is a JSON array where each item represents an album object returned from the Deezer API search endpoint. Each album object typically contains fields such as album ID, title, artist information, cover images, release date, track count, duration, and other metadata provided by Deezer.

If binary data were involved (e.g., album cover images), it would be summarized accordingly, but this node focuses on JSON metadata output.

Dependencies

  • Requires an API authentication token credential for Deezer OAuth2 API access.
  • Uses the Deezer public API endpoint https://api.deezer.com.
  • Requires n8n credentials setup for Deezer OAuth2 authentication.
  • Relies on internal helper functions for making authenticated requests and handling pagination.

Troubleshooting

  • Common issues:
    • Invalid or expired API token: Ensure your Deezer OAuth2 credentials are valid and refreshed.
    • Missing required parameters: The "Keyword" and "Order" properties must be set; also, if using filters, "With Album" is required.
    • Rate limiting by Deezer API: If many requests are made quickly, you may hit rate limits; implement delays or reduce request frequency.
  • 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 indicate problems with the OAuth2 token.
    • Validation errors occur if required parameters are missing or invalid.

Links and References

Discussion