GET /recommendations

spotify.com

Summary: Get Recommendations
Operation ID: get-recommendations
Auth: unknown
Description

Recommendations are generated based on the available information for a given seed entity and matched against similar artists and tracks. If there is sufficient information about the provided seeds, a list of tracks will be returned together with pool size details. For artists and tracks that are very new or obscure there might not be enough data to generate a list of tracks.

Parameters (47)

limit (integer, query, optional, default: 20)

Constraints: {'minimum': 1, 'maximum': 100}

market (string, query, optional)
max_acousticness (number, query, optional)

Constraints: {'minimum': 0, 'maximum': 1}

max_danceability (number, query, optional)

Constraints: {'minimum': 0, 'maximum': 1}

max_duration_ms (integer, query, optional)
max_energy (number, query, optional)

Constraints: {'minimum': 0, 'maximum': 1}

max_instrumentalness (number, query, optional)

Constraints: {'minimum': 0, 'maximum': 1}

max_key (integer, query, optional)

Constraints: {'minimum': 0, 'maximum': 11}

max_liveness (number, query, optional)

Constraints: {'minimum': 0, 'maximum': 1}

max_loudness (number, query, optional)
max_mode (integer, query, optional)

Constraints: {'minimum': 0, 'maximum': 1}

max_popularity (integer, query, optional)

Constraints: {'minimum': 0, 'maximum': 100}

max_speechiness (number, query, optional)

Constraints: {'minimum': 0, 'maximum': 1}

max_tempo (number, query, optional)
max_time_signature (integer, query, optional)
max_valence (number, query, optional)

Constraints: {'minimum': 0, 'maximum': 1}

min_acousticness (number, query, optional)

Constraints: {'minimum': 0, 'maximum': 1}

min_danceability (number, query, optional)

Constraints: {'minimum': 0, 'maximum': 1}

min_duration_ms (integer, query, optional)
min_energy (number, query, optional)

Constraints: {'minimum': 0, 'maximum': 1}

min_instrumentalness (number, query, optional)

Constraints: {'minimum': 0, 'maximum': 1}

min_key (integer, query, optional)

Constraints: {'minimum': 0, 'maximum': 11}

min_liveness (number, query, optional)

Constraints: {'minimum': 0, 'maximum': 1}

min_loudness (number, query, optional)
min_mode (integer, query, optional)

Constraints: {'minimum': 0, 'maximum': 1}

min_popularity (integer, query, optional)

Constraints: {'minimum': 0, 'maximum': 100}

min_speechiness (number, query, optional)

Constraints: {'minimum': 0, 'maximum': 1}

min_tempo (number, query, optional)
min_time_signature (integer, query, optional)

Constraints: {'maximum': 11}

min_valence (number, query, optional)

Constraints: {'minimum': 0, 'maximum': 1}

seed_artists (string, query, required)
seed_genres (string, query, required)
seed_tracks (string, query, required)
target_acousticness (number, query, optional)

Constraints: {'minimum': 0, 'maximum': 1}

target_danceability (number, query, optional)

Constraints: {'minimum': 0, 'maximum': 1}

target_duration_ms (integer, query, optional)
target_energy (number, query, optional)

Constraints: {'minimum': 0, 'maximum': 1}

target_instrumentalness (number, query, optional)

Constraints: {'minimum': 0, 'maximum': 1}

target_key (integer, query, optional)

Constraints: {'minimum': 0, 'maximum': 11}

target_liveness (number, query, optional)

Constraints: {'minimum': 0, 'maximum': 1}

target_loudness (number, query, optional)
target_mode (integer, query, optional)

Constraints: {'minimum': 0, 'maximum': 1}

target_popularity (integer, query, optional)

Constraints: {'minimum': 0, 'maximum': 100}

target_speechiness (number, query, optional)

Constraints: {'minimum': 0, 'maximum': 1}

target_tempo (number, query, optional)
target_time_signature (integer, query, optional)
target_valence (number, query, optional)

Constraints: {'minimum': 0, 'maximum': 1}

No probe data for this endpoint yet.