get_top_artists
Discover your most played Spotify artists over customizable time ranges to analyze your music preferences, create summaries, and share insights with actionable statistics.
Instructions
Analyze your personal listening habits to discover your most played artists over different time periods.
🎯 USE CASES: • Understanding your personal music taste evolution • Creating "Year in Music" summaries and statistics • Building playlists based on your actual listening habits • Sharing your music taste with friends and social media • Discovering patterns in your music preferences
📝 WHAT IT RETURNS: • Your most listened-to artists ranked by play time • Artist names, images, and genre breakdowns • Listening statistics and time-period comparisons • Popularity scores and follower information • Insights into your musical preferences
🔍 EXAMPLES: • "Who are my top artists this month?" • "Show my most played artists of all time" • "Get my top 10 artists from the last 6 months" • "What artists have I been listening to most recently?"
⏰ TIME RANGES:
• 'short_term' - Last 4 weeks of listening
• 'medium_term' - Last 6 months of listening
• 'long_term' - All-time listening history
• Compare across different periods for insights
⚠️ 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 |