get_user_top_items
Retrieve a user's top artists or tracks from Spotify based on time range (4 weeks, 6 months, or years) and item limit. Choose between short, medium, or long-term listening history.
Instructions
Get user's top artists or tracks.
Args:
item_type: "artists" or "tracks"
time_range: "short_term" (4 weeks), "medium_term" (6 months), "long_term" (years)
limit: Number of items to return (1-50, default 50)
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": "get_user_top_items"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | ||
| item_type | No | tracks | |
| time_range | No | medium_term | |
| access_token | No |