Stream Radar

Stream Radar, API dağıtım hesapları için isteğe bağlı, ücretli bir eklentidir. Kataloğunuzu yapay akışla tutarlı akış desenlerine karşı izler ve dikkat gerektiren parçaları işaretler; bunu, sorun bir DSP ücretine, bir kaldırmaya (takedown) ya da hesabınıza karşı bir yaptırıma dönüşmeden önce harekete geçebilmeniz için yeterince erken yapar.

Bir Stream Radar işareti, bir karar değil, erken bir uyarı sinyalidir. Yapay akışın çoğu, iyi niyetle satın alınan üçüncü taraf tanıtımlara dayanır: dinlenmeleri yapay olarak şişirdiği sonradan anlaşılan bir playlist tanıtımı ya da bir pazarlama hizmeti. Bir işaret, neler olduğunu bir platform harekete geçtiğinde öğrenmek yerine, durumu kontrol edip kendi koşullarınızda yanıt verme fırsatı tanır.

Stream Radar, işaretlerini herkese açık API üzerinden sunar; böylece bunları kendi panolarınıza, uyarı sistemlerinize ve inceleme iş akışlarınıza çekebilirsiniz.

Stream Radar nedir

Hesabınızda Stream Radar etkinken, LabelGrid, dağıtılmış kataloğunuzu yapay akışla tutarlı akış desenlerine karşı izler. Bir parça, bir platformda böyle bir desen gösterdiğinde Stream Radar bir işaret oluşturur: API üzerinden okuyabileceğiniz, hangi parçanın hangi platformda incelenmesi gerektiğini bildiren bir kayıt.

Her işaret; etkilenen parçayı ve platformu, önceliklendirmenize yardımcı olacak bir önem derecesini ve kaç dinlenmenin söz konusu olduğuna dair bir tahmini belirtir; böylece hızlıca eleyip önem taşıyanları derinlemesine inceleyebilirsiniz.

Stream Radar yalnızca, üzerine harekete geçebileceğiniz bilgiyi ortaya çıkarır. Bir işaretle ne yapacağınız (bir kampanyayı kontrol etmek, sanatçıyla konuşmak, bir tanıtımı duraklatmak) size kalmıştır.

Stream Radar’ı nasıl edinirsiniz

Stream Radar, ekibimizin hesap bazında etkinleştirdiği ücretli bir eklentidir. Açmak için satış ekibimizle iletişime geçin ve Stream Radar istediğinizi belirtin.

Etkinleştirilene kadar, Stream Radar uç noktaları şunu döndürür:

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

HTTP 403 durumuyla birlikte. Eklenti etkin olduğunda, aynı uç noktalar işaretlerinizi döndürmeye başlar.

API’yi kullanma

Stream Radar iki okuma uç noktası sunar; ikisi de herkese açık LabelGrid API’sinin geri kalanıyla aynı Bearer belirteci kimlik doğrulamasını kullanır. Tam ve her zaman güncel istek ve yanıt şemaları için API başvurusuna bakın.

İşaretleri listeleme

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

Hesabınızın işaretlerini, en yeni tespit önce olacak şekilde döndürür. Yanıt sayfalandırılmıştır:

Parametre	İşlevi
page	Döndürülecek sonuç sayfası.
per_page	Sayfa başına sonuç sayısı, en fazla 100.

Listeyi şu filtrelerden herhangi biriyle daraltabilirsiniz:

Filtre	Değerler
filter[status]	active veya resolved.
filter[severity]	low, medium veya high.
filter[dsp]	Bir platform tanımlayıcısı (örneğin spotify).
filter[isrc]	Tek bir kaydın işaretlerini görmek için bir ISRC.
filter[release_id]	Bir yayın genelindeki işaretleri görmek için bir yayın ID’si.
filter[detected_from]	Başlangıç tarihi (YYYY-MM-DD), bir işaretin son tespit tarihine göre eşleştirilir.
filter[detected_to]	Bitiş tarihi (YYYY-MM-DD), bir işaretin son tespit tarihine göre eşleştirilir.

Örneğin, bu ay tespit edilen açık, yüksek önem dereceli işaretleri çekmek için:

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

Tek bir işareti alma

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

Bir işareti id değerine göre döndürür. Başka bir hesaba ait bir işaret 404 döndürür; yalnızca kendi işaretlerinizi görürsünüz.

İşaret alanları

Her işaret şunları taşır:

Alan	Size ne söyler
id	İşaretin kararlı tanımlayıcısı.
dsp	Desenin görüldüğü platform (örneğin spotify).
isrc	Söz konusu kaydın ISRC’si.
release_id	Kaydın ait olduğu yayın.
track_id	ISRC, parçalarınızdan birine kesin olarak eşleştiğinde ilgili parça.
severity	Önceliklendirmenize yardımcı olmak için low, medium veya high.
status	Desen sürerken active, durduğunda resolved.
first_detected_at	Desenin bu parça ve platform için ilk görüldüğü an.
last_detected_at	En son tespit.
estimated_affected_streams	Ölçeği değerlendirmek için, kaç dinlenmenin söz konusu olduğuna dair bir tahmin.
published_at	İşaretin size ilk bildirildiği an.
resolved_at	İşaretin çözüldüğü an ya da hâlâ etkinken null.

