Get Contrast Recommendations

Get tracks with characteristics contrasting to a reference track.

Parameters:

params : ContrastParams - track_id: str (Reference track ID) - contrast_features: List[str], default=["energy", "valence"] (Features to contrast) - limit: int, default=20 (Number of recommendations) x_api_key : str (API key for authentication)

Returns:

TrackIDList List of tracks with contrasting characteristics

Notes:

Creates variety in playlists by finding tracks with opposite characteristics.

post/api/v1/recommendations/contrast

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/contrast/post.ts
A function with typed inputs. Its response is checked against the schema.

Headers

x-api-keystring

Request body

track_idstring required

Reference track ID

contrast_featuresstring[]

Features to contrast

limitinteger

Number of recommendations

Response

Successful Response

track_idsstring[] required

Changes

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