get_top_tracks
Retrieve your most played Spotify tracks across different time periods to analyze listening patterns, create personalized playlists, and share music preferences. Works with short, medium, and long-term listening history.
Instructions
Discover your most listened-to tracks based on actual listening history across different time periods.
šÆ USE CASES: ⢠Understand your personal music listening patterns ⢠Create "Year in Music" summaries and personal statistics ⢠Build playlists based on your actual favorite songs ⢠Share your top music with friends and social media ⢠Track changes in musical preferences over time
š WHAT IT RETURNS: ⢠Your most played tracks ranked by listening frequency ⢠Track information with play count estimates ⢠Time-period specific listening statistics ⢠Artist and album information for top tracks ⢠Insights into your musical preferences and habits
š EXAMPLES: ⢠"What are my top tracks this month?" ⢠"Show my most listened songs of all time" ⢠"Get my top 20 tracks from the last 6 months" ⢠"What songs have I been playing on repeat recently?"
ⰠTIME PERIODS: ⢠'short_term' - Last 4 weeks of listening history ⢠'medium_term' - Last 6 months of musical activity ⢠'long_term' - All-time listening patterns and favorites ⢠Compare across periods to see taste evolution
š LISTENING INSIGHTS: ⢠Discover patterns in your music consumption ⢠Identify your most-loved songs across different eras ⢠Perfect for building "best of" personal playlists ⢠Great for music discovery based on your actual preferences ⢠Useful for understanding your musical identity
š” PERSONAL ANALYTICS: ⢠Track how your taste evolves over time ⢠Identify seasonal listening patterns ⢠Use for building recommendation systems ⢠Share musical identity with others ⢠Create data-driven personal playlists
ā ļø REQUIREMENTS: ⢠Valid Spotify access token with user-top-read scope ⢠Sufficient listening history for accurate results
Input Schema
Name | Required | Description | Default |
---|---|---|---|
limit | No | ||
timeRange | No | medium_term | |
token | Yes | Spotify access token for authentication |