Stream Radar

Stream Radar es un complemento de pago opcional para cuentas de distribución con API. Monitoriza su catálogo en busca de patrones de reproducción compatibles con el streaming artificial y marca las pistas que requieren atención, con la antelación suficiente para que actúe antes de que se convierta en una comisión de una DSP, una retirada o una sanción contra su cuenta.

Un aviso de Stream Radar es una señal de alerta temprana, no un veredicto. La mayor parte del streaming artificial se debe a promoción de terceros contratada de buena fe: un empuje de playlist o un servicio de marketing que resultó inflar las reproducciones de forma artificial. Un aviso le da la oportunidad de comprobar qué está pasando y responder en sus propios términos, en lugar de enterarse cuando una plataforma actúa.

Stream Radar expone sus avisos a través de la API pública para que pueda integrarlos en sus propios paneles, alertas y flujos de revisión.

Qué es Stream Radar

Con Stream Radar activado en su cuenta, LabelGrid vigila su catálogo distribuido en busca de patrones de reproducción compatibles con el streaming artificial. Cuando una pista muestra ese patrón en una plataforma, Stream Radar genera un aviso: un registro que puede leer a través de la API y que le indica qué pista, en qué plataforma, necesita una revisión.

Cada aviso identifica la pista y la plataforma afectadas, una gravedad para ayudarle a priorizar y una estimación de cuántas reproducciones están implicadas, para que pueda triar con rapidez y profundizar en las que importan.

Stream Radar solo hace aflorar información para que actúe sobre ella. Lo que haga con un aviso —comprobar una campaña, hablar con el artista, pausar una promoción— depende de usted.

Cómo obtener Stream Radar

Stream Radar es un complemento de pago que nuestro equipo activa por cuenta. Para activarlo, póngase en contacto con nuestro equipo de ventas e indíquele que desea Stream Radar.

Hasta que esté activado, los endpoints de Stream Radar devuelven:

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

con un estado HTTP 403. Una vez que el complemento está activo, los mismos endpoints empiezan a devolver sus avisos.

Usar la API

Stream Radar proporciona dos endpoints de lectura, ambos con la misma autenticación por token Bearer que el resto de la API pública de LabelGrid. Para conocer los esquemas de solicitud y respuesta completos y siempre actualizados, consulte la referencia de la API.

Listar avisos

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

Devuelve los avisos de su cuenta, con la detección más reciente primero. La respuesta está paginada:

Parámetro	Qué hace
page	La página de resultados que se devuelve.
per_page	Resultados por página, hasta un máximo de 100.

Puede acotar la lista con cualquiera de estos filtros:

Filtro	Valores
filter[status]	active o resolved.
filter[severity]	low, medium o high.
filter[dsp]	Un identificador de plataforma (por ejemplo, spotify).
filter[isrc]	Un ISRC, para ver los avisos de una grabación.
filter[release_id]	Un ID de lanzamiento, para ver los avisos de todo un lanzamiento.
filter[detected_from]	Fecha de inicio (YYYY-MM-DD), comparada con la fecha de la última detección de un aviso.
filter[detected_to]	Fecha de fin (YYYY-MM-DD), comparada con la fecha de la última detección de un aviso.

Por ejemplo, para obtener los avisos abiertos de gravedad alta detectados este mes:

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

Obtener un aviso

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

Devuelve un aviso por su id. Un aviso que pertenece a otra cuenta devuelve 404: solo ve sus propios avisos.

Campos del aviso

Cada aviso incluye:

Campo	Qué le indica
id	El identificador estable del aviso.
dsp	La plataforma en la que se observó el patrón (por ejemplo, spotify).
isrc	El ISRC de la grabación implicada.
release_id	El lanzamiento al que pertenece la grabación.
track_id	La pista concreta, cuando el ISRC corresponde de forma inequívoca a una de sus pistas.
severity	low, medium o high, para ayudarle a priorizar.
status	active mientras el patrón continúa, resolved una vez que cesa.
first_detected_at	Cuándo se detectó por primera vez el patrón para esta pista y plataforma.
last_detected_at	La detección más reciente.
estimated_affected_streams	Una estimación de cuántas reproducciones están implicadas, para calibrar la magnitud.
published_at	Cuándo se le comunicó el aviso por primera vez.
resolved_at	Cuándo se resolvió el aviso, o null mientras sigue activo.

