Stream Radar

Stream Radar è un componente aggiuntivo a pagamento opzionale per gli account di distribuzione con API. Monitora il tuo catalogo alla ricerca di pattern di ascolto compatibili con lo streaming artificiale e segnala le tracce da tenere d’occhio, con un anticipo sufficiente per intervenire prima che la cosa si trasformi in una commissione di una DSP, in una rimozione o in una sanzione contro il tuo account.

Una segnalazione di Stream Radar è un segnale di allerta precoce, non un verdetto. La maggior parte dello streaming artificiale deriva da promozione di terze parti acquistata in buona fede: una spinta in playlist o un servizio di marketing che si è rivelato gonfiare artificialmente gli ascolti. Una segnalazione ti dà l’occasione di verificare cosa sta succedendo e di rispondere alle tue condizioni, invece di scoprirlo quando una piattaforma agisce.

Stream Radar espone le sue segnalazioni tramite l’API pubblica, così puoi integrarle nei tuoi dashboard, avvisi e flussi di revisione.

Cos’è Stream Radar

Con Stream Radar attivo sul tuo account, LabelGrid tiene d’occhio il tuo catalogo distribuito alla ricerca di pattern di ascolto compatibili con lo streaming artificiale. Quando una traccia mostra un pattern del genere su una piattaforma, Stream Radar crea una segnalazione: un record che puoi leggere tramite l’API e che ti indica quale traccia, su quale piattaforma, va esaminata.

Ogni segnalazione nomina la traccia e la piattaforma interessate, una gravità per aiutarti a dare priorità e una stima di quanti ascolti sono coinvolti, così puoi fare triage rapidamente e approfondire quelle che contano.

Stream Radar fa solo emergere informazioni su cui agire. Cosa fai di una segnalazione — verificare una campagna, parlare con l’artista, mettere in pausa una promozione — dipende da te.

Come ottenere Stream Radar

Stream Radar è un componente aggiuntivo a pagamento attivato per account dal nostro team. Per attivarlo, contatta il nostro team commerciale e comunica che desideri Stream Radar.

Finché non è attivo, gli endpoint di Stream Radar restituiscono:

{
  "error_code": "stream_radar_not_enabled",
  "message": "Stream Radar is not enabled for this account."
}

con uno stato HTTP 403. Una volta attivo il componente aggiuntivo, gli stessi endpoint iniziano a restituire le tue segnalazioni.

Usare l’API

Stream Radar offre due endpoint in lettura, entrambi con la stessa autenticazione tramite token Bearer del resto dell’API pubblica di LabelGrid. Per gli schemi completi e sempre aggiornati di richiesta e risposta, consulta il riferimento dell’API.

Elencare le segnalazioni

GET /v4/public/stream-radar/flags
Authorization: Bearer YOUR_API_TOKEN

Restituisce le segnalazioni del tuo account, con la rilevazione più recente per prima. La risposta è paginata:

Parametro	Cosa fa
page	La pagina di risultati da restituire.
per_page	Risultati per pagina, fino a un massimo di 100.

Puoi restringere l’elenco con uno qualsiasi di questi filtri:

Filtro	Valori
filter[status]	active o resolved.
filter[severity]	low, medium o high.
filter[dsp]	Un identificatore di piattaforma (per esempio, spotify).
filter[isrc]	Un ISRC, per vedere le segnalazioni di una registrazione.
filter[release_id]	Un ID release, per vedere le segnalazioni su tutta una release.
filter[detected_from]	Data di inizio (YYYY-MM-DD), confrontata con la data dell’ultima rilevazione di una segnalazione.
filter[detected_to]	Data di fine (YYYY-MM-DD), confrontata con la data dell’ultima rilevazione di una segnalazione.

Per esempio, per recuperare le segnalazioni aperte ad alta gravità rilevate questo mese:

GET /v4/public/stream-radar/flags?filter[status]=active&filter[severity]=high&filter[detected_from]=2026-07-01
Authorization: Bearer YOUR_API_TOKEN

Ottenere una segnalazione

GET /v4/public/stream-radar/flags/{id}
Authorization: Bearer YOUR_API_TOKEN

Restituisce una segnalazione tramite il suo id. Una segnalazione che appartiene a un altro account restituisce 404: vedi sempre e solo le tue segnalazioni.

Campi della segnalazione

Ogni segnalazione include:

