Actions43
- Album Actions
- Artist Actions
- Chart Actions
- Playlist Actions
- Podcast Actions
- Track Actions
- User Actions
Overview
This node allows users to search for playlists on Deezer using various keyword and filter criteria. It is useful when you want to find playlists matching specific terms or attributes, such as playlists containing certain artists, albums, tracks, or labels, or filtered by duration and tempo ranges.
Practical examples include:
- Searching for playlists that feature a particular artist or album.
- Finding playlists with tracks within a specific duration or BPM range.
- Ordering search results by ranking, rating, or other criteria.
Properties
| Name | Meaning |
|---|---|
| Search | The keyword term to search for in playlists. |
| Order | The order in which to sort the search results. Options: Album Ascendent/Descendent, Artist Ascendent/Descendent, Duration Ascendent/Descendent, Ranking, Rating Ascendent/Descendent, Track Ascendent/Descendent. |
| Filters | Additional filters to narrow down search results: |
| - With Artist: Filter playlists containing this artist. | |
| - With Album (required): Filter playlists containing this album. | |
| - With Track: Filter playlists containing this track. | |
| - With Label: Filter playlists associated with this label. | |
| - 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 returned. |
| Offset | The offset index of the first result to return (used if not returning all). |
| Limit | The maximum number of results to return (used if not returning all). |
Output
The node outputs an array of JSON objects representing playlists matching the search criteria. Each object contains playlist data as returned by the Deezer API, including metadata such as playlist title, creator, tracks, and other relevant details.
No binary data output is produced 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 proper configuration of the OAuth2 credentials in n8n to obtain access tokens.
Troubleshooting
Common issues:
- Invalid or expired OAuth2 token may cause authentication errors.
- Providing incomplete or invalid filter parameters (e.g., missing required "With Album" filter) can lead to failed searches.
- Exceeding API rate limits may result in temporary request failures.
Error messages:
- Authentication errors typically indicate problems with the OAuth2 credential setup; re-authenticate or check credential validity.
- Validation errors may occur if required parameters are missing; ensure all required fields like "With Album" in filters are provided.
- Network or API errors should be retried or checked for connectivity issues.
Links and References
- Deezer API Documentation: https://developers.deezer.com/api
- Deezer Search Endpoint: https://developers.deezer.com/api/search