get_top_tracks
Retrieve your most played Spotify tracks by play count for any time period, from all-time favorites to specific date ranges, with full track details and listening statistics.
Instructions
Get your most played tracks for any time period.
Returns your top tracks ranked by play count, with full track details and play statistics. This queries your complete listening history (not limited to Spotify's 50 recent tracks).
Time period options:
Omit dates for all-time top tracks
Specify start_date only for "since X" queries
Specify both dates for a specific range
Example queries:
"What are my top 10 songs?"
"What were my most played tracks in summer 2024?"
"Show me my top 20 songs from last month"
"What are my all-time top tracks?"
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| start_date | No | Start date in YYYY-MM-DD format. If omitted, includes all history. | |
| end_date | No | End date in YYYY-MM-DD format. If omitted, includes up to today. | |
| limit | No | Number of tracks to return (1-30). Default is 10. | |
| output_format | No | Output format: "toon" (default, 40-60% token savings) or "json" | toon |