Recommendations Engine
Generate personalized track recs from any combination of seeds
Build Your Seed Set
0 / 5 seedsOr pick a suggestion:
Spotify Recommendations API
The Spotify Recommendations API takes a small set of seeds — up to 5, in any combination of track IDs, artist IDs, and genres — and returns a tailored list of similar tracks. It's the same engine that powers Discover Weekly and Daily Mixes, exposed via /api/spotify/recommendations.
Tune the recommendations with audio-feature targets (target_energy, target_danceability, min_tempo, etc.) to dial mood and style. Add a market parameter to constrain results to a specific country, or omit for global mode.
Use Cases
Mood playlists
Generate playlists from a target mood (chill, energetic, focus) with audio-feature targets.
Dating apps
Match users by music taste — recommend tracks based on profile favorites.
Fitness apps
Build BPM-matched workout playlists by tempo and energy filters.
Sleep & focus apps
Recommend low-energy, instrumental tracks to wind down or concentrate.
Music discovery widgets
Embed 'more like this' recommendations on track or artist pages.
E-commerce music recs
Suggest tracks to play in retail apps based on genre and brand mood.
AI DJ apps
Power autonomous DJ engines that segue from one rec set to the next.
B2B in-store music
Curate background music programs for cafés, gyms, and retail chains by region.
FAQ
How does the recommendation engine work? ▼
Spotify analyzes audio features (tempo, energy, danceability, valence, instrumentalness, etc.) and listening graph signals to find tracks similar to your seeds.
Why is there a 5-seed limit? ▼
More seeds dilute the signal. Five lets you mix tracks/artists/genres without making the result too generic.
Can I tune mood with audio features? ▼
Yes. The full Spotify endpoint accepts target_/min_/max_ parameters for energy, danceability, valence, tempo, acousticness, instrumentalness, popularity, and more.
Do recommendations work without any seeds? ▼
No. You need at least one seed (track, artist, or genre). Otherwise the API has no anchor to base similarity on.
Is the result reproducible? ▼
Mostly. Spotify may rotate small portions over time so the same seeds occasionally produce slightly different sets — useful for daily-rotating playlists.
Can I cache results? ▼
Yes. Recommendations are stable enough to cache for hours. Just key the cache by sorted seeds + limit + market.
Add personalized recs to your app
Get unlimited Spotify Recommendations API access — no OAuth, no rate-limit headaches.