API di Spotify
Cerca brani, artisti, album, playlist e podcast su Spotify per ottenere metadati pubblici, ascoltatori e metriche di streaming.
Usa un URL o un ID Spotify del tipo di contenuto corrispondente. Gli identificativi di brani, artisti, album e playlist non sono intercambiabili.
Invia POST https://api.everyinfra.com/api/v1/social con platform impostato su spotify e action impostato sul nome di una funzionalità dell'elenco qui sotto, ad esempio profile.
- 7 funzionalità
- $1.39 per 1.000 richieste
- Nessun addebito per chiamate non riuscite o risultati vuoti
Disponibilità della piattaforma
- Operatività nelle ultime 24 ore
- Normale
Ultimi 30 giorni
Funzionalità disponibili
Ogni azione di Spotify: cosa fa, quanto costa e come ha funzionato nelle ultime 24 ore. Apri un'azione per vederne parametri, campi della risposta ed esempi di codice.
| Funzionalità | Cosa fa | Per 1.000Righe vuote: $1.39 | Stato nelle ultime 24 ore · Tutto regolare |
|---|---|---|---|
Dettagliprofile | Cerca un album o un singolo su Spotify dal suo link completo. | Normale | |
Ricercasearch | Cerca su Spotify brani, artisti, album o playlist per parola chiave. | Normale | |
Dettagli dell'artistaartist | Leggi bio, generi, ascoltatori mensili, follower e posizione nella classifica mondiale di un artista Spotify, con brani più ascoltati, città principali e artisti correlati. | Normale | |
Branotrack | Ottieni artisti, album, durata, numero di riproduzioni, numero di traccia e di disco, data di uscita, etichetta e classificazione dei contenuti di un brano Spotify. | Normale | |
Albumalbum | Recupera tipo, artisti, data di uscita, etichetta, riga del copyright, copertina e tracklist completa di un album Spotify dal suo link, URI o ID. | Normale | |
Playlistplaylist | Apri una playlist Spotify per vederne proprietario, descrizione, salvataggi, follower, numero di brani e i brani che contiene. | Normale | |
Podcastpodcast | Trova podcast o singoli episodi su Spotify per parola chiave. | Normale |
Cosa accetta ogni azione di API di Spotify?
Ogni risposta qui sotto associa un'azione richiamabile ai suoi input reali. Il significato dei parametri e i valori ammessi dipendono dall'azione: un nome familiare non ha lo stesso significato su tutte le piattaforme.
Le fonti ufficiali sono linkate solo per chiarire il termine della piattaforma accanto a cui compaiono. Non implicano autorizzazione o approvazione da parte della piattaforma e le funzionalità del sito ufficiale non fanno parte dell'API di EveryInfra, a meno che questa pagina non le elenchi.
Consegna Sync per ogni azione.
| Azione | Obbligatori | Facoltativi | Limite | Per 1.000Righe vuote: $1.39 | Campi della risposta |
|---|---|---|---|---|---|
profileDettagli Cerca un album o un singolo su Spotify dal suo link completo. Ottieni tipo di uscita, data, etichetta discografica, artisti accreditati, copertina e tracklist. Questo punto di accesso meno recente legge le uscite, non i profili utente. Non riproduce audio. | url | — | — | id · url · name · type · release_date · label · artists · image_url · track_count · tracks · platform | |
searchRicerca Cerca su Spotify brani, artisti, album o playlist per parola chiave. Ottieni nome, tipo, artisti e link di ogni corrispondenza, più i conteggi adatti al tipo di risultato. Imposta il tipo con | keyword | content_type | Valori del catalogo: defaultLimit=20, maxLimit=100. Per alcune azioni limit può controllare le pagine o l'espansione per elemento padre, quindi non è sempre un numero finale di righe. | id · url · type · name · text · artists · album_name · owner_name · publisher · image_url · duration_ms · play_count · follower_count · monthly_listener_count · track_count · episode_count · release_date · is_explicit · preview_url · rank · platform | |
artistDettagli dell'artista Leggi bio, generi, ascoltatori mensili, follower e posizione nella classifica mondiale di un artista Spotify, con brani più ascoltati, città principali e artisti correlati. Passa un link all'artista, un URI spotify:artist: o il solo ID. I numeri sono una fotografia di un momento preciso, non dati sui ricavi né uno storico. | url | — | — | id · url · name · bio · monthly_listener_count · follower_count · world_rank · genres · image_url · header_image_url · album_count · single_count · compilation_count · top_cities · top_tracks · related_artists · platform | |
trackBrano Ottieni artisti, album, durata, numero di riproduzioni, numero di traccia e di disco, data di uscita, etichetta e classificazione dei contenuti di un brano Spotify. | url | — | — | id · url · name · artists · album_name · duration_ms · play_count · track_number · disc_number · is_explicit · release_date · preview_url · image_url · added_at · platform · album_id · album_type · label · content_rating | |
albumAlbum Recupera tipo, artisti, data di uscita, etichetta, riga del copyright, copertina e tracklist completa di un album Spotify dal suo link, URI o ID. Non viene riprodotto nulla, e non è garantito che le edizioni regionali dello stesso disco coincidano. | url | — | — | id · url · name · album_type · artists · release_date · label · copyright · track_count · image_url · tracks · platform | |
playlistPlaylist Apri una playlist Spotify per vederne proprietario, descrizione, salvataggi, follower, numero di brani e i brani che contiene. La playlist non viene modificata, i singoli follower non vengono nominati e non è garantito che i brani siano ancora disponibili. | url | — | — | id · url · name · text · owner_name · save_count · follower_count · track_count · image_url · tracks · platform | |
podcastPodcast Trova podcast o singoli episodi su Spotify per parola chiave. Ottieni editore, numero di episodi, durata e data di uscita, dove applicabili. Per gli episodi, imposta | keyword | content_type | Valori del catalogo: defaultLimit=20, maxLimit=100. Per alcune azioni limit può controllare le pagine o l'espansione per elemento padre, quindi non è sempre un numero finale di righe. | id · url · type · name · text · artists · album_name · owner_name · publisher · image_url · duration_ms · play_count · follower_count · monthly_listener_count · track_count · episode_count · release_date · is_explicit · preview_url · rank · platform |
Cosa significano i parametri profile di API di Spotify?
Cerca un album o un singolo su Spotify dal suo link completo. Ottieni tipo di uscita, data, etichetta discografica, artisti accreditati, copertina e tracklist. Questo punto di accesso meno recente legge le uscite, non i profili utente. Non riproduce audio.
Riferimento API completo: parametri, esempi di codice, esempio di risposta e statourlObbligatorio- Specifica il link open.spotify.com, l'URI spotify:type:ID o l'ID grezzo dell'entità corrispondente all'azione scelta (artist, track, album o playlist). I tipi di input devono corrispondere all'azione dell'endpoint e non sono intercambiabili. Gli endpoint profile legacy accettano link Spotify completi e restituiscono i metadati di streaming di album e singoli, non i dettagli dell'account utente.Spotify: URL delle risorse, URI e identificatori utente non sono intercambiabili — La documentazione ufficiale di Spotify distingue URL delle risorse, URI, ID e identificatori utente. L'azione legacy `profile` accetta solo URL completi della cronologia delle uscite; nonostante il nome simile, non funziona come endpoint ufficiale del profilo utente e non analizza automaticamente gli URI per le altre azioni. · Verificato
Cosa significano i parametri search di API di Spotify?
Cerca su Spotify brani, artisti, album o playlist per parola chiave. Ottieni nome, tipo, artisti e link di ogni corrispondenza, più i conteggi adatti al tipo di risultato. Imposta il tipo con content_type. I risultati possono variare tra regioni e non mostrano la popolarità nel tempo.
keywordObbligatorio- Specifica la query di ricerca per l'azione search, con le entità di destinazione limitate da content_type. Nell'azione podcast, questo parametro cerca per impostazione predefinita i programmi podcast nel loro complesso, non i dettagli di episodi specifici.
content_typeFacoltativo- Filtra i tipi di catalogo di destinazione. Per search, i valori consentiti sono tracks, artists, albums o playlists. L'azione podcast ha valori propri: podcasts_shows (predefinito) per i programmi o podcast_episodes_individual_episodes per i singoli episodi. I valori di un'azione non possono essere usati nell'altra.Valori ammessi:
albumsartistsplayliststracks
Cosa significano i parametri artist di API di Spotify?
Leggi bio, generi, ascoltatori mensili, follower e posizione nella classifica mondiale di un artista Spotify, con brani più ascoltati, città principali e artisti correlati. Passa un link all'artista, un URI spotify:artist: o il solo ID. I numeri sono una fotografia di un momento preciso, non dati sui ricavi né uno storico.
Riferimento API completo: parametri, esempi di codice, esempio di risposta e statourlObbligatorio- Specifica il link open.spotify.com, l'URI spotify:type:ID o l'ID grezzo dell'entità corrispondente all'azione scelta (artist, track, album o playlist). I tipi di input devono corrispondere all'azione dell'endpoint e non sono intercambiabili. Gli endpoint profile legacy accettano link Spotify completi e restituiscono i metadati di streaming di album e singoli, non i dettagli dell'account utente.Spotify: differenza tra ascoltatori mensili e ascoltatori mensili attivi — Spotify definisce gli ascoltatori mensili come gli ascoltatori unici degli ultimi 28 giorni, sia da ascolti attivi sia da consigli algoritmici. Gli ascoltatori mensili attivi rappresentano solo il sottoinsieme che ascolta attivamente. Il campo `monthly_listener_count` di questa pagina non va interpretato come questo sottoinsieme attivo, come numero di riproduzioni o come totale dei follower. · Verificato
Cosa significano i parametri track di API di Spotify?
Ottieni artisti, album, durata, numero di riproduzioni, numero di traccia e di disco, data di uscita, etichetta e classificazione dei contenuti di un brano Spotify. duration_ms è in millisecondi; la risposta non contiene file audio e non conferma i diritti territoriali.
urlObbligatorio- Specifica il link open.spotify.com, l'URI spotify:type:ID o l'ID grezzo dell'entità corrispondente all'azione scelta (artist, track, album o playlist). I tipi di input devono corrispondere all'azione dell'endpoint e non sono intercambiabili. Gli endpoint profile legacy accettano link Spotify completi e restituiscono i metadati di streaming di album e singoli, non i dettagli dell'account utente.Spotify: gli ID semplici non indicano il tipo di risorsa — La documentazione ufficiale precisa che un ID Spotify semplice, senza il contesto della chiamata, non dichiara esplicitamente il tipo di risorsa a cui si riferisce, mentre gli URI codificano il tipo. Chi effettua la chiamata deve far corrispondere l'azione scelta, il percorso dell'URL e il tipo di ID di destinazione, perché una stringa semplice non viene convertita automaticamente tra tipi di risorsa diversi. · VerificatoSpotify: brani, album di appartenenza e limiti d'uso dei contenuti — La documentazione ufficiale di Spotify sui brani separa gli oggetti `track` e `album` e descrive in dettaglio i vincoli su attribuzione dei contenuti, download e addestramento di modelli. Interrogare i metadati tramite questo endpoint non fornisce download completi dell'audio né autorizzazioni per l'addestramento di modelli AI; i campi ufficiali della piattaforma e i parametri `market` non fanno automaticamente parte di questo endpoint. · Verificato
Cosa significano i parametri album di API di Spotify?
Recupera tipo, artisti, data di uscita, etichetta, riga del copyright, copertina e tracklist completa di un album Spotify dal suo link, URI o ID. Non viene riprodotto nulla, e non è garantito che le edizioni regionali dello stesso disco coincidano.
Riferimento API completo: parametri, esempi di codice, esempio di risposta e statourlObbligatorio- Specifica il link open.spotify.com, l'URI spotify:type:ID o l'ID grezzo dell'entità corrispondente all'azione scelta (artist, track, album o playlist). I tipi di input devono corrispondere all'azione dell'endpoint e non sono intercambiabili. Gli endpoint profile legacy accettano link Spotify completi e restituiscono i metadati di streaming di album e singoli, non i dettagli dell'account utente.Spotify: gli ID semplici non indicano il tipo di risorsa — La documentazione ufficiale precisa che un ID Spotify semplice, senza il contesto della chiamata, non dichiara esplicitamente il tipo di risorsa a cui si riferisce, mentre gli URI codificano il tipo. Chi effettua la chiamata deve far corrispondere l'azione scelta, il percorso dell'URL e il tipo di ID di destinazione, perché una stringa semplice non viene convertita automaticamente tra tipi di risorsa diversi. · Verificato
Cosa significano i parametri playlist di API di Spotify?
Apri una playlist Spotify per vederne proprietario, descrizione, salvataggi, follower, numero di brani e i brani che contiene. La playlist non viene modificata, i singoli follower non vengono nominati e non è garantito che i brani siano ancora disponibili.
Riferimento API completo: parametri, esempi di codice, esempio di risposta e statourlObbligatorio- Specifica il link open.spotify.com, l'URI spotify:type:ID o l'ID grezzo dell'entità corrispondente all'azione scelta (artist, track, album o playlist). I tipi di input devono corrispondere all'azione dell'endpoint e non sono intercambiabili. Gli endpoint profile legacy accettano link Spotify completi e restituiscono i metadati di streaming di album e singoli, non i dettagli dell'account utente.Spotify: gli ID semplici non indicano il tipo di risorsa — La documentazione ufficiale precisa che un ID Spotify semplice, senza il contesto della chiamata, non dichiara esplicitamente il tipo di risorsa a cui si riferisce, mentre gli URI codificano il tipo. Chi effettua la chiamata deve far corrispondere l'azione scelta, il percorso dell'URL e il tipo di ID di destinazione, perché una stringa semplice non viene convertita automaticamente tra tipi di risorsa diversi. · Verificato
Cosa significano i parametri podcast di API di Spotify?
Trova podcast o singoli episodi su Spotify per parola chiave. Ottieni editore, numero di episodi, durata e data di uscita, dove applicabili. Per gli episodi, imposta content_type su podcast_episodes_individual_episodes. Il tipo di ogni riga distingue podcast ed episodi. Non viene scaricato alcun audio.
keywordObbligatorio- Specifica la query di ricerca per l'azione search, con le entità di destinazione limitate da content_type. Nell'azione podcast, questo parametro cerca per impostazione predefinita i programmi podcast nel loro complesso, non i dettagli di episodi specifici.
content_typeFacoltativo- Filtra i tipi di catalogo di destinazione. Per search, i valori consentiti sono tracks, artists, albums o playlists. L'azione podcast ha valori propri: podcasts_shows (predefinito) per i programmi o podcast_episodes_individual_episodes per i singoli episodi. I valori di un'azione non possono essere usati nell'altra.Valori ammessi:
podcast_episodes_individual_episodespodcasts_showsSpotify: differenza tra show podcast ed episodi — La documentazione ufficiale di Spotify organizza gli episodi sotto le pagine dei rispettivi show e distingue il seguire uno show dal salvare un episodio. Questo riferimento strutturale spiega solo la gerarchia delle risorse e non replica funzionalità dell'app Spotify come la riproduzione audio, i download offline o l'accesso con abbonamento a pagamento. · Verificato
Come usare l'API di Spotify
- 01Scegli un'azione della piattaforma dal catalogo pubblico.
- 02Invia piattaforma, azione e parametri obbligatori a POST /api/v1/social.
- 03Leggi il risultato dalla risposta. Per un'azione asincrona, interroga periodicamente il job ID restituito.
- 04Salva i campi della risposta che servono alla tua applicazione.
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"spotify","action":"profile","params":{"url":"<url>"}}'
Domande sull'API di Spotify
Cosa posso ottenere con l'API di Spotify?
Imposta platform su spotify. Il catalogo attuale elenca dettagli, ricerca, dettagli dell'artista, brano, album e more. Questi nomi di azione identificano oggetti o viste diversi di Spotify; non sono modalità di ricerca intercambiabili.
Spotify ha un'API ufficiale?
Sì. La Web API di Spotify fornisce metadati del catalogo e dati degli utenti che autorizzano la tua app. Le nuove app partono in Development Mode (il proprietario deve avere un account Premium, sono ammessi fino a cinque utenti ed è disponibile un insieme ridotto di endpoint), e l'accesso esteso viene concesso solo a organizzazioni registrate con un servizio già lanciato e almeno 250.000 utenti attivi mensili.
Fonti ufficiali: Spotify Web API: quota modes · «Spotify: update on developer access and platform security» · Verificato
Mi serve un account sviluppatore o una chiave API di Spotify?
No. Le richieste passano da EveryInfra con una chiave API EveryInfra: registrati, crea una chiave nella console e inviala come Authorization: Bearer <API_KEY>. Non devi registrare un'app nel portale per sviluppatori di Spotify, richiedere l'accesso alle API di Spotify né accedere con un account Spotify; le azioni restituiscono solo dati pubblici di Spotify.
Quanto costa l'API di Spotify per 1.000 richieste?
$1.39 per 1.000 richieste, a seconda dell'azione; il prezzo di ogni azione è indicato nella tabella di questa pagina e nel catalogo pubblico. Non c'è alcun abbonamento: ricarichi un saldo in USD e paghi per chiamata, e le chiamate non riuscite e i risultati vuoti non vengono addebitati.
Quale input avvia la richiesta profile di Spotify?
Specifica il link open.spotify.com, l'URI spotify:type:ID o l'ID grezzo dell'entità corrispondente all'azione scelta (artist, track, album o playlist). I tipi di input devono corrispondere all'azione dell'endpoint e non sono intercambiabili. Gli endpoint profile legacy accettano link Spotify completi e restituiscono i metadati di streaming di album e singoli, non i dettagli dell'account utente. Invialo come url all'interno di params.
Quali campi può restituire profile di Spotify?
Il suo schema dichiarato include name, type, release_date e label. Un campo dichiarato può comunque mancare in un singolo record, e ogni altra azione ha il proprio elenco di campi.
Tutte le azioni di Spotify rispondono subito?
Le azioni indicate come asincrone restituiscono un job ID da interrogare periodicamente. Tutte le altre azioni possono essere eseguite anche in modo asincrono: aggiungi "mode": "async" al corpo della richiesta per ricevere subito un job ID, utile per task lenti o limiti elevati. Il catalogo attuale contiene consegna sync.