fix: Support new Spotify API response format (track -> item)#2628
Open
BillionClaw wants to merge 1 commit intospotDL:devfrom
Open
fix: Support new Spotify API response format (track -> item)#2628BillionClaw wants to merge 1 commit intospotDL:devfrom
BillionClaw wants to merge 1 commit intospotDL:devfrom
Conversation
Spotify updated their API in February 2026, changing the playlist items response structure from 'track' to 'item'. This fix ensures compatibility with both old and new API formats. Changes: - spotdl/types/playlist.py: Handle both 'track' and 'item' keys - spotdl/types/saved.py: Handle both 'track' and 'item' keys Fixes spotDL#2621
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Description
Spotify updated their Web API in February 2026 (changelog), changing the playlist items response structure from using a
trackkey to anitemkey.This PR updates spotDL to handle both the old and new API response formats for backward compatibility.
Changes
spotdl/types/playlist.py: Updated to handle bothtrackanditemkeys when extracting track metadata from playlist itemsspotdl/types/saved.py: Same update for saved tracksTesting
The fix has been tested to ensure it works with both:
{"track": {...}}{"item": {...}}Related Issue
Fixes #2621