Stream Radar
Stream Radar は、API 配信アカウント向けの有料オプションアドオンです。カタログに、アーティフィシャルストリーミングと一致するストリーミングパターンがないかを監視し、注意が必要なトラックにフラグを立てます。DSP の手数料、テイクダウン、アカウントへのストライクに発展する前に対応できるよう、十分に早い段階でお知らせします。
Stream Radar のフラグは、判定ではなく早期警告のシグナル です。アーティフィシャルストリーミングのほとんどは、善意で購入したサードパーティのプロモーション（結果として再生数を不正に水増ししてしまったプレイリストプッシュやマーケティングサービスなど）に起因します。フラグがあれば、プラットフォームが動いてから知るのではなく、何が起きているかを確認し、自分の判断で対応する機会を得られます。
Stream Radar はフラグをパブリック API 経由で公開するため、自社のダッシュボード、アラート、レビューのワークフローに取り込めます。
Stream Radar とは
Section titled “Stream Radar とは”アカウントで Stream Radar を有効にすると、LabelGrid は配信済みのカタログに、アーティフィシャルストリーミングと一致するストリーミングパターンがないかを監視します。あるトラックがあるプラットフォームでそのようなパターンを示すと、Stream Radar は フラグ を立てます。フラグは API 経由で読み取れる記録で、どのトラックが、どのプラットフォームで、確認を必要としているかを伝えます。
各フラグは、対象のトラックとプラットフォーム、優先順位付けに役立つ重大度、そして関与しているストリーム数の推定値を示すため、素早くトリアージして、重要なものを掘り下げられます。
Stream Radar は、あなたが対応するための情報を示すだけです。フラグをどう扱うか（キャンペーンを確認する、アーティストと話す、プロモーションを一時停止する）は、あなた次第です。
Stream Radar の入手方法
Section titled “Stream Radar の入手方法”Stream Radar は、当社チームがアカウントごとに有効化する有料アドオンです。有効にするには、当社の営業チームにお問い合わせ いただき、Stream Radar を希望する旨をお伝えください。
有効になるまで、Stream Radar のエンドポイントは次を返します。
{ "error_code": "stream_radar_not_enabled", "message": "Stream Radar is not enabled for this account."}併せて HTTP 403 ステータスが返されます。アドオンが有効になると、同じエンドポイントがあなたのフラグを返し始めます。
API の使用
Section titled “API の使用”Stream Radar は 2 つの読み取り専用エンドポイントを提供し、いずれも LabelGrid パブリック API の他の部分と同じ Bearer トークン認証を使用します。完全で常に最新のリクエストおよびレスポンスのスキーマについては、API リファレンス を参照してください。
フラグの一覧を取得する
Section titled “フラグの一覧を取得する”GET /v4/public/stream-radar/flagsAuthorization: Bearer YOUR_API_TOKENアカウントのフラグを、最新の検出を先頭にして返します。レスポンスはページ分割されます。
| パラメーター | 動作 |
|---|---|
page | 返す結果のページ。 |
per_page | 1 ページあたりの結果数。最大 100 まで。 |
次のフィルターで一覧を絞り込めます。
| フィルター | 値 |
|---|---|
filter[status] | active または resolved。 |
filter[severity] | low、medium、または high。 |
filter[dsp] | プラットフォーム識別子（例: spotify）。 |
filter[isrc] | ISRC。1 つの録音のフラグを見るため。 |
filter[release_id] | リリース ID。リリース全体のフラグを見るため。 |
filter[detected_from] | 開始日（YYYY-MM-DD）。フラグの 最後の 検出日で照合されます。 |
filter[detected_to] | 終了日（YYYY-MM-DD）。フラグの 最後の 検出日で照合されます。 |
たとえば、今月検出された、未解決かつ高重大度のフラグを取得するには次のようにします。
GET /v4/public/stream-radar/flags?filter[status]=active&filter[severity]=high&filter[detected_from]=2026-07-01Authorization: Bearer YOUR_API_TOKEN単一のフラグを取得する
Section titled “単一のフラグを取得する”GET /v4/public/stream-radar/flags/{id}Authorization: Bearer YOUR_API_TOKENid で 1 つのフラグを返します。別のアカウントに属するフラグは 404 を返します。あなたは自分のフラグしか見られません。
フラグのフィールド
Section titled “フラグのフィールド”各フラグは次を保持します。
| フィールド | 何を示すか |
|---|---|
id | フラグの安定した識別子。 |
dsp | パターンが見られたプラットフォーム（例: spotify）。 |
isrc | 関与している録音の ISRC。 |
release_id | 録音が属するリリース。 |
track_id | ISRC が自分のトラックの 1 つに一意に対応する場合の、その特定のトラック。 |
severity | low、medium、または high。優先順位付けに役立ちます。 |
status | パターンが継続している間は active、止まると resolved。 |
first_detected_at | このトラックとプラットフォームでパターンが最初に見られた時刻。 |
last_detected_at | 最新の検出。 |
estimated_affected_streams | 規模を測るための、関与しているストリーム数の推定値。 |
published_at | フラグが最初にあなたに提示された時刻。 |
resolved_at | フラグが解決した時刻。まだ有効な間は null。 |
フラグの時間経過による挙動
Section titled “フラグの時間経過による挙動”Stream Radar は トラックごと・プラットフォームごとに 1 つのフラグ を保持するため、あるプラットフォームでのトラックの履歴は、多数に分裂することなく単一の記録にまとまります。
- 検出が繰り返されると同じフラグが延長されます。 パターンが現れ続ける間、
last_detected_atが進み、フラグはactiveのままです。idは変わりません。 - 検出が止まるとフラグは自動的に解決します。 パターンが見られなくなると、フラグは
resolvedに移り、resolved_atが設定されます。自分で閉じる必要はありません。 - 新しい検出は同じフラグを再開させます。 フラグが解決した後にパターンが戻ってくると、新しいフラグが作られるのではなく、その同じフラグ（同じ
id）がactiveに戻ります。
つまり、フラグの id は、トラックとプラットフォームの状況をその一生涯を通じて追える恒久的なハンドルとして信頼できます。
Webhook
Section titled “Webhook”フラグをポーリングする代わりに、フラグが変化した瞬間に LabelGrid から通知をプッシュしてもらえます。LabelGrid の他の webhook イベントを購読するのと同じ方法で、アプリの webhook 設定から、または API 経由で購読します。Stream Radar は 2 つのイベントを発火します。
| イベント | 発火するタイミング |
|---|---|
stream_radar.flag_created | フラグが初めて立てられたとき、または解決済みのフラグが新しい検出で再開したとき。 |
stream_radar.flag_resolved | 検出が止まってフラグが解決したとき。 |
各ペイロードはフラグ自体と同じフィールドを保持し、flag_id がフラグを指します。stream_radar.flag_created は 2 つのケースを区別できるよう transition フィールドを追加します。
transition | 意味 |
|---|---|
published | まったく新しいフラグが立てられた。 |
reopened | 既存の、以前に解決したフラグが再び有効になった。 |
Stream Radar は現在 Spotify を監視しています。Spotify からのフラグは dsp が spotify に設定されます。対象範囲は時間とともに追加的に拡大します。プラットフォームが追加されると、新しいフラグに新しい dsp の値として現れ、すでに扱っているフラグについては何も変わりません。ツールを特定のプラットフォームに絞りたい場合は filter[dsp] でフィルターしてください。
トラックにフラグが付いたときの対応
Section titled “トラックにフラグが付いたときの対応”フラグは、確認を促すものであって結論ではありません。フラグが届いたら次のようにします。
- 最近のプロモーションを確認する。 このトラックは最近、プレイリストサービス、マーケティングキャンペーン、またはプロモーターを通じて宣伝されましたか。サードパーティのプロモーションはアーティフィシャルストリーミングの最も一般的な原因であり、多くの場合、あなたやアーティストではなく販売者が原因です。
- アーティストと話す。 トラックをどのように宣伝したか尋ねてください。アーティストは支払ったサービスについて必ずしも言及せず、「再生数保証」のオファーが危険信号だと気づいていないこともあります。
- 確認できないキャンペーンを一時停止する。 正当だと確認できないプロモーションが実行中の場合、一時停止すれば、調査している間にパターンが拡大するのを止められます。検出が止まれば、フラグは自動的に解決します。
フラグに早く対応することこそが Stream Radar の眼目です。プラットフォームに手数料、テイクダウン、アカウントのストライクを先に科されるより、悪質なプロモーションを自分で見つけて解消するほうがはるかに得策です。
Stream Radar についてのご質問は、当社チームにお問い合わせください。喜んでお手伝いします。