feat: implement Spotify Web API February 2026 breaking changes

[janvrska]

Implements all breaking changes from the Spotify Web API February 2026 update.

Removed Fields

Struct	Removed Fields
SimpleAlbum	AlbumGroup, AvailableMarkets
FullAlbum	Popularity, ExternalIDs
FullArtist	Popularity, Followers
SimpleTrack	AvailableMarkets, ExternalIDs
FullTrack	Popularity, LinkedFrom
User	Followers
PrivateUser	Country, Email, Product
SimpleShow	AvailableMarkets, Publisher

Removed types: TrackExternalIDs, LinkedFromInfo, Category, CategoryPage.

Removed Endpoints

• Batch gets: GetAlbums, GetArtists, GetTracks
• Follow/Unfollow: FollowUser, FollowArtist, UnfollowUser, UnfollowArtist, CurrentUserFollows, FollowPlaylist, UnfollowPlaylist, UserFollowsPlaylist
• Browse: GetCategory, GetCategories, GetCategoryPlaylists, NewReleases
• Other: GetUsersPublicProfile, GetPlaylistsForUser, GetPlaylistTracks, GetArtistsTopTracks, SaveShowsForCurrentUser
• Old library methods: UserHasTracks, UserHasAlbums, AddTracksToLibrary, RemoveTracksFromLibrary, AddAlbumsToLibrary, RemoveAlbumsFromLibrary

Renamed: tracks → items

• PlaylistTracks → PlaylistItems
• SimplePlaylist.Tracks → SimplePlaylist.Items
• FullPlaylist.Tracks → FullPlaylist.Items
• PlaylistItem.Track → PlaylistItem.Item (JSON: "item")
• PlaylistTrackPage.Tracks → PlaylistTrackPage.Items
• All playlist endpoint URLs: /playlists/{id}/tracks → /playlists/{id}/items
• Request body key "tracks" → "items" in remove operations

New Endpoints

• CreatePlaylist(ctx, name, description, public, collaborative) — replaces CreatePlaylistForUser, uses POST /me/playlists
• SaveToLibrary(ctx, uris ...URI) — PUT /me/library (generic, URI-based)
• RemoveFromLibrary(ctx, uris ...URI) — DELETE /me/library
• UserHasSavedItems(ctx, uris ...URI) — GET /me/library/contains

Other Changes

• Search: updated limit docs (max 10, default 5)
• Deleted category.go and category_test.go
• Updated all tests and test data JSON to match the new API shape
• All tests pass

[Copilot]

Copilot encountered an error and was unable to review this pull request. You can try again by re-requesting a review.

[jdcukier]

Much more thorough fix than my branch. Thanks for doing this 👍

[jetzlstorfer]

Thanks for providing this. Looking forward to having this merged and ready to use :)

[fira42073]

Sorry for "any updates" kind of message, but I'm not quite sure whether this repo is maintained. Is it? If not, are there any alternatives? Is forking the way to go?

[jdcukier]

For anyone interested in a short term solution, I forked the repo with @janvrska's fixes here:

https://github.com/jdcukier/spotify

I don't plan on maintaining it long term though

[jetzlstorfer]

From the official communication from Spotify sent out on March 9:

After some review and feedback we’ve received from the community, we have decided to postpone the following changes for existing Development Mode integrations until further notice:
Restricting API access to a reduced set of supported endpoints
The following updates will still take effect on March 9 for existing Development Mode integrations:
Limiting each Client ID to five authorized users
Development Mode use will require a Spotify Premium account
Developers will be limited to one Development Mode Client ID
We will share further details as we continue reviewing the implementation of these changes.

As a reminder, these updates do not affect applications operating in Extended Quota Mode. Newly created Development Mode Client IDs remain subject to the updated rules introduced on February 11.