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 | number | 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 | number | optional | 0 to 1 (musical positiveness). Filtered within ±0.2. |
| target_danceability | number | 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_tracks=3135556%2C921278&seed_artists=4860761&seed_genres=house&seed_isrcs=GBUM71505078&target_energy=0.4&target_tempo=125&target_valence=0.6&limit=15Response
200 application/json
{
"seeds": {
"tracks": [
"3135556"
],
"artists": [],
"genres": [],
"isrcs": []
},
"targets": {
"energy": null,
"tempo": null,
"valence": null,
"danceability": null
},
"trackCount": 2,
"tracks": [
{
"id": 3135559,
"name": "Superheroes",
"artist": "Daft Punk",
"artistId": 27,
"album": "Discovery",
"durationMs": 237000,
"explicit": false,
"isrc": null,
"cover": "https://api.synkradio.co.uk/cover?artist=Daft%20Punk&title=Superheroes"
},
{
"id": 445849582,
"name": "Helix",
"artist": "Justice",
"artistId": 6404,
"album": "Audio, Video, Disco.",
"durationMs": 268000,
"explicit": false,
"isrc": null,
"cover": "https://api.synkradio.co.uk/cover?artist=Justice&title=Helix"
}
]
}Response schema
| Field | Type | Example | Description |
|---|---|---|---|
| seeds | object | 4 fields | |
| targets | object | 4 fields | |
| trackCount | number | 2 | Number of tracks on the release. |
| tracks | array<object> | 2 items | Tracklist for the release. |