top_local
Rank artists, tracks, or albums by play count or total listening time within a date range. Use local listening history to see personal favorites, not live popularity.
Instructions
Ranked artists, tracks, or albums by play count or total listening time, optionally within a date range. This is YOUR local listening history, not a live popularity signal — Spotify removed those endpoints in 2026.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "top_local"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| end | No | ||
| limit | No | ||
| start | No | ||
| entity | No | artist | |
| metric | No | plays |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| rows | Yes | ||
| entity | Yes | ||
| metric | Yes |