Stream Radar

O Stream Radar é um complemento pago opcional para contas de distribuição por API. Ele monitora o seu catálogo em busca de padrões de streaming compatíveis com streaming artificial e sinaliza as faixas que precisam de atenção, com antecedência suficiente para você agir antes que isso se transforme em uma taxa de DSP, uma remoção ou uma penalidade na sua conta.

Uma sinalização do Stream Radar é um sinal de alerta antecipado, não um veredito. A maior parte do streaming artificial tem origem em promoção de terceiros contratada de boa-fé — um impulsionamento de playlist ou um serviço de marketing que acabou inflando reproduções de forma artificial. Uma sinalização dá a você a chance de verificar o que está acontecendo e responder nos seus próprios termos, em vez de descobrir só quando uma plataforma age.

O Stream Radar disponibiliza as suas sinalizações pela API pública, para que você as leve para os seus próprios painéis, alertas e fluxos de análise.

O que é o Stream Radar

Com o Stream Radar ativado na sua conta, o LabelGrid observa o seu catálogo distribuído em busca de padrões de streaming compatíveis com streaming artificial. Quando uma faixa apresenta esse padrão em uma plataforma, o Stream Radar gera uma sinalização: um registro que você pode ler pela API e que indica qual faixa, em qual plataforma, precisa de um olhar.

Cada sinalização informa a faixa e a plataforma afetadas, uma gravidade para ajudar você a priorizar e uma estimativa de quantas reproduções estão envolvidas, para que você faça a triagem rápido e se aprofunde nas que importam.

O Stream Radar apenas revela informações para você agir. O que você faz com uma sinalização — verificar uma campanha, falar com o artista, pausar uma promoção — é decisão sua.

Como obter o Stream Radar

O Stream Radar é um complemento pago ativado por conta pela nossa equipe. Para ativá-lo, entre em contato com a nossa equipe de vendas e informe que deseja o Stream Radar.

Até que ele seja ativado, os endpoints do Stream Radar retornam:

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

com um status HTTP 403. Assim que o complemento está ativo, os mesmos endpoints passam a retornar as suas sinalizações.

Usar a API

O Stream Radar oferece dois endpoints de leitura, ambos com a mesma autenticação por token Bearer que o restante da API pública do LabelGrid. Para os esquemas completos e sempre atualizados de requisição e resposta, veja a referência da API.

Listar sinalizações

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

Retorna as sinalizações da sua conta, com a detecção mais recente primeiro. A resposta é paginada:

Parâmetro	O que faz
page	A página de resultados a retornar.
per_page	Resultados por página, até um máximo de 100.

Você pode restringir a lista com qualquer um destes filtros:

Filtro	Valores
filter[status]	active ou resolved.
filter[severity]	low, medium ou high.
filter[dsp]	Um identificador de plataforma (por exemplo, spotify).
filter[isrc]	Um ISRC, para ver as sinalizações de uma gravação.
filter[release_id]	Um ID de lançamento, para ver as sinalizações de um lançamento inteiro.
filter[detected_from]	Data inicial (YYYY-MM-DD), comparada com a data da última detecção de uma sinalização.
filter[detected_to]	Data final (YYYY-MM-DD), comparada com a data da última detecção de uma sinalização.

Por exemplo, para obter as sinalizações abertas de alta gravidade detectadas neste mês:

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

Obter uma sinalização

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

Retorna uma sinalização pelo seu id. Uma sinalização que pertence a outra conta retorna 404 — você só vê as suas próprias sinalizações.

Campos da sinalização

Cada sinalização traz:

Campo	O que ele indica
id	O identificador estável da sinalização.
dsp	A plataforma em que o padrão foi observado (por exemplo, spotify).
isrc	O ISRC da gravação envolvida.
release_id	O lançamento ao qual a gravação pertence.
track_id	A faixa específica, quando o ISRC corresponde de forma inequívoca a uma das suas faixas.
severity	low, medium ou high, para ajudar você a priorizar.
status	active enquanto o padrão está em andamento, resolved quando ele cessa.
first_detected_at	Quando o padrão foi observado pela primeira vez para esta faixa e plataforma.
last_detected_at	A detecção mais recente.
estimated_affected_streams	Uma estimativa de quantas reproduções estão envolvidas, para avaliar a escala.
published_at	Quando a sinalização foi gerada para você pela primeira vez.
resolved_at	Quando a sinalização foi resolvida, ou null enquanto ela ainda está ativa.

