latestOpenAPI 3.1.02026-08-10202033.2 KB

d8deec5eca44

Get Recommendations By Features

Get track recommendations matching specific audio features.

Parameters:

<b>features</b> : TargetFeatures (Target audio characteristics)<br> - tempo: float, optional (Target BPM, 0-300)<br> - energy: float, optional (Target energy level, 0-1)<br> - danceability: float, optional (Target danceability, 0-1)<br> - duration_ms: int, optional (Target duration in ms, 30000-900000)<br> - other audio features...<br> <b>x_api_key</b> : str (API key for authentication)<br>

Returns:

TrackIDList<br> List of matching track IDs<br>

Notes:

Finds tracks that best match the specified audio characteristics.

post/api/v1/recommendations/by-features

Headers

x-api-keystring

Request body

temponumber nullable
energynumber nullable
danceabilitynumber nullable
valencenumber nullable
instrumentalnessnumber nullable
acousticnessnumber nullable
duration_msinteger nullable

Target track duration in milliseconds (30s-15min)

genrestring nullable
limitinteger

Response

Successful Response

track_idsstring[] required