Stream Radar

Stream Radar adalah pengaya berbayar opsional untuk akun distribusi API. Pengaya ini memantau katalog Anda untuk pola streaming yang selaras dengan streaming artifisial dan menandai trek yang membutuhkan perhatian, cukup dini bagi Anda untuk bertindak sebelum hal itu berubah menjadi biaya DSP, takedown, atau sanksi terhadap akun Anda.

Sebuah tanda Stream Radar adalah sinyal peringatan dini, bukan vonis. Sebagian besar streaming artifisial berakar pada promosi pihak ketiga yang dibeli dengan itikad baik — sebuah dorongan playlist atau layanan pemasaran yang ternyata menggelembungkan pemutaran secara artifisial. Sebuah tanda memberi Anda kesempatan untuk memeriksa apa yang sedang terjadi dan merespons sesuai ketentuan Anda sendiri, alih-alih baru mengetahuinya ketika sebuah platform bertindak.

Stream Radar mengekspos tanda-tandanya melalui API publik sehingga Anda dapat menariknya ke dasbor, sistem peringatan, dan alur kerja tinjauan Anda sendiri.

Apa itu Stream Radar

Dengan Stream Radar diaktifkan pada akun Anda, LabelGrid mengawasi katalog terdistribusi Anda untuk pola streaming yang selaras dengan streaming artifisial. Ketika sebuah trek menunjukkan pola semacam itu pada suatu platform, Stream Radar memunculkan sebuah tanda: sebuah catatan yang dapat Anda baca melalui API yang memberi tahu Anda trek mana, pada platform mana, yang perlu dicermati.

Setiap tanda menyebutkan trek dan platform yang terpengaruh, sebuah tingkat keparahan untuk membantu Anda menetapkan prioritas, dan perkiraan berapa banyak stream yang terlibat, sehingga Anda dapat memilah dengan cepat dan menelusuri yang benar-benar penting.

Stream Radar hanya memunculkan informasi untuk Anda tindak lanjuti. Apa yang Anda lakukan dengan sebuah tanda — memeriksa sebuah kampanye, berbicara dengan artis, menjeda sebuah promosi — sepenuhnya terserah Anda.

Cara mendapatkan Stream Radar

Stream Radar adalah pengaya berbayar yang diaktifkan per akun oleh tim kami. Untuk mengaktifkannya, hubungi tim penjualan kami dan beri tahu bahwa Anda menginginkan Stream Radar.

Hingga diaktifkan, endpoint Stream Radar mengembalikan:

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

dengan status HTTP 403. Setelah pengaya aktif, endpoint yang sama mulai mengembalikan tanda-tanda Anda.

Menggunakan API

Stream Radar menyediakan dua endpoint baca, keduanya menggunakan autentikasi token Bearer yang sama seperti bagian lain dari API publik LabelGrid. Untuk skema permintaan dan respons yang lengkap dan selalu terkini, lihat referensi API.

Menampilkan daftar tanda

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

Mengembalikan tanda-tanda akun Anda, deteksi terbaru lebih dulu. Respons dipaginasi:

Parameter	Fungsinya
page	Halaman hasil yang akan dikembalikan.
per_page	Hasil per halaman, hingga maksimum 100.

Anda dapat mempersempit daftar dengan salah satu filter berikut:

Filter	Nilai
filter[status]	active atau resolved.
filter[severity]	low, medium, atau high.
filter[dsp]	Pengidentifikasi platform (misalnya, spotify).
filter[isrc]	Sebuah ISRC, untuk melihat tanda pada satu rekaman.
filter[release_id]	Sebuah ID rilis, untuk melihat tanda di seluruh rilis.
filter[detected_from]	Tanggal mulai (YYYY-MM-DD), dicocokkan pada tanggal deteksi terakhir sebuah tanda.
filter[detected_to]	Tanggal akhir (YYYY-MM-DD), dicocokkan pada tanggal deteksi terakhir sebuah tanda.

Sebagai contoh, untuk menarik tanda berkeparahan tinggi yang masih terbuka dan terdeteksi bulan ini:

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

Mengambil satu tanda

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

Mengembalikan satu tanda berdasarkan id-nya. Tanda yang dimiliki akun lain mengembalikan 404 — Anda hanya pernah melihat tanda milik Anda sendiri.

Field tanda

Setiap tanda membawa:

Field	Apa yang diberitahukannya
id	Pengidentifikasi tanda yang stabil.
dsp	Platform tempat pola terlihat (misalnya, spotify).
isrc	ISRC rekaman yang terlibat.
release_id	Rilis tempat rekaman itu berada.
track_id	Trek spesifik, ketika ISRC memetakan secara jelas ke salah satu trek Anda.
severity	low, medium, atau high, untuk membantu Anda menetapkan prioritas.
status	active selama pola berlangsung, resolved setelah berhenti.
first_detected_at	Kapan pola pertama kali terlihat untuk trek dan platform ini.
last_detected_at	Deteksi terbaru.
estimated_affected_streams	Perkiraan berapa banyak stream yang terlibat, untuk mengukur skala.
published_at	Kapan tanda pertama kali dimunculkan kepada Anda.
resolved_at	Kapan tanda terselesaikan, atau null selama masih aktif.

