Rehber

Spotify dinlenme sayısı API'si: kimlik veya ISRC ile her şarkının toplam dinlenmesi

Spotify'ın Web API'si bir şarkının kaç kez dinlendiğini hiçbir zaman söylemez. En yakını popülerliktir: kendi referansının çoğunlukla toplam dinlenmeye dayandığını belirttiği, 0–100 arası bir puan; üstelik kullanımdan kaldırılmış olarak işaretli. Bu uç noktalar sayının kendisini döndürür: Spotify kimliği veya ISRC ile tek bir şarkıyı ya da tek çağrıda en fazla 50 şarkıyı.

Yazan: Eduardo Airaudo, API'nin bakımcısı · Güncelleme: 22 Ekim 2026

Resmî şarkı nesnesinin dışarıda bıraktıkları

Spotify Web API'sindeki GET /v1/tracks/{id} uç noktası; albümü, sanatçıları, duration_ms, explicit, external_ids, adı, popularity ve birkaç alanı daha döndürür. Hiçbiri dinlenmeyi saymaz. En yakını popülerliktir: Spotify'ın referansı bunu, bir şarkının kaç kez dinlendiğine ve bu dinlenmelerin ne kadar yeni olduğuna göre çoğunlukla hesaplanan 0 ile 100 arası bir değer olarak verir ve kullanımdan kaldırılmış olarak işaretler. Spotify'ın Şubat 2026 değişiklikleri, 11 Şubat 2026'dan itibaren oluşturulan geliştirme modundaki uygulamalar için bunu kaldırdı.

Bir puan, bir sayının yaptığını yapamaz. Göreli olduğu için bir albüm ya da katalog boyunca toplanmaz ve yakın dinlenmeleri öne çıkarır — aynı referans, şu anda çok dinlenen şarkıların geçmişte çok dinlenenlerden daha yüksek puan aldığını söyler — bu yüzden bir şarkının şimdiye kadar kaç kez dinlendiğini söyleyemez.

Şemanın ifadesiyle, bu API'nin Partner grubu “Spotify's internal (pathfinder) data, including play counts”. /partner/track/count tek bir şarkının toplam sayısını, /partner/tracks/count en fazla 50 şarkının sayısını aynı anda döndürür; /partner/track ise bunu tam şarkı kaydının içinde taşır.

Ne döner

Alan alan, şemanın yanıt şemalarında tanımladığı gibi. Tek şarkı çağrısı sayıya streams, toplu çağrı ise playcount adını verir.

Tek şarkı

GET /partner/track/count

streams
Toplam dinlenme sayısı, tamsayı olarak (int64). Şemada null olabilir ve 1.000'in altında dinlenen bir şarkı için 0'dır.
spotify_track_id
Şarkının Spotify kimliği.
isrc
Şarkının ISRC'si. Şemada null olabilir.
result
success veya error; yanında kısa bir message.

Toplu çağrı

GET /partner/tracks/count

tracks[]
İstenen her kimlik için bir giriş, istek sırasıyla.
tracks[].playcount
Toplam dinlenme (int64, null olabilir); 1.000'in altındaki bir şarkı için 0.
tracks[].status
ok, not_found veya error; durum error olduğunda bir error metni de gelir.
tracks[].name
Şarkının adı; bulunamadığında null.
tracks[].artists[]
Her sanatçının id ve name alanları.
tracks[].releaseDate
Şarkının albümünün yayın tarihi: YYYY-MM-DD ya da daha kaba bir hassasiyet.
missing[]
Durumu ok olmayan, istenen kimlikler.

0, hiç dinlenmedi değil, 1.000'in altı demektir. Şema, Spotify'ın 1.000'den az dinlenen şarkılar için 0 bildirdiğini söyler; bu yüzden 0'ı bir sayı olarak değil, “1.000'in altında” olarak saklayın.

Kayıtlı örnek · alınma tarihi: 2026-10-22

