get_user_top_artists
Retrieve your top artists on Spotify by time range (last 4 weeks, 6 months, or years). Optionally set limit and offset to control results. Returns artist name, popularity, followers, genres, and more.
Instructions
Get user's top artists from Spotify
Arguments:
time_range (str, optional): Time period for top artists (default: "medium_term")
- "short_term": Last 4 weeks
- "medium_term": Last 6 months
- "long_term": Several years
limit (int, optional): Maximum number of artists to return (default: 20, max: 50)
offset (int, optional): Index of the first artist to return (default: 0)
Returns: Dict[str, Any]: - success (bool): Whether the operation was successful - artists (List[Dict]): List of artist objects containing: - id (str): Spotify artist ID - name (str): Artist name - popularity (int): Artist popularity score (0-100) - followers (int): Number of followers - genres (List[str]): List of genres - spotify_url (str): Spotify profile URL - images (List[Dict]): Artist images with url, height, width - time_range (str): Time range used for the query - total_artists (int): Number of artists returned - message (str): Success message - error (str, optional): Error message if failed
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| time_range | No | medium_term | |
| limit | No | ||
| offset | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |