Stream Radar

Stream Radar is een optionele betaalde uitbreiding voor API-distributieaccounts. Het bewaakt je catalogus op streampatronen die duiden op kunstmatige streams en markeert tracks die aandacht nodig hebben — vroeg genoeg om in te grijpen voordat het uitmondt in een DSP-heffing, een takedown of een strike tegen je account.

Een Stream Radar-flag is een vroegtijdig waarschuwingssignaal, geen oordeel. De meeste kunstmatige streams zijn terug te voeren op promotie van derden die te goeder trouw is ingekocht — een playlistpush of een marketingdienst die de plays achteraf kunstmatig bleek op te blazen. Een flag geeft je de kans om te controleren wat er speelt en op je eigen voorwaarden te reageren, in plaats van erachter te komen wanneer een platform ingrijpt.

Stream Radar stelt zijn flags beschikbaar via de publieke API, zodat je ze in je eigen dashboards, alerting en reviewworkflows kunt binnenhalen.

Wat Stream Radar is

Met Stream Radar ingeschakeld op je account bewaakt LabelGrid je gedistribueerde catalogus op streampatronen die duiden op kunstmatige streams. Wanneer een track zo’n patroon vertoont op een platform, plaatst Stream Radar een flag: een record dat je via de API kunt uitlezen en dat je vertelt welke track, op welk platform, een blik nodig heeft.

Elke flag noemt de betrokken track en het platform, een ernst om je te helpen prioriteren, en een schatting van hoeveel streams erbij betrokken zijn, zodat je snel kunt triëren en kunt inzoomen op de flags die ertoe doen.

Stream Radar brengt alleen informatie naar boven waarop jij kunt handelen. Wat je met een flag doet — een campagne controleren, met de artiest praten, een promotie pauzeren — bepaal je zelf.

Hoe je Stream Radar krijgt

Stream Radar is een betaalde uitbreiding die ons team per account inschakelt. Om het aan te zetten, neem je contact op met ons salesteam en laat je weten dat je Stream Radar wilt.

Totdat het is ingeschakeld, geven de Stream Radar-endpoints het volgende terug:

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

met een HTTP-403-status. Zodra de uitbreiding actief is, beginnen dezelfde endpoints je flags terug te geven.

De API gebruiken

Stream Radar biedt twee leesendpoints, beide met dezelfde Bearer-token-authenticatie als de rest van de publieke LabelGrid-API. Voor de volledige, altijd actuele request- en response-schema’s, zie de API-referentie.

Flags ophalen

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

Geeft de flags van je account terug, meest recente detectie eerst. De response is gepagineerd:

Parameter	Wat het doet
page	De pagina met resultaten die je wilt terugkrijgen.
per_page	Resultaten per pagina, tot een maximum van 100.

Je kunt de lijst verfijnen met elk van deze filters:

Filter	Waarden
filter[status]	active of resolved.
filter[severity]	low, medium of high.
filter[dsp]	Een platform-identifier (bijvoorbeeld spotify).
filter[isrc]	Een ISRC, om flags voor één opname te zien.
filter[release_id]	Een release-ID, om flags over een hele release te zien.
filter[detected_from]	Begindatum (YYYY-MM-DD), gematcht op de laatste detectiedatum van een flag.
filter[detected_to]	Einddatum (YYYY-MM-DD), gematcht op de laatste detectiedatum van een flag.

Bijvoorbeeld, om de openstaande flags met hoge ernst op te halen die deze maand zijn gedetecteerd:

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

Een enkele flag ophalen

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

Geeft één flag terug op basis van zijn id. Een flag die bij een ander account hoort, geeft 404 terug — je ziet altijd alleen je eigen flags.

Flagvelden

Elke flag bevat:

Veld	Wat het je vertelt
id	De stabiele identifier van de flag.
dsp	Het platform waarop het patroon is gezien (bijvoorbeeld spotify).
isrc	De ISRC van de betrokken opname.
release_id	De release waartoe de opname behoort.
track_id	De specifieke track, wanneer de ISRC ondubbelzinnig verwijst naar een van je tracks.
severity	low, medium of high, om je te helpen prioriteren.
status	active zolang het patroon aanhoudt, resolved zodra het stopt.
first_detected_at	Wanneer het patroon voor het eerst is gezien voor deze track en dit platform.
last_detected_at	De meest recente detectie.
estimated_affected_streams	Een schatting van hoeveel streams erbij betrokken zijn, om de omvang in te schatten.
published_at	Wanneer de flag voor het eerst aan je is gemeld.
resolved_at	Wanneer de flag is opgelost, of null zolang die nog actief is.