GET /partner/track/count

6 satır — kaydedilen gövdenin tamamı.

Kayıtlı örnek · alınma tarihi: 2026-10-22

GET /partner/tracks/count

18 satır — kaydedilen gövdenin tamamı.

Tek şarkı ya da çağrı başına 50

  • GET /partner/track/countTrack play count

    Lifetime play count of one track, by Spotify id (spotify_track_id, or its alias id) or by isrc. Spotify reports 0 for tracks with fewer than 1,000 plays. Play counts are cached for 1 hour; for many tracks use /partner/tracks/count.

    Parametrelerspotify_track_id, id, isrc, cache

  • GET /partner/tracks/countTrack play counts (batch)

    Lifetime play counts for up to 50 tracks in one call. Entries come back in request order with status ok, not_found or error; ids without a play count are also listed in missing. Each id is cached for 1 hour.

    Parametrelerids, cache

  • GET /partner/trackPartner track data

    Track with its play count (data.trackUnion.playcount), album, artists and content ratings. Add slim=1 to keep only {id, uri, profile.name, visuals.avatarImage} of each artist (the full payload embeds the first artist's discography and is ~100 KB).

    Parametrelerid, slim, cache

/partner/tracks/count, virgülle ayrılmış en fazla 50 kimlik alır ve gönderdiğiniz sırayla yanıtlar; böylece 50 şarkı, 50 istek yerine tek istek tutar.

Dinlenme sayılarını alın

Spotify kimliğiyle tek şarkı

Kimlik, herhangi bir Spotify URL'sinde /track/ ifadesinden sonra gelen 22 karakterlik dizedir. Bir şarkıyı ISRC'siyle sorgulamak için id= yerine isrc= gönderin.

Tek çağrıda en fazla 50 şarkı

Sayısından önce her girişin status alanını okuyun. Girişler kimliklerin sırasıyla döner; dinlenme sayısı olmayan bir giriş onun yerine not_found veya error olarak işaretlenir ve missing içinde yeniden listelenir.

Kod yazmadan dinlenme sayıları

Sayılar kendi kodunuz için değil de bir elektronik tablo içinse, aynı bakımcının iki Apify actor'ı bunları veri kümesi olarak döndürür. Bir çalıştırma için Apify hesabı gerekir, API anahtarı gerekmez: bağlantıları yapıştırır, JSON veya CSV indirirsiniz.

  • Spotify Play Count Scraper (yeni sekmede açılır)eduair94/spotify-play-count-scraper

    Şarkı, albüm, sanatçı veya çalma listesi bağlantılarını, URI'lerini ya da kimliklerini yapıştırın; şarkı başına bir satır döndürür, dinlenme sayısıyla birlikte — bir sanatçının en çok dinlenen şarkıları ya da tüm diskografisi, bir albümdeki veya çalma listesindeki her şarkı — ve istenirse sanatçının aylık dinleyicilerini içeren bir satır.

  • Spotify Scraper (yeni sekmede açılır)eduair94/spotify-scraper

    Genel actor: 61 kategori, bunların 5 tanesi dinlenme sayısı (track_play_count, album_play_counts, artist_play_counts, artist_discography_play_counts, playlist_play_counts) ve bir şarkıyı ISRC'siyle dinlenme sayısıyla birlikte bulan isrc.

İkisi de tarihinde listelenen fiyatlarla sonuç başına faturalandırılır: Apify'ın ücretsiz planında satır başına $0.001, Gold ve üstünde ise satır başına $0.0006. Bir çalıştırmanın ne zaman bir anahtardan iyi olduğu, ne zaman olmadığı scraper rehberi içinde.

Hazır tutulan bir geçmiş: spotify-most-streamed-songs (opens in a new tab) on GitHub has daily play counts and daily streams for 1,000 of the most-streamed songs, as CSV and JSON history.

Bir yapay zekâ asistanından kullanın (MCP): Claude, Cursor veya VS Code'dan bir şarkının dinlenmesini isteyin; Spotify MCP sunucusunun get_track_play_count aracı bu API'den toplam dinlenme sayılarını döndürür. MCP sunucusunu kurun.

Sorular

Spotify Web API dinlenme sayısı döndürür mü?

Hayır. Web API referansındaki şarkı nesnesinde dinlenme sayısı alanı yok. En yakın alanı olan popülerlik, Spotify'ın çoğunlukla toplam dinlenmeden ve bunların ne kadar yeni olduğundan hesapladığı 0–100 arası bir puandır; referans bunu kullanımdan kaldırılmış olarak işaretler ve Spotify'ın Şubat 2026 değişiklikleri onu 11 Şubat 2026'dan itibaren oluşturulan geliştirme modundaki uygulamalar için kaldırdı.

Bir şarkı neden 0 dinlenme gösteriyor?

Çünkü 1.000'den azdır. Şema, Spotify'ın 1.000'den az dinlenen şarkılar için 0 bildirdiğini söyler; yani 0, hiç dinlenmedi değil, 1.000'in altı demektir.

Birçok şarkının dinlenme sayısını aynı anda alabilir miyim?

Evet. GET /partner/tracks/count, virgülle ayrılmış en fazla 50 şarkı kimliği alır ve istek sırasıyla yanıtlar; her giriş ok, not_found veya error durumuyla gelir; dinlenme sayısı olmayan kimlikler ayrıca missing içinde listelenir. 50 şarkı, 50 istek yerine tek istek tutar.

Bir şarkıyı ISRC ile sorgulayabilir miyim?

Evet. GET /partner/track/count, Spotify kimliği yerine isrc alır; bu yüzden ISRC ile anahtarlanmış bir katalog için önce kimlik sorgusu gerekmez.

Sayı ne kadar güncel?

Dinlenme sayıları bir saat önbelleğe alınır, yani bir sayı genellikle en fazla o kadar eskidir. X-Cache değeri STALE veya FALLBACK ile başlıyorsa canlı çekim yavaş olduğu ya da başarısız olduğu için daha eski bir kopya sunulmuştur; X-Cache-Stale-Age bunun yaşını saniye olarak verir. Yeni bir kopya çekmek için cache=false ekleyin. Bu sitedeki Çalıştır düğmeleri de demonun kendi önbelleğinden geçer, bu yüzden oradaki rakam daha eski olabilir.

Kod yazmadan dinlenme sayılarını alabilir miyim?

Evet, Apify'da: bir çalıştırma için Apify hesabı gerekir, API anahtarı gerekmez. Spotify Play Count Scraper (eduair94/spotify-play-count-scraper) şarkı, albüm, sanatçı veya çalma listesi bağlantılarını alır ve şarkı başına bir satırı dinlenme sayısıyla döndürür; Spotify Scraper (eduair94/spotify-scraper), 61 kategorisi arasında 5 dinlenme sayısı kategorisine sahiptir. İkisi de sonuç başına faturalandırılır.

Hangi plana ihtiyacım var?

Herhangi biri. Her iki dinlenme sayısı uç noktası, 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

More guides

What changed in the API and on these pages, and when: What's new.

Bir anahtar alın ve ilk dinlenme sayınızı çekin

Her iki dinlenme sayısı uç noktası, RapidAPI ve doğrudan portal dahil her plandadır; Apify'da yukarıdaki iki actor aynı sayıları veri kümesi satırları olarak döndürür, sonuç başına faturalandırılır. RapidAPI'nin ücretsiz katmanı ayda 1.000 istektir: çağrı başına en fazla 50 şarkıyla, en fazla 50.000 dinlenme sayısı.

RapidAPI Apify Doğrudan Portal

Satın almaya hazır değil misiniz? Ücretsiz deneme anahtarı alın: 7 günde 500 istek, kart yok.