Bir işaretin zaman içindeki davranışı

Stream Radar, parça başına ve platform başına tek bir işaret tutar; böylece bir parçanın belirli bir platformdaki geçmişi birçok parçaya bölünmek yerine tek bir kayıtta kalır:

• Tekrarlanan tespitler aynı işareti uzatır. Bir desen görünmeye devam ettikçe last_detected_at değeri ilerler ve işaret active kalır; id değişmez.
• Tespitler durduğunda bir işaret otomatik olarak çözülür. Desen artık görülmediğinde işaret resolved durumuna geçer ve resolved_at değeri ayarlanır. Onu kendiniz kapatmanıza gerek yoktur.
• Yeni bir tespit aynı işareti yeniden açar. Desen, bir işaret çözüldükten sonra geri dönerse, yeni bir işaret oluşturulmak yerine aynı işaret (aynı id) yeniden active olur.

Bu, bir işaretin id değerine, bir parça-ve-platform durumunun tüm yaşamı boyunca kalıcı bir tanıtıcı olarak güvenebileceğiniz anlamına gelir.

Webhook’lar

İşaretleri sürekli sorgulamak yerine, bir işaret değiştiği anda LabelGrid’in size bir bildirim göndermesini sağlayabilirsiniz. LabelGrid’in diğer webhook olaylarına abone olduğunuz gibi, uygulamadaki webhook ayarlarınızdan veya API üzerinden abone olun. Stream Radar iki olay tetikler:

Olay	Ne zaman tetiklenir
stream_radar.flag_created	Bir işaret ilk kez oluşturulduğunda ya da çözülmüş bir işaret yeni bir tespitle yeniden açıldığında.
stream_radar.flag_resolved	Tespitler durduğu için bir işaret çözüldüğünde.

Her payload, işaretin kendisiyle aynı alanları taşır; işareti flag_id belirtir. stream_radar.flag_created, iki durumu birbirinden ayırt edebilmeniz için bir transition alanı ekler:

transition	Anlamı
published	Yepyeni bir işaret oluşturuldu.
reopened	Mevcut, daha önce çözülmüş bir işaret yeniden etkin oldu.

Not

Webhook teslimatı en iyi çaba (best-effort) esasına dayanır. Listeleme ve tek işaret uç noktalarını gerçek kaynak olarak kabul edin ve webhook’ları, her değişikliğin garantili ve eksiksiz bir kaydı olarak değil, mevcut durumu okumak için bir uyarı olarak kullanın.

Kapsam

Stream Radar şu anda Spotify’ı izler; Spotify’dan gelen bir işaretin dsp değeri spotify olur. Kapsam zaman içinde eklemeli olarak genişler: daha fazla platform eklendikçe bunlar yeni işaretlerde yeni dsp değerleri olarak görünür ve hâlihazırda ele aldığınız işaretlerle ilgili hiçbir şey değişmez. Araçlarınızı belirli bir platformla sınırlamak isterseniz filter[dsp] üzerinden filtreleyin.

Bir parça işaretlendiğinde ne yapmalısınız

Bir işaret, bir sonuç değil, bakmanız için bir uyarıdır. Bir işaret geldiğinde:

• Son zamanlardaki tanıtımı kontrol edin. Bu parça yakın zamanda bir playlist hizmeti, bir pazarlama kampanyası veya bir tanıtımcı aracılığıyla mı öne çıkarıldı? Üçüncü taraf tanıtım, yapay akışın en yaygın kaynağıdır ve çoğu zaman neden, siz veya sanatçı değil, satıcıdır.
• Sanatçıyla konuşun. Parçayı tanıtmak için neler yaptığını sorun. Sanatçılar, ödeme yaptıkları bir hizmetten her zaman söz etmez ve bir “garantili dinlenme” teklifinin bir tehlike işareti olduğunu fark etmeyebilirler.
• Doğrulayamadığınız kampanyaları duraklatın. Meşru olduğunu doğrulayamadığınız bir tanıtım yürüyorsa, onu duraklatmak, siz konuyu araştırırken desenin büyümesini durdurur. Tespitler durduğunda işaret kendi kendine çözülür.

Bir işarete erken müdahale etmek, Stream Radar’ın asıl amacıdır: kötü bir tanıtımı bir platform önce bir ücret, bir kaldırma ya da bir hesap yaptırımı uygulamadan kendiniz yakalayıp geri almanız çok daha iyidir.

---

Stream Radar hakkında sorularınız mı var? Ekibimizle iletişime geçin. Yardımcı olmaktan memnuniyet duyarız.