Hoe een flag zich in de tijd gedraagt

Stream Radar houdt één flag per track per platform aan, zodat de geschiedenis van een track op een bepaald platform in één record blijft in plaats van te versnipperen over vele:

• Herhaalde detecties verlengen dezelfde flag. Zolang een patroon blijft opduiken, schuift zijn last_detected_at op en blijft de flag active — de id verandert niet.
• Een flag lost automatisch op wanneer de detecties stoppen. Zodra het patroon niet meer wordt gezien, gaat de flag naar resolved en wordt zijn resolved_at ingesteld. Je hoeft ‘m niet zelf te sluiten.
• Een nieuwe detectie heropent dezelfde flag. Als het patroon terugkeert nadat een flag was opgelost, gaat diezelfde flag (dezelfde id) terug naar active in plaats van dat er een nieuwe wordt aangemaakt.

Dit betekent dat je de id van een flag kunt vertrouwen als een duurzame verwijzing naar een track-en-platformsituatie gedurende de hele levensduur.

Webhooks

In plaats van te pollen voor flags kun je LabelGrid je een melding laten pushen zodra er een verandert. Abonneer je op dezelfde manier als op de andere webhook-events van LabelGrid, vanuit je webhook-instellingen in de app of via de API. Stream Radar vuurt twee events af:

Event	Wanneer het afvuurt
stream_radar.flag_created	Een flag wordt voor het eerst geplaatst, of een opgeloste flag heropent bij een nieuwe detectie.
stream_radar.flag_resolved	Een flag lost op doordat de detecties zijn gestopt.

Elke payload bevat dezelfde velden als de flag zelf, met flag_id als naam van de flag. stream_radar.flag_created voegt een transition-veld toe zodat je de twee gevallen uit elkaar kunt houden:

transition	Betekenis
published	Er is een gloednieuwe flag geplaatst.
reopened	Een bestaande, eerder opgeloste flag is weer actief geworden.

Opmerking

Webhooklevering is best-effort. Behandel de endpoints flags ophalen en een enkele flag ophalen als de bron van waarheid, en gebruik webhooks als een seintje om de huidige staat te gaan lezen — niet als een gegarandeerd, volledig overzicht van elke wijziging.

Dekking

Stream Radar bewaakt momenteel Spotify; een flag van Spotify heeft dsp op spotify staan. De dekking breidt in de loop van de tijd additief uit — naarmate er meer platforms bijkomen, verschijnen ze als nieuwe dsp-waarden op nieuwe flags, en er verandert niets aan de flags die je al afhandelt. Filter op filter[dsp] als je je tooling wilt beperken tot een specifiek platform.

Wat te doen wanneer een track wordt gemarkeerd

Een flag is een aanleiding om te kijken, geen conclusie. Wanneer er een binnenkomt:

• Controleer recente promotie. Is deze track onlangs gepusht via een playlistdienst, een marketingcampagne of een promotor? Promotie van derden is de meest voorkomende bron van kunstmatige streams, en vaak is de verkoper — niet jij of de artiest — de oorzaak.
• Praat met de artiest. Vraag wat ze hebben gedaan om de track te promoten. Artiesten noemen niet altijd een dienst waarvoor ze hebben betaald, en ze beseffen misschien niet dat een aanbod met ‘gegarandeerde streams’ een alarmsignaal is.
• Pauzeer campagnes die je niet kunt verifiëren. Loopt er een promotie waarvan je niet kunt bevestigen dat die legitiem is, dan stopt het pauzeren ervan de groei van het patroon terwijl je het onderzoekt. Wanneer de detecties stoppen, lost de flag vanzelf op.

Vroeg ingrijpen op een flag is precies waar Stream Radar om draait: het is veel beter om een slechte promotie zelf op te sporen en terug te draaien dan dat een platform als eerste een heffing, een takedown of een accountstrike oplegt.

---

Vragen over Stream Radar? Neem contact op met ons team. We helpen je graag.