Stream Radar

Stream Radar är ett valfritt premiumtillägg för konton med API-distribution. Det bevakar din katalog efter streamingmönster som tyder på artificiell streaming och flaggar spår som behöver uppmärksamhet, tidigt nog för att du ska hinna agera innan det blir en DSP-avgift, en takedown eller en prick mot ditt konto.

En Stream Radar-flagga är en tidig varningssignal, inte en dom. Det mesta av artificiell streaming går att spåra till tredjepartspromotion som köpts i god tro – en spellistesatsning eller en marknadsföringstjänst som visade sig blåsa upp uppspelningar artificiellt. En flagga ger dig chansen att kontrollera vad som händer och agera på dina egna villkor, i stället för att få veta det först när en plattform agerar.

Stream Radar exponerar sina flaggor via det publika API:et så att du kan hämta in dem i dina egna dashboards, larm och granskningsflöden.

Vad Stream Radar är

Med Stream Radar aktiverat på ditt konto bevakar LabelGrid din distribuerade katalog efter streamingmönster som tyder på artificiell streaming. När ett spår visar ett sådant mönster på en plattform reser Stream Radar en flagga: en post som du kan läsa via API:et och som talar om vilket spår, på vilken plattform, som behöver ses över.

Varje flagga anger det berörda spåret och plattformen, en allvarlighetsgrad som hjälper dig att prioritera och en uppskattning av hur många streams som är inblandade, så att du snabbt kan prioritera och gräva i dem som betyder något.

Stream Radar lyfter bara fram information för dig att agera på. Vad du gör med en flagga – kontrollera en kampanj, prata med artisten, pausa en promotion – är upp till dig.

Så får du Stream Radar

Stream Radar är ett premiumtillägg som vårt team aktiverar per konto. För att slå på det, kontakta vårt säljteam och meddela att du vill ha Stream Radar.

Tills det är aktiverat returnerar Stream Radar-endpointerna:

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

med HTTP-statusen 403. När tillägget är aktivt börjar samma endpoints returnera dina flaggor.

Använda API:et

Stream Radar tillhandahåller två läs-endpoints, båda med samma Bearer-token-autentisering som resten av LabelGrids publika API. För de fullständiga och alltid aktuella request- och response-scheman, se API-referensen.

Lista flaggor

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

Returnerar ditt kontos flaggor, med den senaste detektionen först. Svaret är sidindelat:

Parameter	Vad den gör
page	Vilken resultatsida som ska returneras.
per_page	Antal resultat per sida, upp till högst 100.

Du kan avgränsa listan med något av de här filtren:

Filter	Värden
filter[status]	active eller resolved.
filter[severity]	low, medium eller high.
filter[dsp]	En plattformsidentifierare (till exempel spotify).
filter[isrc]	En ISRC, för att se flaggor för en enskild inspelning.
filter[release_id]	Ett release-ID, för att se flaggor för en hel release.
filter[detected_from]	Startdatum (YYYY-MM-DD), matchas mot en flaggas senaste detektionsdatum.
filter[detected_to]	Slutdatum (YYYY-MM-DD), matchas mot en flaggas senaste detektionsdatum.

Till exempel, för att hämta de öppna flaggorna med hög allvarlighetsgrad som detekterats den här månaden:

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

Hämta en enskild flagga

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

Returnerar en enskild flagga utifrån dess id. En flagga som tillhör ett annat konto returnerar 404 – du ser aldrig annat än dina egna flaggor.

Flaggans fält

Varje flagga bär med sig:

Fält	Vad det säger dig
id	Flaggans stabila identifierare.
dsp	Plattformen som mönstret sågs på (till exempel spotify).
isrc	ISRC för den berörda inspelningen.
release_id	Releasen som inspelningen hör till.
track_id	Det specifika spåret, när ISRC entydigt mappar till ett av dina spår.
severity	low, medium eller high, för att hjälpa dig prioritera.
status	active medan mönstret pågår, resolved när det upphör.
first_detected_at	När mönstret först sågs för det här spåret och den här plattformen.
last_detected_at	Den senaste detektionen.
estimated_affected_streams	En uppskattning av hur många streams som är inblandade, för att bedöma omfattningen.
published_at	När flaggan först restes för dig.
resolved_at	När flaggan löstes, eller null medan den fortfarande är aktiv.

