Guida

API delle riproduzioni di Spotify: riproduzioni totali di qualsiasi brano, per id o ISRC

La Web API di Spotify non dice mai quante volte è stato riprodotto un brano. Il dato più vicino è la popolarità, un punteggio da 0 a 100 che la sua stessa documentazione descrive come basato soprattutto sulle riproduzioni totali, e che segna come deprecato. Questi endpoint restituiscono il conteggio vero e proprio: un brano per id Spotify o ISRC, oppure fino a 50 brani in una sola chiamata.

Di Eduardo Airaudo, maintainer dell'API · Aggiornato il 22 ottobre 2026

Cosa lascia fuori l'oggetto brano ufficiale

GET /v1/tracks/{id} della Web API di Spotify restituisce l'album, gli artisti, duration_ms, explicit, external_ids, il nome, popularity e qualche altro campo. Nessuno di questi conta le riproduzioni. Il più vicino è la popolarità: la documentazione di Spotify la indica come un valore da 0 a 100, calcolato soprattutto in base a quante riproduzioni ha avuto un brano e a quanto sono recenti, e la segna come deprecata. Le modifiche di Spotify di febbraio 2026 l'hanno rimossa per le app in modalità sviluppo create dall'11 febbraio 2026.

Un punteggio non può fare ciò che fa un conteggio. È relativo, quindi non si somma su un album o su un catalogo, e favorisce le riproduzioni recenti — la stessa documentazione dice che i brani molto ascoltati adesso ottengono un punteggio più alto di quelli molto ascoltati in passato — quindi non può dire quante volte un brano è stato riprodotto in tutto.

Nelle parole della specifica, il gruppo Partner di questa API è “Spotify's internal (pathfinder) data, including play counts”. /partner/track/count restituisce il conteggio totale di un brano, /partner/tracks/count quello di un massimo di 50 brani in una volta, e /partner/track lo include nel record completo del brano.

Cosa restituisce

Campo per campo, come li definiscono gli schemi di risposta della specifica. La chiamata a un singolo brano chiama il conteggio streams; quella batch lo chiama playcount.

Un brano

GET /partner/track/count

streams
Le riproduzioni totali, come intero (int64). Nullable nella specifica, e 0 per un brano sotto le 1.000 riproduzioni.
spotify_track_id
L'id Spotify del brano.
isrc
L'ISRC del brano. Nullable nella specifica.
result
success o error, con un breve message accanto.

Un batch

GET /partner/tracks/count

tracks[]
Una voce per ogni id richiesto, nell'ordine della richiesta.
tracks[].playcount
Riproduzioni totali (int64, nullable); 0 per un brano sotto le 1.000.
tracks[].status
ok, not_found o error, con un testo error quando lo stato è error.
tracks[].name
Il nome del brano; null quando non è stato trovato.
tracks[].artists[]
id e name di ogni artista.
tracks[].releaseDate
La data di uscita dell'album del brano: YYYY-MM-DD, o una precisione più grossolana.
missing[]
Gli id richiesti il cui stato non è ok.

Uno 0 significa sotto 1.000, non mai riprodotto. La specifica dice che Spotify riporta 0 per i brani con meno di 1.000 riproduzioni, quindi salva uno 0 come “sotto 1.000” e non come un conteggio.

Campione registrato · acquisito il 2026-10-22

GET /partner/track/count

6 righe — l'intero corpo registrato.

Campione registrato · acquisito il 2026-10-22

GET /partner/tracks/count

18 righe — l'intero corpo registrato.

