Rehber
Spotify aylık dinleyici API'si: sanatçı başına dinleyici, takipçi, dünya sırası ve en çok dinlenen şehirler
Spotify uygulamasında her sanatçının adının altındaki sayı — aylık dinleyiciler — Web API'de yok. Resmî sanatçı nesnesi en fazla bir takipçi sayısı ve 0–100 arası bir popülerlik puanı taşır; kitleyle ilgili başka hiçbir şey yok. Spotify ikisini de kullanımdan kaldırılmış olarak işaretledi ve 11 Şubat 2026'dan itibaren oluşturulan geliştirme modundaki uygulamalar için kaldırdı. Buradaki tek çağrı; dinleyicileri, takipçileri, bir dünya sırasını ve sanatçının en çok dinlendiği beş şehri döndürür.
Yazan: Eduardo Airaudo, API'nin bakımcısı · Güncelleme: 22 Ekim 2026
Resmî sanatçı nesnesinin dışarıda bıraktıkları
Spotify Web API'sindeki GET /v1/artists/{id} uç noktası; followers.total, bir popularity tamsayısı, türler, görseller ve bir ad döndürür — ilk üçü kullanımdan kaldırılmış olarak işaretli; takipçi ve popülerlik ise 11 Şubat 2026'dan itibaren oluşturulan geliştirme modundaki uygulamalar için kaldırıldı. Aylık dinleyiciler — Spotify'ın sanatçı sayfasına koyduğu ve plak şirketlerinin, menajerlerin ve çalma listesi önerenlerin gerçekten takip ettiği rakam — referansın hiçbir yerinde yok ve hiçbir kapsam bunu eklemiyor.
Popülerlik, Spotify'ın son dinlenmelerden yeniden hesapladığı göreli ve opak bir puandır; dinleyiciye çevrilemez, aylar arasında karşılaştırılamaz, bir müşteriye açıklanamaz. Aylık dinleyiciler ise bir yayınla, bir senkron yerleşimiyle ya da bir çalma listesi eklemesiyle hareket eden mutlak bir sayıdır; insanların istediği sayı da bu yüzden odur.
Buradaki /artist_overview, sanatçı sayfasını uygulamanın oluşturduğu hâliyle, kitle bloğu dahil döndürür. Aynı çağrı diskografiyi, benzer sanatçıları ve sabitlenmiş öğeleri de taşır; böylece kitle rakamları, onları okumak için gereken bağlamla birlikte gelir.
Ne döner
Arijit Singh (4YRxDV8wJFPHPTeXepOstw) için 2026-10-22 tarihinde alınan kayıtlı /artist_overview yanıtından okunmuştur. Kaydın tamamı uç noktanın kendi sayfasındadır.
- stats.monthlyListeners
- Sanatçı sayfasındaki kitle rakamı: son 28 günde farklı dinleyiciler, tamsayı olarak. Kayıtta 53.500.280.
- stats.followers
- Takipçi sayısı. Spotify bunu kendi sanatçı nesnesinden, 11 Şubat 2026'dan itibaren oluşturulan geliştirme modundaki uygulamalar için kaldırdı; genişletilmiş kotalı uygulamalar hâlâ alır. Kayıtta 195.766.074.
- stats.worldRank
- Sanatçının Spotify'ın dinleyiciye göre küresel sıralamasındaki yeri — kayıtta 56. Sıralanan kümenin dışındaki sanatçılar için yoktur.
- stats.topCities.items[]
- city, region, country ve numberOfListeners alanlarından oluşan beş satır. Kayıt, 4.174.171 dinleyiciyle Pune, IN ile açılır, ardından Delhi, New Delhi, Mumbai ve Bengaluru gelir.
- profile.name
- Görünen ad. Kayıt ayrıca biyografiyi, bir externalLinks listesini (bu sanatçı için boş), sabitlenmiş öğeyi ve sanatçının kendi çalma listelerini profile altında taşır; doğrulanmış işareti yoktur.
- discography, relatedContent
- Son yayın, albümler, single'lar, yer aldığı yayınlar ve benzer sanatçılar bloğu, aynı yanıtta — tek çağrı sanatçı sayfasının tamamını kapsar.
53.500.280
stats.monthlyListeners
195.766.074
stats.followers
#56
stats.worldRank
Tek bir kayıttan üç rakam, 2026-10-22. Şeklin somutlaşması için gösterilir, güncel rakam olarak değil — bugünküleri görmek için uç nokta sayfasında Çalıştır'a basın.
Tek sanatçı, 10 sanatçı ya da bir sıralama
- Artist overviewGET /artist_overview
- Artist overview (batch)GET /artist_overview_batch
- Most-listened artists (monthly listeners)GET /top_20_by_monthly_listeners
- Most-followed artistsGET /top_20_by_followers
/artist_overview_batch, virgülle ayrılmış en fazla 10 kimlik alır ve sanatçı başına aynı nesneyi döndürür; böylece 10 sanatçı, 10 istek yerine tek istek tutar.
Şemanın ifadesiyle, /top_20_by_monthly_listeners: “Wikipedia's list of the most-streamed artists on Spotify: up to 50 rows of {rank, artist, monthlyListeners}, where monthlyListeners is in millions (129.8 means 129,800,000). Not country-specific”; /top_20_by_followers: “Wikipedia's list of the most-followed artists on Spotify (followers in millions). Not country-specific”. İkisi de parametre almaz.
2026-10-22 tarihinde alınan kayıtlı dinleyici yanıtı, rank, artist ve milyon cinsinden monthlyListeners alanlarından oluşan 50 satır içerir — ilk satırda Bruno Mars, 128,6 ile yer alır.
Bir sanatçının kitle rakamlarını alın
| curl -X GET \ |
| "https://spotify-proxy.checkleaked.cc/spotify-data/artist_overview?id=4YRxDV8wJFPHPTeXepOstw" \ |
| -H "x-rapidapi-key: $SPOTIFY_API_KEY" |
Kimlik, herhangi bir Spotify URL'sinde /artist/ ifadesinden sonra gelen 22 karakterlik dizedir. Elinizde ad mı var? /search?q=&type=artists kimliği döndürür.
Rakamı zaman içinde izleme
Spotify yalnızca tek bir güncel değer yayımlar, geçmiş değil. Zaman serisini kurmak size kalır: /artist_overview uç noktasını zamanlanmış olarak çağırın, stats.monthlyListeners değerini zaman damgasıyla saklayın ve satırlar arasındaki farkı alın. 25 sanatçılık bir kadro için günlük iş, günde 3 toplu istektir — ayda 90 istek, ücretsiz katmanın 1.000 sınırı içinde.
Geçmişi API'nin tutmasını istiyorsanız /tracking/track?spotifyType=artist&spotifyId= sanatçıyı kaydeder; monthly_listeners_change ve followers_change satırları, sorguladığınız /tracking/logs içinde birikir. Webhook'lar yalnızca çalma listesi değişikliklerini kapsar. İkisi de referansta Tracking altındadır; operasyonel uç noktalardır, bu yüzden bu sitedeki demo bunları çalıştırmaz.
Kod yazmadan: Spotify Monthly Listeners Scraper (opens in a new tab) on Apify returns monthly listeners, followers, world rank and top cities for any artist. spotify-monthly-listeners (opens in a new tab) on GitHub has daily monthly listeners, followers and world rank for 500 artists, as CSV and JSON history.
Sorular
Spotify Web API aylık dinleyici döndürür mü?
Hayır. Web API referansındaki sanatçı nesnesi followers.total, popülerlik, türler, görseller ve bir ad listeler. İlk üçü kullanımdan kaldırılmış olarak işaretlidir; takipçi ve popülerlik, 11 Şubat 2026'dan itibaren oluşturulan geliştirme modundaki uygulamalar için kaldırıldı. Aylık dinleyiciler Spotify'ın kendi istemcilerinde gösterilir ama belgelenmiş API'nin parçası değildir ve hiçbir OAuth kapsamı bunu açmaz.
Sayı ne kadar güncel?
Sanatçı özetleri yaklaşık bir saat önbelleğe alınır; bu yüzden bir yanıt Spotify uygulamasındaki rakamın en fazla o kadar gerisinde kalabilir. Yeniden çekmeyi zorlamak için cache=false ekleyin; X-Cache başlığı her yanıtın nasıl sunulduğunu söyler. Bu sitedeki Çalıştır düğmeleri de demonun kendi önbelleğinden geçer, bu yüzden oradaki rakam daha eski olabilir.
Birçok sanatçının aylık dinleyicisini aynı anda alabilir miyim?
Evet. GET /artist_overview_batch, virgülle ayrılmış en fazla 10 sanatçı kimliği alır ve her biri için aynı özet nesnesini döndürür; böylece 10 sanatçı tek istek tutar. GET /artists?ids= de bir liste alır ama Spotify'ın kendi sanatçı nesnesini döndürür: aylık dinleyici yok, birçok sanatçı için takipçi sayısı da yok.
worldRank küresel bir konum mu?
Spotify'ın sanatçı sayfasında kendisinin gösterdiği sıradır (burada kullanılan kayıtta “#56 in the world”). Sıralanan kümenin dışındaki sanatçılarda worldRank alanı yoktur; bu yüzden isteğe bağlı sayın.
En çok dinlenen şehirler nedir?
stats.topCities.items, sanatçının en çok dinleyiciye sahip olduğu beş şehri listeler; her biri city, region, country ve numberOfListeners içerir. Sanatçı sayfasının Hakkında bölümünde gösterdiği bloğun aynısıdır.
Bir sanatçının aylık dinleyici geçmişini alabilir miyim?
Spotify'dan alamazsınız; o yalnızca güncel değeri yayımlar. Sayıyı zamanlanmış olarak saklarsanız o günden itibaren geçmişiniz olur; 25 sanatçı için günde 3 toplu çağrı ayda 90 istek tutar.
Hangi plana ihtiyacım var?
Herhangi biri. Bu rehberin kullandığı uç noktalar, RapidAPI ve doğrudan portal dahil her plandadır; planlar aylık hacimle ayrılır. Her RapidAPI planı saniyede 5 isteğe izin verir ve her doğrudan anahtar saniyede 10 istek içerir. RapidAPI'nin ücretsiz planı ayda 1.000 isteğe izin verir.
Kaynaklar
- Get Artist — Spotify Web API referansı — resmî sanatçı nesnesi: takipçi, popülerlik ve türler kullanımdan kaldırılmış olarak işaretli; aylık dinleyici alanı yok.
- Şubat 2026 değişiklikleri — Spotify for Developers referansı — sanatçı takipçisi ve popülerliği, 11 Şubat 2026'dan itibaren oluşturulan geliştirme modundaki uygulamalar için kaldırıldı.
- Bu sitede GET /artist_overview — bu sayfanın okuduğu kayıtlı yanıt, tamamı ve alınma tarihiyle.
- Bu sitede GET /top_20_by_monthly_listeners — platform sıralaması, kendi kaydıyla.
More guides
- Spotify Web API alternativeEndpoint-by-endpoint mapping from the official API, including everything Spotify removed on 27 November 2024.
- Spotify API without OAuthOne header instead of the client-credentials flow — and the things a key genuinely cannot do.
- Spotify lyrics APIWhy the Web API has no lyrics endpoint, and how to get line-synced lyrics as JSON, LRC or SRT.
- Spotify charts APIDaily Top 200 and viral charts as JSON: rank movement, stream counts, credits, and how to backfill.
- Spotify play count APILifetime streams for any track, by Spotify id or ISRC, one or a batch per call — and why a 0 means under 1,000.
- Spotify audio features API after the 2024 deprecationTempo, energy, danceability, recommendations and related artists after Spotify removed them for new apps.
- Spotify API rate limitsThe official 30-second rolling window, what each plan here allows per second and per month, and how to stay under it.
- Spotify scraper on ApifyPlay counts, charts, lyrics and credits as a scheduled run with no API key — and when an API key is the better tool.
- Spotify MCP serverPlay counts, monthly listeners and charts inside Claude, Cursor or VS Code: an open-source MCP server that runs with your own key.
What changed in the API and on these pages, and when: What's new.
Bir anahtar alın ve ilk sanatçınızı çekin
Üçünde de aynı uç noktalar, farklı fiyatlarla. RapidAPI'nin ücretsiz katmanı ayda 1.000 istektir — bir kadroyu her gün izlemeye yeter.
Satın almaya hazır değil misiniz? Ücretsiz deneme anahtarı alın: 7 günde 500 istek, kart yok.