GET
/recommendationsMulti-seed recommendations. Combine up to 5 seeds from tracks, artists, genres or ISRCs, then optionally constrain the result set by target audio features (energy, tempo, valence, danceability). Great for building DJ tools, themed playlists, or mood-aware discovery.
Rate limit
30 req/min
Caching
Cached per seed+target combination for 30 minutes.
Authentication
Send a
User-Agent header containing a contact email. See authentication.Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| seed_tracks | string | optional | Comma-separated track IDs. |
| seed_artists | string | optional | Comma-separated artist IDs. |
| seed_genres | string | optional | Comma-separated genre names, e.g. house,techno. |
| seed_isrcs | string | optional | Comma-separated ISRCs. |
| target_energy | integer | optional | 0 to 1. Results are filtered to within ±0.2 of this value. |
| target_tempo | integer | optional | BPM. Results filtered to within ±20 BPM. |
| target_valence | integer | optional | 0 to 1 (musical positiveness). Filtered within ±0.2. |
| target_danceability | integer | optional | 0 to 1. Filtered within ±0.2. |
| limit | integer | optional | Number of tracks to return. 1-100. Defaults to 20. |
Request
curl 'https://api.synkradio.co.uk/recommendations' \
-H 'User-Agent: [email protected]'Try it
GETTry it
Sends a real requesthttps://api.synkradio.co.uk/recommendations?seed_artists=Daft%20Punk&seed_isrcs=GBUM71505078Response
No example response is captured for this endpoint yet.