Stream Radar
Stream Radar는 API 유통 계정을 위한 선택형 유료 추가 기능이에요. 인위적 스트리밍과 일치하는 스트리밍 패턴이 있는지 회원님의 카탈로그를 모니터링하고, 주의가 필요한 트랙을 플래그로 표시해요. DSP 수수료나 테이크다운, 계정 제재로 이어지기 전에 회원님이 대처할 수 있을 만큼 충분히 이른 시점에 알려 줘요.
Stream Radar 플래그는 판정이 아니라 조기 경고 신호예요. 인위적 스트리밍은 대부분 선의로 구매한 서드파티 프로모션에서 비롯돼요. 알고 보니 재생 수를 인위적으로 부풀린 플레이리스트 푸시나 마케팅 서비스 같은 것이죠. 플래그가 있으면 플랫폼이 조치를 취할 때에야 알게 되는 대신, 무슨 일이 벌어지고 있는지 확인하고 회원님의 방식대로 대응할 기회를 얻게 돼요.
Stream Radar는 플래그를 퍼블릭 API로 제공하므로, 회원님의 대시보드와 알림, 검토 워크플로에 플래그를 가져올 수 있어요.
Stream Radar란
섹션 제목: “Stream Radar란”계정에서 Stream Radar를 켜면, LabelGrid이 인위적 스트리밍과 일치하는 스트리밍 패턴이 있는지 회원님의 유통 카탈로그를 지켜봐요. 어떤 트랙이 특정 플랫폼에서 그런 패턴을 보이면, Stream Radar가 플래그를 올려요. 플래그는 어느 트랙이 어느 플랫폼에서 살펴봐야 하는지 알려 주는, API로 읽을 수 있는 기록이에요.
각 플래그는 영향받는 트랙과 플랫폼, 우선순위를 정하는 데 도움이 되는 심각도, 그리고 관련된 스트림 수의 추정치를 알려 줘요. 덕분에 빠르게 분류하고 중요한 것을 깊이 들여다볼 수 있어요.
Stream Radar는 회원님이 대처할 정보를 드러내 줄 뿐이에요. 플래그로 무엇을 할지—캠페인을 확인하든, 아티스트와 이야기하든, 프로모션을 일시 중지하든—는 회원님에게 달려 있어요.
Stream Radar 이용 방법
섹션 제목: “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 사용하기
섹션 제목: “API 사용하기”Stream Radar는 두 개의 읽기 엔드포인트를 제공하며, 둘 다 LabelGrid 퍼블릭 API의 나머지 부분과 동일한 Bearer 토큰 인증을 사용해요. 완전하고 항상 최신인 요청 및 응답 스키마는 API 레퍼런스를 참고하세요.
플래그 목록 조회
섹션 제목: “플래그 목록 조회”GET /v4/public/stream-radar/flagsAuthorization: Bearer YOUR_API_TOKEN회원님 계정의 플래그를 가장 최근에 감지된 것부터 반환해요. 응답은 페이지로 나뉘어요.
| 매개변수 | 하는 일 |
|---|---|
page | 반환할 결과 페이지. |
per_page | 페이지당 결과 수, 최대 100개까지. |
다음 필터로 목록을 좁힐 수 있어요.
| 필터 | 값 |
|---|---|
filter[status] | active 또는 resolved. |
filter[severity] | low, medium, high 중 하나. |
filter[dsp] | 플랫폼 식별자(예: spotify). |
filter[isrc] | ISRC로, 하나의 녹음물에 대한 플래그를 확인할 때. |
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단일 플래그 조회
섹션 제목: “단일 플래그 조회”GET /v4/public/stream-radar/flags/{id}Authorization: Bearer YOUR_API_TOKENid로 플래그 하나를 반환해요. 다른 계정에 속한 플래그는 404를 반환해요. 회원님은 언제나 자신의 플래그만 볼 수 있어요.
플래그 필드
섹션 제목: “플래그 필드”각 플래그는 다음을 담고 있어요.
| 필드 | 무엇을 알려주는지 |
|---|---|
id | 플래그의 안정적인 식별자. |
dsp | 패턴이 관찰된 플랫폼(예: spotify). |
isrc | 관련된 녹음물의 ISRC. |
release_id | 녹음물이 속한 릴리스. |
track_id | ISRC가 회원님의 트랙 중 하나에 명확하게 매핑될 때의 해당 트랙. |
severity | 우선순위를 정하는 데 도움이 되는 low, medium, high. |
status | 패턴이 진행 중인 동안에는 active, 멈추면 resolved. |
first_detected_at | 이 트랙과 플랫폼에서 패턴이 처음 관찰된 시점. |
last_detected_at | 가장 최근 감지 시점. |
estimated_affected_streams | 규모를 가늠할 수 있도록, 관련된 스트림 수의 추정치. |
published_at | 플래그가 회원님에게 처음 올라온 시점. |
resolved_at | 플래그가 해결된 시점, 아직 활성 상태인 동안에는 null. |
플래그가 시간에 따라 동작하는 방식
섹션 제목: “플래그가 시간에 따라 동작하는 방식”Stream Radar는 트랙별·플랫폼별로 하나의 플래그를 유지하므로, 특정 플랫폼에서의 트랙 이력이 여러 개로 쪼개지지 않고 하나의 기록에 남아요.
- 반복 감지는 같은 플래그를 연장해요. 패턴이 계속 나타나는 동안
last_detected_at이 갱신되고 플래그는active상태로 유지돼요.id는 바뀌지 않아요. - 감지가 멈추면 플래그가 자동으로 해결돼요. 패턴이 더 이상 관찰되지 않으면 플래그는
resolved로 이동하고resolved_at이 설정돼요. 회원님이 직접 닫을 필요는 없어요. - 새로운 감지는 같은 플래그를 다시 열어요. 플래그가 해결된 후 패턴이 다시 나타나면, 새 플래그가 생성되는 대신 같은 플래그(같은
id)가 다시active로 돌아가요.
따라서 플래그의 id를 트랙-플랫폼 상황 전체 생애에 걸친 지속적인 핸들로 신뢰할 수 있어요.
Webhook
섹션 제목: “Webhook”플래그를 폴링하는 대신, 플래그가 바뀌는 순간 LabelGrid이 알림을 푸시하도록 할 수 있어요. LabelGrid의 다른 webhook 이벤트를 구독하는 것과 동일한 방법으로, 앱의 webhook 설정에서 또는 API를 통해 구독하세요. Stream Radar는 두 개의 이벤트를 발생시켜요.
| 이벤트 | 발생 시점 |
|---|---|
stream_radar.flag_created | 플래그가 처음 올라오거나, 해결된 플래그가 새로운 감지로 다시 열릴 때. |
stream_radar.flag_resolved | 감지가 멈춰 플래그가 해결될 때. |
각 페이로드는 플래그 자체와 동일한 필드를 담으며, flag_id가 플래그를 가리켜요. stream_radar.flag_created에는 두 경우를 구분할 수 있도록 transition 필드가 추가돼요.
transition | 의미 |
|---|---|
published | 완전히 새로운 플래그가 올라왔어요. |
reopened | 기존에 있던, 이전에 해결된 플래그가 다시 활성화됐어요. |
지원 범위
섹션 제목: “지원 범위”Stream Radar는 현재 Spotify를 모니터링해요. Spotify에서 온 플래그는 dsp가 spotify로 설정돼요. 지원 범위는 시간이 지나면서 추가되는 방식으로 확장돼요. 더 많은 플랫폼이 추가되면 새 플래그에 새로운 dsp 값으로 나타나며, 이미 처리하고 있는 플래그에 대해서는 아무것도 바뀌지 않아요. 도구를 특정 플랫폼으로 한정하고 싶다면 filter[dsp]로 필터링하세요.
트랙에 플래그가 표시되면 할 일
섹션 제목: “트랙에 플래그가 표시되면 할 일”플래그는 결론이 아니라 살펴보라는 신호예요. 플래그가 들어오면 다음을 확인하세요.
- 최근 프로모션을 확인하세요. 이 트랙을 최근에 플레이리스트 서비스나 마케팅 캠페인, 또는 프로모터를 통해 푸시했나요? 서드파티 프로모션은 인위적 스트리밍의 가장 흔한 원인이며, 회원님이나 아티스트가 아니라 판매자가 원인인 경우가 많아요.
- 아티스트와 이야기하세요. 트랙을 홍보하기 위해 무엇을 했는지 물어보세요. 아티스트는 자신이 비용을 지불한 서비스를 늘 언급하지는 않으며, “스트림 보장” 같은 제안이 위험 신호라는 것을 모를 수도 있어요.
- 확인할 수 없는 캠페인은 일시 중지하세요. 정당하다고 확인할 수 없는 프로모션이 진행 중이라면, 일시 중지하면 조사하는 동안 패턴이 커지는 것을 막을 수 있어요. 감지가 멈추면 플래그는 저절로 해결돼요.
플래그에 일찍 대응하는 것이 Stream Radar의 핵심이에요. 플랫폼이 먼저 수수료나 테이크다운, 계정 제재를 적용하는 것보다, 잘못된 프로모션을 회원님이 직접 잡아내 되돌리는 것이 훨씬 나아요.
Stream Radar에 대해 궁금한 점이 있으신가요? 저희 팀에 문의하세요. 기꺼이 도와드릴게요.