Un brano, o 50 per chiamata

  • GET /partner/track/countTrack play count

    Lifetime play count of one track, by Spotify id (spotify_track_id, or its alias id) or by isrc. Spotify reports 0 for tracks with fewer than 1,000 plays. Play counts are cached for 1 hour; for many tracks use /partner/tracks/count.

    Parametrispotify_track_id, id, isrc, cache

  • GET /partner/tracks/countTrack play counts (batch)

    Lifetime play counts for up to 50 tracks in one call. Entries come back in request order with status ok, not_found or error; ids without a play count are also listed in missing. Each id is cached for 1 hour.

    Parametriids, cache

  • GET /partner/trackPartner track data

    Track with its play count (data.trackUnion.playcount), album, artists and content ratings. Add slim=1 to keep only {id, uri, profile.name, visuals.avatarImage} of each artist (the full payload embeds the first artist's discography and is ~100 KB).

    Parametriid, slim, cache

/partner/tracks/count accetta fino a 50 id separati da virgole e risponde nell'ordine in cui li hai inviati, quindi 50 brani costano una richiesta anziché 50.

Ottieni le riproduzioni

Un brano, per id Spotify

L'id è la stringa di 22 caratteri dopo /track/ in qualsiasi URL di Spotify. Per cercare un brano tramite il suo ISRC, invia isrc= al posto di id=.

Fino a 50 brani in una sola chiamata

Leggi il campo status di ogni voce prima del suo conteggio. Le voci tornano nell'ordine degli id; una senza riproduzioni è contrassegnata not_found o error al suo posto, ed è elencata di nuovo in missing.

Riproduzioni senza codice

Se i conteggi servono per un foglio di calcolo e non per il tuo codice, due Actor Apify dello stesso maintainer li restituiscono come dataset. Per un'esecuzione serve un account Apify e nessuna chiave API: incolli i link e scarichi JSON o CSV.

Entrambi fatturano per risultato, ai prezzi indicati il : $0.001 a riga con il piano gratuito di Apify, fino a $0.0006 dal piano Gold in su. Quando un'esecuzione conviene più di una chiave, e quando no, è spiegato in la guida allo scraper.

Uno storico già raccolto: spotify-most-streamed-songs (opens in a new tab) on GitHub has daily play counts and daily streams for 1,000 of the most-streamed songs, as CSV and JSON history.

Usalo da un assistente AI (MCP): chiedi a Claude, Cursor o VS Code le riproduzioni di un brano, e lo strumento get_track_play_count del server MCP di Spotify restituisce le riproduzioni totali da questa API. Configura il server MCP.

Domande

La Web API di Spotify restituisce le riproduzioni?

No. L'oggetto brano nella documentazione della Web API non ha un campo con le riproduzioni. Il campo più vicino, la popolarità, è un punteggio da 0 a 100 che Spotify calcola soprattutto sulle riproduzioni totali e su quanto sono recenti; la documentazione lo segna come deprecato, e le modifiche di Spotify di febbraio 2026 l'hanno rimosso per le app in modalità sviluppo create dall'11 febbraio 2026.

Perché un brano mostra 0 riproduzioni?

Perché ne ha meno di 1.000. La specifica dice che Spotify riporta 0 per i brani con meno di 1.000 riproduzioni, quindi uno 0 significa sotto 1.000, non mai riprodotto.

Posso ottenere le riproduzioni di molti brani insieme?

Sì. GET /partner/tracks/count accetta fino a 50 id di brani separati da virgole e risponde nell'ordine della richiesta, ogni voce con uno stato ok, not_found o error; anche gli id senza riproduzioni sono elencati in missing. 50 brani costano una richiesta anziché 50.

Posso cercare un brano tramite ISRC?

Sì. GET /partner/track/count accetta isrc al posto di un id Spotify, quindi un catalogo indicizzato per ISRC non ha bisogno di una ricerca di id preliminare.

Quanto è aggiornato il numero?

Le riproduzioni restano in cache per un'ora, quindi di solito un conteggio ha al massimo quell'età. Un valore X-Cache che inizia con STALE o FALLBACK significa che è stata servita una copia più vecchia perché il recupero live era lento o è fallito; X-Cache-Stale-Age ne indica l'età in secondi. Aggiungi cache=false per recuperarne una fresca. I pulsanti Esegui di questo sito passano anche dalla cache della demo, quindi lì un dato può essere più vecchio.

Posso ottenere le riproduzioni senza scrivere codice?

Sì, su Apify: per un'esecuzione serve un account Apify e nessuna chiave API. Spotify Play Count Scraper (eduair94/spotify-play-count-scraper) accetta link di brani, album, artisti o playlist e restituisce una riga per brano con le sue riproduzioni; Spotify Scraper (eduair94/spotify-scraper) ha 5 categorie di riproduzioni tra le sue 61. Entrambi fatturano per risultato.

Di quale piano ho bisogno?

Di uno qualsiasi. Entrambi gli endpoint delle riproduzioni sono su ogni piano, sia RapidAPI sia portale diretto, e i piani differiscono per volume mensile. Ogni piano RapidAPI consente 5 richieste al secondo e ogni chiave diretta ne include 10. Il piano gratuito di RapidAPI consente 1000 richieste al mese.

Fonti

More guides

What changed in the API and on these pages, and when: What's new.

Ottieni una chiave e recupera le tue prime riproduzioni

Entrambi gli endpoint delle riproduzioni sono su ogni piano, sia RapidAPI sia portale diretto; su Apify, i due Actor qui sopra restituiscono gli stessi conteggi come righe di dataset, fatturate per risultato. Il piano gratuito di RapidAPI è di 1000 richieste al mese: con fino a 50 brani per chiamata, fino a 50.000 riproduzioni.

RapidAPI Apify Portale diretto

Vuoi provare prima di acquistare? Ottieni una chiave di prova gratuita: 500 richieste in 7 giorni, senza carta.