API di SoundCloud
Cerca brani, artisti e playlist su SoundCloud tramite parole chiave o URL per ottenere metadati audio, metriche e dettagli sulle licenze.
Recupera un singolo elemento tramite il suo URL. Gli altri URL vengono trattati come query di ricerca e i risultati possono variare.
Invia POST https://api.everyinfra.com/api/v1/social con platform impostato su soundcloud e action impostato sul nome di una funzionalità dell'elenco qui sotto, ad esempio search.
- 6 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 SoundCloud: 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 |
|---|---|---|---|
Ricercasearch | Cerca tracce SoundCloud per keyword, con artista, genere, tag, durata, riproduzioni, like, repost, download e la licenza di ogni traccia. | Normale | |
Ricerca utentisearch_users | Trova artisti e account SoundCloud per keyword. | Normale | |
Ricerca playlistsearch_playlists | Scopri playlist e album SoundCloud per una keyword, con genere, numero di tracce, durata totale, like, repost e nome e verifica del creator. | Normale | |
Branotrack | Leggi una traccia SoundCloud dal suo link. | Normale | |
Dettagli dell'artistaartist | Verifica un artista o un utente SoundCloud dal link del profilo. | Normale | |
Playlistplaylist | Apri una playlist o un album SoundCloud dal suo url /sets/ completo. | Normale |
Cosa accetta ogni azione di API di SoundCloud?
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 |
|---|---|---|---|---|---|
searchRicerca Cerca tracce SoundCloud per | keyword | — | 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 · title · text · genre · tags · duration_sec · duration_seconds · artist_name · artist_url · artist_avatar_url · artist_follower_count · artist_verified · play_count · like_count · comment_count · repost_count · download_count · artwork_url · license · posted_at · platform | |
search_usersRicerca utenti Trova artisti e account SoundCloud per | keyword | — | Valori del catalogo: defaultLimit=20, maxLimit=50. Per alcune azioni limit può controllare le pagine o l'espansione per elemento padre, quindi non è sempre un numero finale di righe. | id · username · name · url · bio · avatar_url · city · country · follower_count · following_count · track_count · playlist_count · like_count · is_verified · is_pro · created_at · platform | |
search_playlistsRicerca playlist Scopri playlist e album SoundCloud per una | keyword | — | Valori del catalogo: defaultLimit=20, maxLimit=50. Per alcune azioni limit può controllare le pagine o l'espansione per elemento padre, quindi non è sempre un numero finale di righe. | id · title · url · text · genre · track_count · duration_sec · duration_seconds · like_count · repost_count · is_album · artwork_url · artist_name · artist_url · artist_verified · posted_at · platform | |
trackBrano Leggi una traccia SoundCloud dal suo link. Ottieni genere, tag, durata in secondi, riproduzioni, like, repost, download, licenza e dettagli dell'artista. L'audio non viene scaricato. Non viene concessa alcuna licenza oltre a quella indicata dalla traccia, e la cronologia delle riproduzioni non viene conservata. | url | — | — | id · url · title · text · genre · tags · duration_sec · duration_seconds · artist_name · artist_url · artist_avatar_url · artist_follower_count · artist_verified · play_count · like_count · comment_count · repost_count · download_count · artwork_url · license · posted_at · platform | |
artistDettagli dell'artista Verifica un artista o un utente SoundCloud dal link del profilo. Ottieni bio, città e paese, follower, numero di tracce e playlist, stato verificato e Pro e data di creazione dell'account. L'identità non viene convalidata. Ascoltatori, guadagni e analytics private non sono esposti. | url | — | — | id · username · name · url · bio · avatar_url · city · country · follower_count · following_count · track_count · playlist_count · like_count · is_verified · is_pro · created_at · platform | |
playlistPlaylist Apri una playlist o un album SoundCloud dal suo | url | keyword, query | — | id · title · url · text · genre · track_count · duration_sec · duration_seconds · like_count · repost_count · is_album · artwork_url · artist_name · artist_url · artist_verified · posted_at · platform |
Cosa significano i parametri search di API di SoundCloud?
Cerca tracce SoundCloud per keyword, con artista, genere, tag, durata, riproduzioni, like, repost, download e la licenza di ogni traccia. La durata è in secondi, e conviene controllare il campo della licenza prima di qualsiasi riutilizzo o remix.
keywordObbligatorio- Specifica la stringa di query per trovare brani con search, artisti con search_users o set con search_playlists. Anche se è condiviso tra gli endpoint, ogni azione restituisce tipi di entità diversi. Nell'azione playlist, questo parametro serve da termine di ricerca di riserva solo quando manca un URL /sets/ completo, e non garantisce una corrispondenza esatta con la playlist.SoundCloud: brani, persone e playlist sono target di ricerca distinti — La documentazione ufficiale di ricerca di SoundCloud separa singoli brani audio, account utente e playlist, e gli account utente possono rappresentare band o ascoltatori. Per interrogare questi tipi di risorsa si usano azioni distinte. La presenza di filtri per data, durata o personalizzati nell'interfaccia web di SoundCloud non implica che questo endpoint supporti tali opzioni. · Verificato
Cosa significano i parametri search_users di API di SoundCloud?
Trova artisti e account SoundCloud per keyword. Ottieni bio, città, paese, follower, numero di tracce e playlist e flag verificato e Pro. Una corrispondenza nel nome non verifica l'identità né la disponibilità professionale.
keywordObbligatorio- Specifica la stringa di query per trovare brani con search, artisti con search_users o set con search_playlists. Anche se è condiviso tra gli endpoint, ogni azione restituisce tipi di entità diversi. Nell'azione playlist, questo parametro serve da termine di ricerca di riserva solo quando manca un URL /sets/ completo, e non garantisce una corrispondenza esatta con la playlist.SoundCloud: brani, persone e playlist sono target di ricerca distinti — La documentazione ufficiale di ricerca di SoundCloud separa singoli brani audio, account utente e playlist, e gli account utente possono rappresentare band o ascoltatori. Per interrogare questi tipi di risorsa si usano azioni distinte. La presenza di filtri per data, durata o personalizzati nell'interfaccia web di SoundCloud non implica che questo endpoint supporti tali opzioni. · Verificato
Cosa significano i parametri search_playlists di API di SoundCloud?
Scopri playlist e album SoundCloud per una keyword, con genere, numero di tracce, durata totale, like, repost e nome e verifica del creator. is_album riflette come viene presentato il set e non prova che si tratti di una pubblicazione ufficiale.
keywordObbligatorio- Specifica la stringa di query per trovare brani con search, artisti con search_users o set con search_playlists. Anche se è condiviso tra gli endpoint, ogni azione restituisce tipi di entità diversi. Nell'azione playlist, questo parametro serve da termine di ricerca di riserva solo quando manca un URL /sets/ completo, e non garantisce una corrispondenza esatta con la playlist.SoundCloud: limiti di proprietà di playlist, album e brani — La documentazione ufficiale di SoundCloud specifica che le playlist sono raccolte di brani propri o di terzi e possono essere formattate come album o set. Di conseguenza, chi crea una raccolta non è necessariamente l'autore di ogni brano che contiene. Questo endpoint restituisce riepiloghi delle raccolte e non replica le funzioni ufficiali di modifica delle playlist. · Verificato
Cosa significano i parametri track di API di SoundCloud?
Leggi una traccia SoundCloud dal suo link. Ottieni genere, tag, durata in secondi, riproduzioni, like, repost, download, licenza e dettagli dell'artista. L'audio non viene scaricato. Non viene concessa alcuna licenza oltre a quella indicata dalla traccia, e la cronologia delle riproduzioni non viene conservata.
Riferimento API completo: parametri, esempi di codice, esempio di risposta e statourlObbligatorio- Specifica il link alla risorsa SoundCloud di destinazione. Usa URL diretti dei brani per track, link ai profili degli artisti per artist (ridotti al percorso del creator) e URL /sets/ completi per playlist. I link che non sono di playlist passati all'azione playlist attivano una ricerca generica di riserva e potrebbero non restituire l'entità cercata.SoundCloud: differenza tra la licenza All Rights Reserved e le licenze Creative Commons — La documentazione ufficiale di SoundCloud sulle licenze distingue All Rights Reserved dalle varie licenze Creative Commons. Il campo `license` è un indicatore per verificare i diritti, non un'autorizzazione universale all'uso commerciale o al riutilizzo. Le autorizzazioni per gli utilizzi successivi vanno valutate in base alle condizioni della licenza corrispondente. · Verificato
Cosa significano i parametri artist di API di SoundCloud?
Verifica un artista o un utente SoundCloud dal link del profilo. Ottieni bio, città e paese, follower, numero di tracce e playlist, stato verificato e Pro e data di creazione dell'account. L'identità non viene convalidata. Ascoltatori, guadagni e analytics private non sono esposti.
Riferimento API completo: parametri, esempi di codice, esempio di risposta e statourlObbligatorio- Specifica il link alla risorsa SoundCloud di destinazione. Usa URL diretti dei brani per track, link ai profili degli artisti per artist (ridotti al percorso del creator) e URL /sets/ completi per playlist. I link che non sono di playlist passati all'azione playlist attivano una ricerca generica di riserva e potrebbero non restituire l'entità cercata.SoundCloud: i profili comprendono artisti, band e ascoltatori — La categoria Profiles/People di SoundCloud include musicisti, band, creator e normali ascoltatori. Il nome dell'azione `artist` è l'identificatore dell'azione nel gateway e non certifica che un profilo qualsiasi appartenga a un artista professionista. · Verificato
Cosa significano i parametri playlist di API di SoundCloud?
Apri una playlist o un album SoundCloud dal suo url /sets/ completo. Ottieni descrizione, genere, numero di tracce, durata totale, like e repost. Con altri link si passa a una ricerca su keyword o query, che potrebbe non trovare il set desiderato.
urlObbligatorio- Specifica il link alla risorsa SoundCloud di destinazione. Usa URL diretti dei brani per track, link ai profili degli artisti per artist (ridotti al percorso del creator) e URL /sets/ completi per playlist. I link che non sono di playlist passati all'azione playlist attivano una ricerca generica di riserva e potrebbero non restituire l'entità cercata.SoundCloud: differenza tra riepiloghi delle raccolte ed elenchi dettagliati dei brani — La documentazione ufficiale di SoundCloud descrive le playlist come raccolte di brani e spiega come impostarle come album o set. Questo riferimento definisce solo le relazioni tra oggetti; questo endpoint non restituisce array di dettaglio `tracks`, e i limiti di archiviazione delle playlist di SoundCloud non costituiscono garanzie sul numero di elementi restituiti da questo endpoint. · Verificato
keywordFacoltativo- Specifica la stringa di query per trovare brani con search, artisti con search_users o set con search_playlists. Anche se è condiviso tra gli endpoint, ogni azione restituisce tipi di entità diversi. Nell'azione playlist, questo parametro serve da termine di ricerca di riserva solo quando manca un URL /sets/ completo, e non garantisce una corrispondenza esatta con la playlist.
queryFacoltativo- Termine di ricerca di riserva secondario per l'azione playlist, con priorità inferiore a keyword. Fornire questo parametro non elimina l'obbligo di passare url.
Come usare l'API di SoundCloud
- 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":"soundcloud","action":"search","params":{"keyword":"<keyword>"}}'
Domande sull'API di SoundCloud
Cosa posso ottenere con l'API di SoundCloud?
Imposta platform su soundcloud. Il catalogo attuale elenca ricerca, ricerca utenti, ricerca playlist, brano, dettagli dell'artista e more. Questi nomi di azione identificano oggetti o viste diversi di SoundCloud; non sono modalità di ricerca intercambiabili.
Quale input avvia la richiesta search di SoundCloud?
Specifica la stringa di query per trovare brani con search, artisti con search_users o set con search_playlists. Anche se è condiviso tra gli endpoint, ogni azione restituisce tipi di entità diversi. Nell'azione playlist, questo parametro serve da termine di ricerca di riserva solo quando manca un URL /sets/ completo, e non garantisce una corrispondenza esatta con la playlist. Invialo come keyword all'interno di params.
Quali campi può restituire search di SoundCloud?
Il suo schema dichiarato include title, text, genre e tags. Un campo dichiarato può comunque mancare in un singolo record, e ogni altra azione ha il proprio elenco di campi.
Tutte le azioni di SoundCloud 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.