Hur en flagga beter sig över tid

Stream Radar håller en flagga per spår och plattform, så att ett spårs historik på en viss plattform stannar i en enda post i stället för att splittras upp i många:

• Upprepade detektioner förlänger samma flagga. Så länge ett mönster fortsätter att dyka upp flyttas dess last_detected_at fram och flaggan förblir active – dess id ändras inte.
• En flagga löses automatiskt när detektionerna upphör. När mönstret inte längre syns går flaggan över till resolved och dess resolved_at sätts. Du behöver inte stänga den själv.
• En ny detektion återöppnar samma flagga. Om mönstret återkommer efter att en flagga lösts går just den flaggan (samma id) tillbaka till active i stället för att en ny skapas.

Det betyder att du kan lita på en flaggas id som ett hållbart handtag för en spår-och-plattform-situation under hela dess livslängd.

Webhooks

I stället för att polla efter flaggor kan du låta LabelGrid pusha en avisering till dig i samma stund som en flagga ändras. Prenumerera på samma sätt som du prenumererar på LabelGrids andra webhook-händelser, från dina webhook-inställningar i appen eller via API:et. Stream Radar utlöser två händelser:

Händelse	När den utlöses
stream_radar.flag_created	En flagga reses för första gången, eller en löst flagga återöppnas vid en ny detektion.
stream_radar.flag_resolved	En flagga löses för att detektionerna upphörde.

Varje nyttolast bär med sig samma fält som flaggan själv, med flag_id som anger flaggan. stream_radar.flag_created lägger till ett transition-fält så att du kan skilja de två fallen åt:

transition	Betydelse
published	En helt ny flagga restes.
reopened	En befintlig, tidigare löst flagga blev aktiv igen.

Note

Webhook-leverans sker efter bästa förmåga. Behandla list- och enskild flagga-endpointerna som den auktoritativa källan, och använd webhooks som en signal att gå och läsa det aktuella tillståndet – inte som en garanterad, fullständig logg över varje ändring.

Täckning

Stream Radar bevakar för närvarande Spotify; en flagga från Spotify har dsp satt till spotify. Täckningen utökas additivt över tid – i takt med att fler plattformar läggs till dyker de upp som nya dsp-värden på nya flaggor, och inget ändras för de flaggor du redan hanterar. Filtrera på filter[dsp] om du vill avgränsa dina verktyg till en viss plattform.

Vad du ska göra när ett spår flaggas

En flagga är en uppmaning att titta, inte en slutsats. När en kommer in:

• Kontrollera nyligen genomförd promotion. Har det här spåret nyligen pushats genom en spellistetjänst, en marknadsföringskampanj eller en promotor? Tredjepartspromotion är den vanligaste källan till artificiell streaming, och ofta är det säljaren – inte du eller artisten – som ligger bakom.
• Prata med artisten. Fråga vad de har gjort för att marknadsföra spåret. Artister nämner inte alltid en tjänst de betalat för, och de inser kanske inte att ett erbjudande om “garanterade streams” är en varningssignal.
• Pausa kampanjer du inte kan verifiera. Om en promotion pågår som du inte kan bekräfta är legitim hindrar en paus mönstret från att växa medan du undersöker saken. När detektionerna upphör löses flaggan av sig själv.

Att agera tidigt på en flagga är hela poängen med Stream Radar: det är långt bättre att själv upptäcka och avveckla en dålig promotion än att en plattform hinner före med en avgift, en takedown eller en prick mot kontot.

---

Frågor om Stream Radar? Kontakta vårt team. Vi hjälper dig gärna.