Stream Radar

Stream Radar ist eine optionale kostenpflichtige Zusatzoption für API-Distributionskonten. Sie überwacht Ihren Katalog auf Streaming-Muster, die mit künstlichem Streaming vereinbar sind, und kennzeichnet Tracks, die Aufmerksamkeit brauchen – früh genug, damit Sie handeln können, bevor daraus eine Gebühr einer DSP, ein Takedown oder eine Verwarnung gegen Ihr Konto wird.

Eine Stream-Radar-Meldung ist ein Frühwarnsignal, kein Urteil. Der größte Teil des künstlichen Streamings geht auf in gutem Glauben eingekaufte Drittanbieter-Promotion zurück: ein Playlist-Push oder ein Marketing-Dienst, der sich als künstlich streamzahl-treibend herausstellte. Eine Meldung gibt Ihnen die Gelegenheit, zu prüfen, was vor sich geht, und zu Ihren eigenen Bedingungen zu reagieren, statt es erst zu erfahren, wenn eine Plattform handelt.

Stream Radar stellt seine Meldungen über die öffentliche API bereit, damit Sie sie in Ihre eigenen Dashboards, Warnmeldungen und Prüf-Workflows einbinden können.

Was Stream Radar ist

Mit auf Ihrem Konto aktiviertem Stream Radar beobachtet LabelGrid Ihren distribuierten Katalog auf Streaming-Muster, die mit künstlichem Streaming vereinbar sind. Wenn ein Track ein solches Muster auf einer Plattform zeigt, erstellt Stream Radar eine Meldung: einen Datensatz, den Sie über die API lesen können und der Ihnen sagt, welcher Track auf welcher Plattform einen Blick braucht.

Jede Meldung nennt den betroffenen Track und die Plattform, einen Schweregrad zur Priorisierung und eine Schätzung, wie viele Streams beteiligt sind, damit Sie schnell triagieren und die wirklich relevanten genauer ansehen können.

Stream Radar bringt lediglich Informationen ans Licht, auf die Sie reagieren können. Was Sie mit einer Meldung tun – eine Kampagne prüfen, mit der Künstlerin oder dem Künstler sprechen, eine Promotion pausieren – bleibt Ihnen überlassen.

So erhalten Sie Stream Radar

Stream Radar ist eine kostenpflichtige Zusatzoption, die unser Team pro Konto aktiviert. Um sie einzuschalten, kontaktieren Sie unser Vertriebsteam und teilen Sie mit, dass Sie Stream Radar möchten.

Bis sie aktiviert ist, geben die Stream-Radar-Endpunkte Folgendes zurück:

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

mit einem HTTP-Status 403. Sobald die Zusatzoption aktiv ist, geben dieselben Endpunkte Ihre Meldungen zurück.

Die API nutzen

Stream Radar stellt zwei Lese-Endpunkte bereit, beide mit derselben Bearer-Token-Authentifizierung wie der Rest der öffentlichen LabelGrid-API. Die vollständigen, stets aktuellen Anfrage- und Antwortschemata finden Sie in der API-Referenz.

Meldungen auflisten

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

Gibt die Meldungen Ihres Kontos zurück, die jüngste Erkennung zuerst. Die Antwort ist paginiert:

Parameter	Funktion
page	Die zurückzugebende Ergebnisseite.
per_page	Ergebnisse pro Seite, bis zu maximal 100.

Sie können die Liste mit einem dieser Filter eingrenzen:

Filter	Werte
filter[status]	active oder resolved.
filter[severity]	low, medium oder high.
filter[dsp]	Eine Plattform-Kennung (zum Beispiel spotify).
filter[isrc]	Ein ISRC, um die Meldungen zu einer Aufnahme zu sehen.
filter[release_id]	Eine Release-ID, um die Meldungen über ein ganzes Release zu sehen.
filter[detected_from]	Startdatum (YYYY-MM-DD), verglichen mit dem Datum der letzten Erkennung einer Meldung.
filter[detected_to]	Enddatum (YYYY-MM-DD), verglichen mit dem Datum der letzten Erkennung einer Meldung.

Um zum Beispiel die offenen Meldungen mit hohem Schweregrad abzurufen, die in diesem Monat erkannt wurden:

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

Eine einzelne Meldung abrufen

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

Gibt eine Meldung anhand ihrer id zurück. Eine Meldung, die zu einem anderen Konto gehört, gibt 404 zurück – Sie sehen immer nur Ihre eigenen Meldungen.

Felder einer Meldung

Jede Meldung enthält:

Feld	Was es Ihnen sagt
id	Die stabile Kennung der Meldung.
dsp	Die Plattform, auf der das Muster beobachtet wurde (zum Beispiel spotify).
isrc	Der ISRC der betroffenen Aufnahme.
release_id	Das Release, zu dem die Aufnahme gehört.
track_id	Der konkrete Track, wenn der ISRC eindeutig einem Ihrer Tracks zugeordnet ist.
severity	low, medium oder high, zur Priorisierung.
status	active, solange das Muster anhält, resolved, sobald es aufhört.
first_detected_at	Wann das Muster für diesen Track und diese Plattform erstmals beobachtet wurde.
last_detected_at	Die jüngste Erkennung.
estimated_affected_streams	Eine Schätzung, wie viele Streams beteiligt sind, um den Umfang einzuordnen.
published_at	Wann Ihnen die Meldung erstmals gemeldet wurde.
resolved_at	Wann die Meldung aufgelöst wurde, oder null, solange sie noch aktiv ist.

