La Spotify Web API è l’interfaccia con cui un’applicazione esterna legge i dati del catalogo di Spotify, come artisti, album, brani, playlist, podcast ed episodi, e, con il permesso di un utente, agisce sul suo account, per esempio salvando un brano in libreria. Restituisce dati in JSON e si usa registrando un’applicazione su Spotify for Developers, che fornisce un Client ID e un Client Secret.
Due modi di autorizzarsi
Per leggere i dati pubblici del catalogo basta il flusso client credentials: l’applicazione si identifica con le proprie credenziali e riceve un token temporaneo. Per agire per conto di un utente, come nel pre-save, serve il consenso dell’utente con OAuth 2.0: l’utente accede a Spotify, vede quali permessi l’applicazione chiede e li concede. Le credenziali dell’applicazione sono un segreto: non vanno mai scritte nel codice delle pagine né esportate insieme alle impostazioni di un sito.
Limiti e cambiamenti
L’API ha limiti di richieste per finestra di tempo, oltre i quali risponde 429, e regole d’uso stabilite dai termini per sviluppatori. Le condizioni cambiano: il 27 novembre 2024 Spotify ha tolto alle nuove applicazioni l’accesso a diverse funzioni, fra cui le raccomandazioni, gli artisti correlati, le caratteristiche e l’analisi audio dei brani, le playlist editoriali e algoritmiche di Spotify e le anteprime di trenta secondi. Un plugin costruito su una funzione dell’API deve quindi gestire con eleganza la sua scomparsa, invece di rompere la pagina.
Nei plugin ThinkClouds
Diversi plugin usano l’API, ciascuno con le credenziali inserite nelle proprie impostazioni. MusicLink Pro recupera con un clic la copertina di una release partendo dal link del brano o dell’album, e la salva in locale per le anteprime social. Artist Name Checker confronta un nome d’arte con gli artisti presenti su Spotify, oltre che su MusicBrainz e Discogs; senza credenziali può comunque offrire risultati Spotify ricavati dai dati pubblici di MusicBrainz, senza scraping. Spotify Podcast Episodes recupera gli episodi di uno show e li tiene aggiornati in automatico. Nelle migrazioni tra siti il manifesto di Artist Name Checker esclude le credenziali di Spotify e Discogs.