Panoramica dell'API e guida rapida

Aggiornato a luglio 2026.

Sì — LabelGrid offre un’API pubblica REST per la distribuzione programmatica. Permette agli sviluppatori di leggere il tuo catalogo, creare e aggiornare release, caricare asset e inviare le release alla distribuzione, e alimenta i servizi white-label costruiti su LabelGrid. Questa guida è l’introduzione rapida; il riferimento completo degli endpoint si trova su api.labelgrid.com/docs/api.

La guida rapida in breve

Passo	Cosa fai
1. Attivare un piano API	L’accesso all’API e alla sandbox richiede un piano API attivo e a pagamento (fatturato annualmente).
2. Generare un token API	Apri il menu dell’avatar (in alto a destra) e fai clic su API Tokens per creare un token Bearer.
3. (Facoltativo) Whitelist di IP	Limita l’uso del token a IP note nella stessa sezione API Tokens.
4. Leggere il riferimento	Esplora gli endpoint e gli strumenti “try it” su api.labelgrid.com/docs/api.
5. Sviluppare sulla sandbox	Richiedi una sandbox all’assistenza e testa senza toccare la produzione.
6. Passare alla produzione	Punta la tua integrazione a `api.labelgrid.com` e crea la tua prima release.

Cosa offre l’API

L’API pubblica è esposta sotto /api/public/... su api.labelgrid.com e dà accesso programmatico a:

Release — elencare, creare, aggiornare, eliminare; caricare l’artwork; validare; inviare alla distribuzione
Tracce — elencare, creare, aggiornare; caricare i file audio; gestire le licenze delle tracce
Etichette — elencare e gestire i profili delle tue etichette
Artisti — elencare e gestire i profili degli artisti
Autori e collaboratori — elencare e gestire i profili di autori e collaboratori
Editori — elencare e gestire i profili degli editori
Webhook — registrare gli endpoint webhook per le notifiche asincrone
Analytics — dati su stream, listener ed engagement per giorno, piattaforma, paese e traccia; vedi Filtri di ambito e dati per traccia e Piattaforme, disponibilità e limiti
Dati di riferimento — generi, lingue, ruoli dei collaboratori, strumenti, territori di distribuzione, outlet di distribuzione

Casi d’uso comuni

Automatizzare la creazione delle release a partire dai tuoi sistemi esistenti
Sincronizzare i dati del catalogo con il tuo database
Creare dashboard e strumenti di reportistica personalizzati
Integrare i tuoi strumenti di lavoro abituali
Alimentare servizi di distribuzione white-label costruiti su LabelGrid

Come ottenere l’accesso all’API

Per usare l’API di LabelGrid ti serve:

Un piano API attivo e a pagamento — l’accesso all’API e alla sandbox richiede un piano API a pagamento. La prova gratuita di 7 giorni inclusa nei piani standard non comprende l’accesso all’API o alla sandbox, e i piani API vengono fatturati subito (senza periodo di prova).
Un token API generato dalle impostazioni del tuo account: apri il menu dell’avatar in alto a destra e fai clic su API Tokens (visibile solo se l’accesso all’API è abilitato)
(Facoltativo) Whitelist di IP per maggiore sicurezza: si configura nella stessa sezione

Se non vedi l’opzione API Tokens nel tuo account, contatta l’assistenza per valutare l’attivazione dell’accesso all’API sul tuo piano.

Autenticazione

Tutte le richieste all’API devono includere un token Bearer nell’header Authorization:

Authorization: Bearer YOUR_API_TOKEN

Documentazione dell’API

Per il riferimento completo degli endpoint, gli schemi di richiesta/risposta e gli strumenti “try it” in tempo reale, consulta la documentazione generata automaticamente:

Produzione: https://api.labelgrid.com/docs/api
Sandbox: https://api-sandbox.stg.labelgrid.com/docs/api

La documentazione include:

Guida all’autenticazione
Ogni endpoint disponibile con esempi di richiesta e risposta
Informazioni sui limiti di frequenza (rate limiting)
Configurazione dei webhook

Sandbox

LabelGrid offre un ambiente sandbox in cui puoi sviluppare e fare test sull’API senza toccare il tuo catalogo di produzione. L’accesso alla sandbox richiede un piano API attivo e viene predisposto da noi su richiesta: una volta attivo il tuo piano API, contatta l’assistenza per configurarlo. La whitelist di IP per la sandbox la impostiamo noi; quella per la produzione la gestisci da solo in API Tokens.

Webhook

L’API pubblica supporta i webhook per la notifica asincrona degli eventi (cambi di stato della revisione, aggiornamenti delle consegne, ecc.). Per la configurazione e i tipi di evento disponibili, vedi Webhook.

Domande frequenti

«LabelGrid ha un’API pubblica?»

Sì — LabelGrid offre un’API pubblica REST per la distribuzione programmatica, esposta sotto /api/public/... su api.labelgrid.com. Puoi leggere il tuo catalogo, creare e aggiornare release, caricare audio e artwork, gestire artisti e collaboratori, registrare webhook e inviare le release alla distribuzione. La documentazione completa è su api.labelgrid.com/docs/api.

«Come ottengo l’accesso all’API?»

L’accesso all’API e alla sandbox richiede un piano API attivo e a pagamento. Una volta attivo il tuo piano API, genera un token API dalle impostazioni del tuo account in API Tokens (nel menu dell’avatar, in alto a destra). Se non vedi quell’opzione, contatta l’assistenza per abilitare l’accesso all’API. La prova gratuita di 7 giorni dei piani standard non include l’accesso all’API.

«Come autentico le richieste all’API?»

Includi un token Bearer nell’header Authorization di ogni richiesta: Authorization: Bearer YOUR_API_TOKEN. Genera il token in API Tokens nelle impostazioni del tuo account e, facoltativamente, limitalo tramite whitelist di IP.

«Esiste un ambiente sandbox per i test?»

Sì. LabelGrid offre una sandbox per sviluppare e testare sull’API senza toccare il tuo catalogo di produzione. L’accesso alla sandbox richiede un piano API attivo e viene predisposto su richiesta — contatta l’assistenza una volta attivo il tuo piano API. La documentazione della sandbox è su api-sandbox.stg.labelgrid.com/docs/api.

«Quanto costa l’API di LabelGrid?»

L’API è disponibile con i piani API di LabelGrid, fatturati annualmente. I piani partono dal livello Starter API, con livelli superiori per cataloghi più grandi e limiti di elaborazione delle royalty più alti. Consulta la pagina dei prezzi per i prezzi attuali e i dettagli di ogni livello.

Correlati

Stai costruendo qualcosa sull’API di LabelGrid? Dai un’occhiata all’hub per sviluppatori per una panoramica di cosa è possibile fare. Se alimenti un servizio di distribuzione white-label costruito su LabelGrid, la pagina infrastruttura per i distributori offre il quadro generale. Vedi anche la guida Configurazione della distribuzione white-label.

Hai bisogno di aiuto?

Se ti serve assistenza sull’API, contatta il nostro team di assistenza con i dettagli tecnici della tua integrazione.

Non usi ancora LabelGrid?

Tutto ciò che hai appena letto è disponibile sulla nostra piattaforma.

Scopri cosa può fare LabelGrid →