Deezer icon

Deezer

Access public song data via the Deezer API
Join our community

Actions43

Overview

This node allows users to search for artists on Deezer by keyword and apply various filters and sorting options. It is useful for scenarios where you want to find artists matching specific criteria, such as name keywords, associated albums, tracks, or labels, and control the order and number of results returned.

Practical examples include:

  • Searching for artists related to a particular music genre or keyword.
  • Filtering artists by associated album or track names.
  • Sorting search results by ranking, duration, rating, or alphabetical order.
  • Paginating through large sets of artist search results.

Properties

Name Meaning
Search The keyword term to search for (required).
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. (required)
Filters Optional filters to narrow down search results:
- With Artist: Filter by artist name.
- With Album: Filter by album name (required if used).
- 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 only up to a given limit (boolean, required).
Offset The offset of the first object to get (number, used when Return All is false).
Limit Max number of results to return (number, used when Return All is false).

Output

The node outputs an array of JSON objects representing artists that match the search criteria. Each item in the output corresponds to one artist's data as returned by the Deezer API. The exact structure depends on the Deezer API response but typically includes artist details such as name, id, picture URLs, and other metadata.

No binary data output is indicated.

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.
    • Incorrect or missing required parameters like "Search" keyword or "Order" option can lead to request failures.
    • Using filters incorrectly (e.g., missing required "With Album" value when applying album filter) may cause errors or empty results.
    • Rate limiting from Deezer API if too many requests are made in a short time.

  • Error messages:

    • Authentication errors: Ensure the OAuth2 credentials are valid and refreshed.
    • Parameter validation errors: Check that all required fields are filled correctly.
    • Network or API errors: Verify network connectivity and Deezer API status.

Links and References

Discussion