Campo	Cosa ti dice
id	L’identificatore stabile della segnalazione.
dsp	La piattaforma su cui è stato osservato il pattern (per esempio, spotify).
isrc	L’ISRC della registrazione coinvolta.
release_id	La release a cui appartiene la registrazione.
track_id	La traccia specifica, quando l’ISRC corrisponde in modo inequivocabile a una delle tue tracce.
severity	low, medium o high, per aiutarti a dare priorità.
status	active mentre il pattern è in corso, resolved una volta che cessa.
first_detected_at	Quando il pattern è stato osservato per la prima volta per questa traccia e piattaforma.
last_detected_at	La rilevazione più recente.
estimated_affected_streams	Una stima di quanti ascolti sono coinvolti, per valutare l’entità.
published_at	Quando la segnalazione ti è stata comunicata per la prima volta.
resolved_at	Quando la segnalazione si è risolta, o null mentre è ancora attiva.

Come si comporta una segnalazione nel tempo

Stream Radar mantiene una segnalazione per traccia e per piattaforma, così la storia di una traccia su una data piattaforma resta in un unico record invece di frammentarsi in molti:

• Le rilevazioni ripetute prolungano la stessa segnalazione. Finché il pattern continua a comparire, il suo last_detected_at avanza e la segnalazione resta active: l’id non cambia.
• Una segnalazione si risolve automaticamente quando le rilevazioni cessano. Una volta che il pattern non viene più osservato, la segnalazione passa a resolved e viene impostato il suo resolved_at. Non devi chiuderla tu.
• Una nuova rilevazione riapre la stessa segnalazione. Se il pattern torna dopo che una segnalazione si è risolta, quella stessa segnalazione (stesso id) torna active invece di crearne una nuova.

Questo significa che puoi fidarti dell’id di una segnalazione come riferimento durevole per una situazione traccia-e-piattaforma per tutta la sua vita.

Webhook

Invece di interrogare periodicamente le segnalazioni, puoi far sì che LabelGrid ti invii una notifica nel momento in cui una segnalazione cambia. Iscriviti nello stesso modo in cui ti iscrivi agli altri eventi webhook di LabelGrid, dalle impostazioni dei webhook nell’app o tramite l’API. Stream Radar attiva due eventi:

Evento	Quando si attiva
stream_radar.flag_created	Una segnalazione viene creata per la prima volta, o una segnalazione risolta si riapre su una nuova rilevazione.
stream_radar.flag_resolved	Una segnalazione si risolve perché le rilevazioni sono cessate.

Ogni payload contiene gli stessi campi della segnalazione stessa, con flag_id che identifica la segnalazione. stream_radar.flag_created aggiunge un campo transition che ti permette di distinguere i due casi:

transition	Significato
published	È stata creata una segnalazione del tutto nuova.
reopened	Una segnalazione esistente, in precedenza risolta, è tornata attiva.

Nota

La consegna dei webhook è best-effort. Tratta gli endpoint di elenco e di singola segnalazione come la fonte di verità, e usa i webhook come stimolo per andare a leggere lo stato attuale, non come un registro garantito e completo di ogni cambiamento.

Copertura

Stream Radar attualmente monitora Spotify; una segnalazione da Spotify ha dsp impostato su spotify. La copertura si amplia in modo additivo nel tempo: man mano che vengono aggiunte più piattaforme, queste compaiono come nuovi valori di dsp su nuove segnalazioni, e nulla cambia riguardo alle segnalazioni che già gestisci. Filtra su filter[dsp] se vuoi restringere i tuoi strumenti a una piattaforma specifica.

Cosa fare quando una traccia viene segnalata

Una segnalazione è un invito a guardare, non una conclusione. Quando ne arriva una:

• Controlla la promozione recente. Questa traccia è stata spinta di recente tramite un servizio di playlist, una campagna di marketing o un promoter? La promozione di terze parti è la fonte più comune di streaming artificiale, e spesso la causa è il venditore, non tu né l’artista.
• Parla con l’artista. Chiedigli cosa ha fatto per promuovere la traccia. Gli artisti non menzionano sempre un servizio che hanno pagato, e potrebbero non rendersi conto che un’offerta di «ascolti garantiti» è un campanello d’allarme.
• Metti in pausa le campagne che non puoi verificare. Se è in corso una promozione che non puoi confermare come legittima, metterla in pausa impedisce al pattern di crescere mentre indaghi. Quando le rilevazioni cessano, la segnalazione si risolve da sola.

Agire per tempo su una segnalazione è tutto il senso di Stream Radar: è molto meglio individuare e disfare tu stesso una cattiva promozione che lasciare che una piattaforma applichi per prima una commissione, una rimozione o una sanzione al tuo account.

---

Domande su Stream Radar? Contatta il nostro team. Saremo felici di aiutarti.