Deezer icon

Deezer

Access public song data via the Deezer API
Join our community

Actions43

Overview

This node allows users to search for podcasts on Deezer using various keyword-based criteria. It is useful when you want to find podcasts matching specific terms or filters such as artist, album, track, label, duration, or tempo. For example, you could search for podcasts related to a particular topic or by a certain artist, and sort the results by ranking or duration.

Common scenarios include:

  • Finding new podcasts based on keywords.
  • Filtering podcasts by attributes like duration or label.
  • Sorting podcast search results by different criteria such as rating or track name.

Properties

Name Meaning
Search The keyword term to search for in podcasts.
Order The order in which to sort 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.
Filters Optional filters to narrow down search results:
- With Artist: Filter by artist name.
- With Album: Filter by album name (required).
- With Track: Filter by track name.
- With Label: Filter by label name.
- With Duration Minimum: Minimum duration filter (number).
- With Duration Maximum: Maximum duration filter (number).
- With Tempo(BPM) Minimum: Minimum tempo in BPM (number).
- With Tempo(BPM) Maximum: Maximum tempo in BPM (number).
Return All Whether to return all results or limit the number of results 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 the podcasts found by the search query. Each object contains detailed information about a podcast matching the search criteria, including metadata such as title, artist, album, duration, rating, and other relevant fields provided by the Deezer API.

No binary data output is indicated for 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

  • Authentication errors: Ensure that the Deezer OAuth2 credentials are correctly set up and valid.
  • Empty results: Check that the keyword and filters are correctly specified; overly restrictive filters may yield no results.
  • Rate limiting or API errors: Deezer API may limit requests; handle errors gracefully and consider retrying after some time.
  • Invalid parameter values: Make sure numeric filters like duration and tempo are within reasonable ranges.

Links and References

Discussion