Bagaimana sebuah tanda berperilaku dari waktu ke waktu

Stream Radar menyimpan satu tanda per trek per platform, sehingga riwayat sebuah trek pada suatu platform tetap berada dalam satu catatan alih-alih terpecah menjadi banyak:

• Deteksi berulang memperpanjang tanda yang sama. Selama sebuah pola terus muncul, last_detected_at-nya maju dan tanda tetap active — id-nya tidak berubah.
• Sebuah tanda terselesaikan secara otomatis ketika deteksi berhenti. Begitu pola tidak lagi terlihat, tanda berpindah ke resolved dan resolved_at-nya diatur. Anda tidak perlu menutupnya sendiri.
• Deteksi baru membuka kembali tanda yang sama. Jika pola kembali muncul setelah sebuah tanda terselesaikan, tanda yang sama itu (id yang sama) kembali ke active alih-alih dibuatnya tanda baru.

Ini berarti Anda dapat mengandalkan id sebuah tanda sebagai pegangan yang tahan lama untuk sebuah situasi trek-dan-platform sepanjang masa hidupnya.

Webhook

Alih-alih melakukan polling untuk tanda, Anda dapat meminta LabelGrid mengirimkan notifikasi kepada Anda begitu ada tanda yang berubah. Berlanggananlah dengan cara yang sama seperti Anda berlangganan event webhook LabelGrid lainnya, dari pengaturan webhook Anda di aplikasi atau melalui API. Stream Radar memicu dua event:

Event	Kapan dipicu
stream_radar.flag_created	Sebuah tanda dimunculkan untuk pertama kali, atau tanda yang telah terselesaikan terbuka kembali pada deteksi baru.
stream_radar.flag_resolved	Sebuah tanda terselesaikan karena deteksi berhenti.

Setiap payload membawa field yang sama seperti tanda itu sendiri, dengan flag_id yang menyebut tanda tersebut. stream_radar.flag_created menambahkan field transition sehingga Anda dapat membedakan kedua kasus tersebut:

transition	Arti
published	Sebuah tanda yang benar-benar baru dimunculkan.
reopened	Sebuah tanda yang sudah ada, yang sebelumnya terselesaikan, menjadi aktif kembali.

Catatan

Pengiriman webhook bersifat upaya-terbaik (best-effort). Perlakukan endpoint daftar dan tanda tunggal sebagai sumber kebenaran, dan gunakan webhook sebagai pengingat untuk membaca keadaan saat ini — bukan sebagai catatan yang terjamin dan lengkap atas setiap perubahan.

Cakupan

Stream Radar saat ini memantau Spotify; tanda dari Spotify memiliki dsp yang bernilai spotify. Cakupan berkembang secara aditif dari waktu ke waktu — seiring lebih banyak platform ditambahkan, platform-platform itu muncul sebagai nilai dsp baru pada tanda baru, dan tidak ada yang berubah pada tanda yang sudah Anda tangani. Terapkan filter filter[dsp] jika Anda ingin membatasi perangkat Anda ke platform tertentu.

Yang harus dilakukan ketika sebuah trek ditandai

Sebuah tanda adalah dorongan untuk mencermati, bukan sebuah kesimpulan. Ketika satu tanda masuk:

• Periksa promosi terbaru. Apakah trek ini baru-baru ini didorong melalui layanan playlist, kampanye pemasaran, atau seorang promotor? Promosi pihak ketiga adalah sumber streaming artifisial yang paling umum, dan sering kali penjual — bukan Anda atau artis — yang menjadi penyebabnya.
• Bicaralah dengan artis. Tanyakan apa yang telah mereka lakukan untuk mempromosikan trek tersebut. Artis tidak selalu menyebutkan layanan yang mereka bayar, dan mereka mungkin tidak menyadari bahwa tawaran “stream terjamin” adalah tanda bahaya.
• Jeda kampanye yang tidak dapat Anda verifikasi. Jika ada promosi berjalan yang tidak dapat Anda pastikan keabsahannya, menjedanya menghentikan pola dari terus membesar selagi Anda menyelidikinya. Ketika deteksi berhenti, tanda terselesaikan dengan sendirinya.

Bertindak dini atas sebuah tanda adalah inti dari Stream Radar: jauh lebih baik menangkap dan mengurai sendiri sebuah promosi yang buruk daripada membiarkan sebuah platform lebih dulu menerapkan biaya, takedown, atau sanksi akun.

---

Ada pertanyaan tentang Stream Radar? Hubungi tim kami. Kami dengan senang hati membantu.