latestOpenAPI 3.1.02026-08-10202033.2 KB

d8deec5eca44

Get Contrast Recommendations

Get tracks with characteristics contrasting to a reference track.

Parameters:

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

Returns:

TrackIDList<br> List of tracks with contrasting characteristics<br>

Notes:

Creates variety in playlists by finding tracks with opposite characteristics.

post/api/v1/recommendations/contrast

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