Wie sich eine Meldung im Zeitverlauf verhält

Stream Radar führt eine Meldung pro Track und pro Plattform, sodass die Historie eines Tracks auf einer bestimmten Plattform in einem einzigen Datensatz bleibt, statt in viele zu zerfallen:

• Wiederholte Erkennungen verlängern dieselbe Meldung. Solange das Muster weiter auftritt, rückt ihr last_detected_at vor und die Meldung bleibt active – die id ändert sich nicht.
• Eine Meldung wird automatisch aufgelöst, wenn die Erkennungen aufhören. Sobald das Muster nicht mehr beobachtet wird, wechselt die Meldung auf resolved und ihr resolved_at wird gesetzt. Sie müssen sie nicht selbst schließen.
• Eine neue Erkennung öffnet dieselbe Meldung erneut. Kehrt das Muster zurück, nachdem eine Meldung aufgelöst wurde, wechselt genau diese Meldung (mit derselben id) wieder auf active, statt dass eine neue erstellt wird.

Das bedeutet, dass Sie sich auf die id einer Meldung als dauerhafte Referenz für eine Track-und-Plattform-Situation über ihre gesamte Lebensdauer verlassen können.

Webhooks

Statt nach Meldungen abzufragen, können Sie sich von LabelGrid eine Benachrichtigung senden lassen, sobald sich eine Meldung ändert. Abonnieren Sie sie genauso, wie Sie die anderen Webhook-Ereignisse von LabelGrid abonnieren – über die Webhook-Einstellungen in der App oder über die API. Stream Radar löst zwei Ereignisse aus:

Ereignis	Wann es ausgelöst wird
stream_radar.flag_created	Eine Meldung wird zum ersten Mal erstellt, oder eine aufgelöste Meldung wird bei einer neuen Erkennung erneut geöffnet.
stream_radar.flag_resolved	Eine Meldung wird aufgelöst, weil die Erkennungen aufgehört haben.

Jeder Payload trägt dieselben Felder wie die Meldung selbst, wobei flag_id die Meldung benennt. stream_radar.flag_created fügt ein Feld transition hinzu, mit dem Sie die beiden Fälle unterscheiden können:

transition	Bedeutung
published	Eine ganz neue Meldung wurde erstellt.
reopened	Eine bestehende, zuvor aufgelöste Meldung wurde wieder aktiv.

Hinweis

Die Zustellung von Webhooks erfolgt nach bestem Bemühen. Behandeln Sie die Endpunkte für die Liste und die einzelne Meldung als die verbindliche Quelle und nutzen Sie Webhooks als Anstoß, den aktuellen Zustand nachzulesen – nicht als garantiertes, vollständiges Protokoll jeder Änderung.

Abdeckung

Stream Radar überwacht derzeit Spotify; eine Meldung von Spotify hat dsp auf spotify gesetzt. Die Abdeckung wird im Lauf der Zeit additiv erweitert: Werden weitere Plattformen hinzugefügt, erscheinen sie als neue dsp-Werte auf neuen Meldungen, und an den Meldungen, die Sie bereits bearbeiten, ändert sich nichts. Filtern Sie über filter[dsp], wenn Sie Ihre Tools auf eine bestimmte Plattform beschränken möchten.

Was tun, wenn ein Track gemeldet wird

Eine Meldung ist eine Aufforderung hinzusehen, keine Schlussfolgerung. Wenn eine eintrifft:

• Prüfen Sie die jüngste Promotion. Wurde dieser Track kürzlich über einen Playlist-Dienst, eine Marketingkampagne oder einen Promoter gepusht? Drittanbieter-Promotion ist die häufigste Quelle künstlichen Streamings, und oft ist der Anbieter die Ursache – nicht Sie oder die Künstlerin bzw. der Künstler.
• Sprechen Sie mit der Künstlerin oder dem Künstler. Fragen Sie, was zur Bewerbung des Tracks unternommen wurde. Künstlerinnen und Künstler erwähnen einen bezahlten Dienst nicht immer und merken womöglich nicht, dass ein Angebot mit „garantierten Streams“ ein Warnsignal ist.
• Pausieren Sie Kampagnen, die Sie nicht verifizieren können. Läuft eine Promotion, die Sie nicht als legitim bestätigen können, verhindert ein Pausieren, dass das Muster wächst, während Sie der Sache nachgehen. Wenn die Erkennungen aufhören, löst sich die Meldung von selbst auf.

Früh auf eine Meldung zu reagieren, ist der ganze Sinn von Stream Radar: Es ist weit besser, eine schlechte Promotion selbst zu erkennen und rückgängig zu machen, als eine Plattform zuerst eine Gebühr, einen Takedown oder eine Kontoverwarnung verhängen zu lassen.

---

Fragen zu Stream Radar? Kontaktieren Sie unser Team. Wir helfen Ihnen gern.