Stream Radar

Stream Radar est une option payante facultative pour les comptes de distribution avec API. Elle surveille votre catalogue à la recherche de motifs d’écoute compatibles avec le streaming artificiel et signale les pistes à surveiller, suffisamment tôt pour que vous puissiez agir avant que cela ne se transforme en frais d’une DSP, en retrait ou en sanction contre votre compte.

Un signalement Stream Radar est un signal d’alerte précoce, pas un verdict. La majeure partie du streaming artificiel provient de promotion tierce achetée de bonne foi : un push de playlist ou un service marketing qui s’est révélé gonfler artificiellement les écoutes. Un signalement vous donne l’occasion de vérifier ce qui se passe et de réagir à vos conditions, plutôt que de l’apprendre au moment où une plateforme agit.

Stream Radar expose ses signalements via l’API publique afin que vous puissiez les intégrer à vos propres tableaux de bord, alertes et flux de revue.

Qu’est-ce que Stream Radar

Avec Stream Radar activé sur votre compte, LabelGrid surveille votre catalogue distribué à la recherche de motifs d’écoute compatibles avec le streaming artificiel. Lorsqu’une piste présente un tel motif sur une plateforme, Stream Radar crée un signalement : un enregistrement que vous pouvez lire via l’API et qui vous indique quelle piste, sur quelle plateforme, mérite un examen.

Chaque signalement nomme la piste et la plateforme concernées, une gravité pour vous aider à prioriser, et une estimation du nombre d’écoutes impliquées, afin que vous puissiez trier rapidement et approfondir celles qui comptent.

Stream Radar ne fait que remonter des informations sur lesquelles agir. Ce que vous faites d’un signalement — vérifier une campagne, parler à l’artiste, mettre une promotion en pause — dépend de vous.

Comment obtenir Stream Radar

Stream Radar est une option payante activée par compte par notre équipe. Pour l’activer, contactez notre équipe commerciale et indiquez-lui que vous souhaitez Stream Radar.

Tant qu’elle n’est pas activée, les endpoints de Stream Radar renvoient :

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

avec un statut HTTP 403. Une fois l’option active, les mêmes endpoints commencent à renvoyer vos signalements.

Utiliser l’API

Stream Radar fournit deux endpoints en lecture, tous deux avec la même authentification par jeton Bearer que le reste de l’API publique de LabelGrid. Pour les schémas complets et toujours à jour des requêtes et des réponses, consultez la référence de l’API.

Lister les signalements

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

Renvoie les signalements de votre compte, la détection la plus récente en premier. La réponse est paginée :

Paramètre	Rôle
page	La page de résultats à renvoyer.
per_page	Résultats par page, jusqu’à un maximum de 100.

Vous pouvez restreindre la liste avec l’un de ces filtres :

Filtre	Valeurs
filter[status]	active ou resolved.
filter[severity]	low, medium ou high.
filter[dsp]	Un identifiant de plateforme (par exemple, spotify).
filter[isrc]	Un ISRC, pour voir les signalements d’un enregistrement.
filter[release_id]	Un ID de sortie, pour voir les signalements sur toute une sortie.
filter[detected_from]	Date de début (YYYY-MM-DD), comparée à la date de dernière détection d’un signalement.
filter[detected_to]	Date de fin (YYYY-MM-DD), comparée à la date de dernière détection d’un signalement.

Par exemple, pour récupérer les signalements ouverts de gravité élevée détectés ce mois-ci :

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

Obtenir un signalement

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

Renvoie un signalement par son id. Un signalement appartenant à un autre compte renvoie 404 : vous ne voyez jamais que vos propres signalements.

Champs d’un signalement

Chaque signalement contient :

Champ	Ce qu’il vous indique
id	L’identifiant stable du signalement.
dsp	La plateforme sur laquelle le motif a été observé (par exemple, spotify).
isrc	L’ISRC de l’enregistrement concerné.
release_id	La sortie à laquelle appartient l’enregistrement.
track_id	La piste précise, lorsque l’ISRC correspond sans ambiguïté à l’une de vos pistes.
severity	low, medium ou high, pour vous aider à prioriser.
status	active tant que le motif se poursuit, resolved une fois qu’il cesse.
first_detected_at	Quand le motif a été observé pour la première fois pour cette piste et cette plateforme.
last_detected_at	La détection la plus récente.
estimated_affected_streams	Une estimation du nombre d’écoutes impliquées, pour évaluer l’ampleur.
published_at	Quand le signalement vous a été remonté pour la première fois.
resolved_at	Quand le signalement s’est résolu, ou null tant qu’il est actif.

