Get Recommendations By Features

Get track recommendations matching specific audio features.

Parameters:

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

Returns:

TrackIDList List of matching track IDs

Notes:

Finds tracks that best match the specified audio characteristics.

post/api/v1/recommendations/by-features

Request

Base URL
https://soundstat.info (the document declares no server; this is the origin it was published from)
Auth
none declared
TypeScript
https://skmtc.dev/soundstat/apis/soundstat-api/docs/api/v1/recommendations/by-features/post.ts
A function with typed inputs. Its response is checked against the schema.

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

Changes

No recorded changes to this operation across all 1 revision of this API.