Como uma sinalização se comporta ao longo do tempo

O Stream Radar mantém uma sinalização por faixa por plataforma, de modo que o histórico de uma faixa em uma determinada plataforma fica em um único registro, em vez de se fragmentar em vários:

• Detecções repetidas estendem a mesma sinalização. Enquanto um padrão continua aparecendo, o seu last_detected_at avança e a sinalização permanece active — o id não muda.
• Uma sinalização é resolvida automaticamente quando as detecções cessam. Assim que o padrão deixa de ser observado, a sinalização passa para resolved e o seu resolved_at é preenchido. Você não precisa fechá-la por conta própria.
• Uma nova detecção reabre a mesma sinalização. Se o padrão retorna depois de uma sinalização ter sido resolvida, essa mesma sinalização (mesmo id) volta para active, em vez de uma nova ser criada.

Isso significa que você pode confiar no id de uma sinalização como uma referência durável para uma situação de faixa-e-plataforma ao longo de toda a sua vida.

Webhooks

Em vez de consultar as sinalizações periodicamente, você pode fazer o LabelGrid enviar uma notificação no instante em que uma delas muda. Assine da mesma forma que assina os outros eventos de webhook do LabelGrid, nas configurações de webhook no aplicativo ou pela API. O Stream Radar dispara dois eventos:

Evento	Quando dispara
stream_radar.flag_created	Uma sinalização é gerada pela primeira vez, ou uma sinalização resolvida é reaberta em uma nova detecção.
stream_radar.flag_resolved	Uma sinalização é resolvida porque as detecções cessaram.

Cada payload traz os mesmos campos da própria sinalização, com flag_id identificando a sinalização. O stream_radar.flag_created acrescenta um campo transition para você distinguir os dois casos:

transition	Significado
published	Uma sinalização totalmente nova foi gerada.
reopened	Uma sinalização existente, anteriormente resolvida, voltou a ficar ativa.

Nota

A entrega de webhooks é de melhor esforço. Trate os endpoints de listagem e de sinalização individual como a fonte da verdade e use os webhooks como um aviso para ir ler o estado atual — não como um registro garantido e completo de cada mudança.

Cobertura

Atualmente, o Stream Radar monitora o Spotify; uma sinalização do Spotify tem o dsp definido como spotify. A cobertura se expande de forma aditiva com o tempo — à medida que mais plataformas são adicionadas, elas aparecem como novos valores de dsp em novas sinalizações, e nada muda nas sinalizações que você já trata. Filtre por filter[dsp] se quiser restringir as suas ferramentas a uma plataforma específica.

O que fazer quando uma faixa é sinalizada

Uma sinalização é um convite a olhar, não uma conclusão. Quando uma chega:

• Verifique promoções recentes. Esta faixa foi impulsionada recentemente por um serviço de playlists, uma campanha de marketing ou um promotor? A promoção de terceiros é a fonte mais comum de streaming artificial e, muitas vezes, o vendedor — não você nem o artista — é a causa.
• Fale com o artista. Pergunte o que ele fez para promover a faixa. Nem sempre os artistas mencionam um serviço que pagaram, e podem não perceber que uma oferta de “reproduções garantidas” é um sinal de alerta.
• Pause as campanhas que você não consegue verificar. Se há uma promoção em andamento que você não consegue confirmar como legítima, pausá-la impede o padrão de crescer enquanto você investiga. Quando as detecções cessam, a sinalização é resolvida sozinha.

Agir cedo diante de uma sinalização é todo o propósito do Stream Radar: é muito melhor você mesmo detectar e desfazer uma promoção ruim do que ter uma plataforma aplicando primeiro uma taxa, uma remoção ou uma penalidade na conta.

---

Dúvidas sobre o Stream Radar? Entre em contato com a nossa equipe. Teremos prazer em ajudar.