Cómo se comporta un aviso con el tiempo

Stream Radar mantiene un aviso por pista y por plataforma, de modo que el historial de una pista en una plataforma determinada permanece en un único registro en lugar de fragmentarse en muchos:

• Las detecciones repetidas prolongan el mismo aviso. Mientras el patrón sigue apareciendo, su last_detected_at avanza y el aviso permanece active: el id no cambia.
• Un aviso se resuelve automáticamente cuando cesan las detecciones. Una vez que el patrón deja de observarse, el aviso pasa a resolved y se establece su resolved_at. No necesita cerrarlo usted.
• Una nueva detección reabre el mismo aviso. Si el patrón vuelve después de que un aviso se resolviera, ese mismo aviso (con el mismo id) vuelve a active en lugar de crearse uno nuevo.

Esto significa que puede confiar en el id de un aviso como identificador duradero de una situación de pista-y-plataforma durante toda su vida.

Webhooks

En lugar de sondear en busca de avisos, puede hacer que LabelGrid le envíe una notificación en cuanto uno cambie. Suscríbase igual que se suscribe a los demás eventos de webhook de LabelGrid, desde la configuración de webhooks en la aplicación o a través de la API. Stream Radar dispara dos eventos:

Evento	Cuándo se dispara
stream_radar.flag_created	Se genera un aviso por primera vez, o un aviso resuelto se reabre tras una nueva detección.
stream_radar.flag_resolved	Un aviso se resuelve porque cesaron las detecciones.

Cada carga útil incluye los mismos campos que el propio aviso, con flag_id identificando el aviso. stream_radar.flag_created añade un campo transition para que pueda distinguir los dos casos:

transition	Significado
published	Se generó un aviso completamente nuevo.
reopened	Un aviso existente, previamente resuelto, volvió a estar activo.

Nota

La entrega de webhooks es de mejor esfuerzo. Trate los endpoints de lista y de aviso individual como la fuente de la verdad, y use los webhooks como un aviso para ir a leer el estado actual, no como un registro garantizado y completo de cada cambio.

Cobertura

Stream Radar monitoriza actualmente Spotify; un aviso de Spotify tiene dsp con el valor spotify. La cobertura se amplía de forma aditiva con el tiempo: a medida que se añaden más plataformas, aparecen como nuevos valores de dsp en avisos nuevos, y nada de lo relativo a los avisos que ya gestiona cambia. Filtre por filter[dsp] si quiere acotar sus herramientas a una plataforma concreta.

Qué hacer cuando se marca una pista

Un aviso es una invitación a mirar, no una conclusión. Cuando llegue uno:

• Compruebe la promoción reciente. ¿Se ha impulsado esta pista a través de un servicio de playlists, una campaña de marketing o un promotor hace poco? La promoción de terceros es la fuente más habitual de streaming artificial, y a menudo la causa es el vendedor, no usted ni el artista.
• Hable con el artista. Pregúntele qué ha hecho para promocionar la pista. Los artistas no siempre mencionan un servicio que han pagado, y puede que no se den cuenta de que una oferta de «reproducciones garantizadas» es una señal de alarma.
• Pause las campañas que no pueda verificar. Si hay una promoción en marcha que no puede confirmar como legítima, pausarla evita que el patrón crezca mientras lo investiga. Cuando cesan las detecciones, el aviso se resuelve por sí solo.

Actuar pronto ante un aviso es todo el sentido de Stream Radar: es mucho mejor detectar y deshacer usted mismo una mala promoción que dejar que una plataforma aplique primero una comisión, una retirada o una sanción a su cuenta.

---

¿Preguntas sobre Stream Radar? Póngase en contacto con nuestro equipo. Estaremos encantados de ayudar.