Comment un signalement évolue dans le temps

Stream Radar conserve un signalement par piste et par plateforme, de sorte que l’historique d’une piste sur une plateforme donnée reste dans un seul enregistrement au lieu de se fragmenter en plusieurs :

• Les détections répétées prolongent le même signalement. Tant que le motif continue d’apparaître, son last_detected_at avance et le signalement reste active : l’id ne change pas.
• Un signalement se résout automatiquement quand les détections cessent. Une fois que le motif n’est plus observé, le signalement passe à resolved et son resolved_at est renseigné. Vous n’avez pas à le fermer vous-même.
• Une nouvelle détection rouvre le même signalement. Si le motif revient après la résolution d’un signalement, ce même signalement (même id) repasse à active au lieu qu’un nouveau soit créé.

Vous pouvez donc vous fier à l’id d’un signalement comme identifiant durable d’une situation piste-et-plateforme tout au long de sa vie.

Webhooks

Plutôt que de sonder les signalements, vous pouvez faire en sorte que LabelGrid vous pousse une notification dès qu’un signalement change. Abonnez-vous de la même façon que vous vous abonnez aux autres événements de webhook de LabelGrid, depuis les paramètres de webhooks dans l’application ou via l’API. Stream Radar déclenche deux événements :

Événement	Quand il se déclenche
stream_radar.flag_created	Un signalement est créé pour la première fois, ou un signalement résolu rouvre sur une nouvelle détection.
stream_radar.flag_resolved	Un signalement se résout parce que les détections ont cessé.

Chaque payload contient les mêmes champs que le signalement lui-même, avec flag_id nommant le signalement. stream_radar.flag_created ajoute un champ transition pour vous permettre de distinguer les deux cas :

transition	Signification
published	Un signalement entièrement nouveau a été créé.
reopened	Un signalement existant, précédemment résolu, est redevenu actif.

Note

La livraison des webhooks se fait au mieux. Traitez les endpoints de liste et de signalement individuel comme la source de vérité, et utilisez les webhooks comme une incitation à aller lire l’état actuel — non comme un enregistrement garanti et complet de chaque changement.

Couverture

Stream Radar surveille actuellement Spotify ; un signalement issu de Spotify a dsp réglé sur spotify. La couverture s’étend de manière additive au fil du temps : à mesure que d’autres plateformes sont ajoutées, elles apparaissent comme de nouvelles valeurs de dsp sur de nouveaux signalements, et rien ne change concernant les signalements que vous traitez déjà. Filtrez sur filter[dsp] si vous souhaitez limiter vos outils à une plateforme précise.

Que faire lorsqu’une piste est signalée

Un signalement est une invitation à regarder, pas une conclusion. Quand il en arrive un :

• Vérifiez la promotion récente. Cette piste a-t-elle été poussée récemment via un service de playlists, une campagne marketing ou un promoteur ? La promotion tierce est la source la plus fréquente de streaming artificiel, et souvent la cause est le vendeur, pas vous ni l’artiste.
• Parlez à l’artiste. Demandez-lui ce qu’il a fait pour promouvoir la piste. Les artistes ne mentionnent pas toujours un service qu’ils ont payé, et ils ne réalisent pas forcément qu’une offre d’« écoutes garanties » est un signal d’alarme.
• Mettez en pause les campagnes que vous ne pouvez pas vérifier. Si une promotion est en cours sans que vous puissiez la confirmer légitime, la mettre en pause empêche le motif de croître pendant que vous enquêtez. Quand les détections cessent, le signalement se résout de lui-même.

Agir tôt sur un signalement est tout l’intérêt de Stream Radar : il vaut bien mieux détecter et défaire vous-même une mauvaise promotion que de laisser une plateforme appliquer d’abord des frais, un retrait ou une sanction sur votre compte.

---

Des questions sur Stream Radar ? Contactez notre équipe. Nous serons ravis de vous aider.