Panduan
API jumlah pemutaran Spotify: total stream untuk lagu mana pun, lewat ID atau ISRC
Web API Spotify tidak pernah menyebutkan berapa kali sebuah lagu diputar. Yang paling mendekati adalah popularity, skor 0–100 yang menurut referensinya sendiri didasarkan terutama pada total pemutaran, dan ditandai deprecated. Endpoint-endpoint ini mengembalikan jumlahnya itu sendiri: satu lagu lewat ID Spotify atau ISRC, atau hingga 50 lagu dalam satu panggilan.
Oleh Eduardo Airaudo, pengelola API · Diperbarui 22 Oktober 2026
Apa yang tidak ada di objek lagu resmi
GET /v1/tracks/{id} di Spotify Web API mengembalikan album, artis, duration_ms, explicit, external_ids, nama, popularity, dan beberapa lainnya. Tidak satu pun menghitung pemutaran. Popularity yang paling dekat: referensi Spotify memberinya sebagai nilai 0 sampai 100, dihitung terutama dari berapa kali sebuah lagu diputar dan seberapa baru pemutaran itu, dan menandainya deprecated. Perubahan Spotify pada Februari 2026 menghapusnya untuk aplikasi mode pengembangan yang dibuat sejak 11 Februari 2026.
Skor tidak bisa melakukan apa yang dilakukan jumlah. Skor itu relatif, jadi tidak bisa dijumlahkan di seluruh album atau katalog, dan condong ke pemutaran terbaru — referensi yang sama menyebut lagu yang banyak diputar sekarang mendapat skor lebih tinggi daripada lagu yang banyak diputar di masa lalu — sehingga tidak bisa menyebutkan berapa kali sebuah lagu pernah diputar.
Menurut kata-kata spesifikasinya, grup Partner API ini adalah “Spotify's internal (pathfinder) data, including play counts”. /partner/track/count mengembalikan jumlah total satu lagu, /partner/tracks/count untuk hingga 50 lagu sekaligus, dan /partner/track membawanya di dalam catatan lagu lengkap.
Apa yang dikembalikan
Field demi field, sebagaimana didefinisikan skema respons di spesifikasi. Panggilan satu lagu menamai jumlahnya streams; panggilan batch menamainya playcount.
Satu lagu
GET /partner/track/count
- streams
- Jumlah pemutaran total, sebagai bilangan bulat (int64). Nullable di spesifikasi, dan 0 untuk lagu dengan pemutaran di bawah 1.000.
- spotify_track_id
- ID Spotify lagu itu.
- isrc
- ISRC lagu itu. Nullable di spesifikasi.
- result
successatauerror, denganmessagesingkat di sampingnya.
Sebuah batch
GET /partner/tracks/count
- tracks[]
- Satu entri per ID yang diminta, sesuai urutan permintaan.
- tracks[].playcount
- Total pemutaran (int64, nullable); 0 untuk lagu di bawah 1.000.
- tracks[].status
ok,not_found, atauerror, dengan tekserrorbila statusnyaerror.- tracks[].name
- Nama lagu;
nullbila tidak ditemukan. - tracks[].artists[]
iddannametiap artis.- tracks[].releaseDate
- Tanggal rilis album lagu itu: YYYY-MM-DD, atau presisi yang lebih kasar.
- missing[]
- ID yang diminta yang statusnya bukan
ok.
Angka 0 berarti di bawah 1.000, bukan tidak pernah diputar. Spesifikasi menyebut Spotify melaporkan 0 untuk lagu dengan pemutaran kurang dari 1.000, jadi simpan angka 0 sebagai "di bawah 1.000" alih-alih sebagai jumlah.
Sampel rekaman · diambil 2026-10-22
GET /partner/track/count
| { |
| "result": "success", |
| "message": "Data Retrieved.", |
| "spotify_track_id": "7qiZfU4dY1lWllzX7mPBI3", |
| "streams": 5152826895 |
| } |
6 baris — seluruh body rekaman.
Sampel rekaman · diambil 2026-10-22
GET /partner/tracks/count
| { |
| "tracks": [ |
| { |
| "id": "7qiZfU4dY1lWllzX7mPBI3", |
| "name": "Shape of You", |
| "artists": [ |
| { |
| "id": "6eUKZXaKkcviH0Ku9w2n3V", |
| "name": "Ed Sheeran" |
| } |
| ], |
| "playcount": 5152826895, |
| "releaseDate": "2017-03-03", |
| "status": "ok" |
| } |
| ], |
| "missing": [] |
| } |
18 baris — seluruh body rekaman.
Satu lagu, atau 50 per panggilan
- GET /partner/track/countTrack play count
Lifetime play count of one track, by Spotify id (
spotify_track_id, or its aliasid) or byisrc. 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.Parameter
spotify_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
statusok,not_foundorerror; ids without a play count are also listed inmissing. Each id is cached for 1 hour.Parameter
ids, cache - GET /partner/trackPartner track data
Track with its play count (
data.trackUnion.playcount), album, artists and content ratings. Addslim=1to keep only{id, uri, profile.name, visuals.avatarImage}of each artist (the full payload embeds the first artist's discography and is ~100 KB).Parameter
id, slim, cache
/partner/tracks/count menerima hingga 50 ID yang dipisahkan koma dan menjawab sesuai urutan yang Anda kirim, jadi 50 lagu memakan satu permintaan, bukan 50.
Ambil jumlah pemutaran
Satu lagu, lewat ID Spotify
| curl -X GET \ |
| "https://spotify-proxy.checkleaked.cc/spotify-data/partner/track/count?id=0VjIjW4GlUZAMYd2vXMi3b" \ |
| -H "x-rapidapi-key: $SPOTIFY_API_KEY" |
ID adalah string 22 karakter setelah /track/ di URL Spotify mana pun. Untuk mencari lagu lewat ISRC-nya, kirim isrc= sebagai ganti id=.
Hingga 50 lagu dalam satu panggilan
| curl -X GET \ |
| "https://spotify-proxy.checkleaked.cc/spotify-data/partner/tracks/count?ids=0VjIjW4GlUZAMYd2vXMi3b%2C7qiZfU4dY1lWllzX7mPBI3" \ |
| -H "x-rapidapi-key: $SPOTIFY_API_KEY" |
Baca status setiap entri sebelum jumlahnya. Entri kembali sesuai urutan ID; entri tanpa jumlah pemutaran ditandai not_found atau error sebagai gantinya, dan dicantumkan lagi di missing.
Jumlah pemutaran tanpa kode
Jika jumlahnya untuk spreadsheet, bukan untuk kode Anda sendiri, dua actor Apify dari pengelola yang sama mengembalikannya sebagai dataset. Eksekusi butuh akun Apify dan tanpa kunci API: Anda menempel link dan mengunduh JSON atau CSV.
- Spotify Play Count Scraper (terbuka di tab baru)eduair94/spotify-play-count-scraper
Tempel link, URI, atau ID lagu, album, artis, atau playlist; actor ini mengembalikan satu baris per lagu beserta jumlah pemutarannya — lagu teratas atau seluruh diskografi seorang artis, setiap lagu di album atau playlist — dan, bila diminta, satu baris dengan pendengar bulanan artis.
- Spotify Scraper (terbuka di tab baru)eduair94/spotify-scraper
Actor umum: 61 kategori, 5 di antaranya jumlah pemutaran (
track_play_count,album_play_counts,artist_play_counts,artist_discography_play_counts,playlist_play_counts), danisrc, yang menemukan lagu lewat ISRC-nya beserta jumlah pemutarannya.
Keduanya menagih per hasil, dengan harga yang tercantum pada : $0.001 per baris di plan gratis Apify, turun hingga $0.0006 dari Gold ke atas. Kapan eksekusi mengalahkan kunci, dan kapan tidak, ada di panduan scraper.
Riwayat yang sudah tersimpan: 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.
Gunakan dari asisten AI (MCP): minta Claude, Cursor, atau VS Code untuk stream sebuah lagu, dan tool get_track_play_count dari server MCP Spotify mengembalikan jumlah pemutaran total dari API ini. Siapkan server MCP.
Pertanyaan
Apakah Spotify Web API mengembalikan jumlah pemutaran?
Tidak. Objek lagu di referensi Web API tidak punya field jumlah pemutaran. Field terdekatnya, popularity, adalah skor 0–100 yang dihitung Spotify terutama dari total pemutaran dan seberapa baru pemutaran itu; referensi menandainya deprecated, dan perubahan Spotify pada Februari 2026 menghapusnya untuk aplikasi mode pengembangan yang dibuat sejak 11 Februari 2026.
Mengapa sebuah lagu menampilkan 0 pemutaran?
Karena pemutarannya kurang dari 1.000. Spesifikasi menyebut Spotify melaporkan 0 untuk lagu dengan pemutaran kurang dari 1.000, jadi 0 berarti di bawah 1.000, bukan tidak pernah diputar.
Bisakah saya mendapatkan jumlah pemutaran banyak lagu sekaligus?
Bisa. GET /partner/tracks/count menerima hingga 50 ID lagu yang dipisahkan koma dan menjawab sesuai urutan permintaan, setiap entri dengan status ok, not_found, atau error; ID tanpa jumlah pemutaran juga dicantumkan di missing. 50 lagu memakan satu permintaan, bukan 50.
Bisakah saya mencari lagu lewat ISRC?
Bisa. GET /partner/track/count menerima isrc sebagai ganti ID Spotify, jadi katalog yang berkunci ISRC tidak perlu pencarian ID lebih dulu.
Seberapa terbaru angkanya?
Jumlah pemutaran di-cache selama satu jam, jadi umumnya angkanya paling lama setua itu. Nilai X-Cache yang diawali STALE atau FALLBACK berarti salinan yang lebih lama disajikan karena pengambilan live lambat atau gagal; X-Cache-Stale-Age memberi usianya dalam detik. Tambahkan cache=false untuk mengambil yang baru. Tombol Jalankan di situs ini juga melewati cache demo sendiri, jadi angka di sana bisa lebih lama.
Bisakah saya mendapatkan jumlah pemutaran tanpa menulis kode?
Bisa, di Apify: eksekusi butuh akun Apify dan tanpa kunci API. Spotify Play Count Scraper (eduair94/spotify-play-count-scraper) menerima link lagu, album, artis, atau playlist dan mengembalikan satu baris per lagu beserta jumlah pemutarannya; Spotify Scraper (eduair94/spotify-scraper) punya 5 kategori jumlah pemutaran di antara 61 kategorinya. Keduanya menagih per hasil.
Plan mana yang saya butuhkan?
Plan apa pun. Kedua endpoint jumlah pemutaran ada di setiap plan, RapidAPI maupun portal langsung, dan plan hanya berbeda pada volume bulanan. Setiap plan RapidAPI mengizinkan 5 permintaan per detik dan setiap kunci langsung sudah termasuk 10. Plan gratis RapidAPI mengizinkan 1.000 permintaan per bulan.
Sumber
- Get Track — referensi Spotify Web API — objek lagu resmi: tanpa jumlah pemutaran, dan popularity ditandai deprecated.
- Perubahan Februari 2026 — referensi Spotify for Developers — popularity lagu termasuk field yang dihapus.
- Panduan migrasi Februari 2026 — Spotify for Developers — siapa yang terkena penghapusan: aplikasi mode pengembangan, yang baru sejak 11 Februari 2026; aplikasi dengan kuota yang diperluas tidak terpengaruh.
- GET /partner/track/count di situs ini — parameternya, status errornya, dan tombol Jalankan.
- GET /partner/tracks/count di situs ini — panggilan batch, dengan hal yang sama.
- Spotify Play Count Scraper di Apify — jalur tanpa kode: inputnya dan harga per barisnya, sebagaimana dipublikasikan saat ini.
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 monthly listeners APIMonthly listeners, follower counts, world rank and top cities per artist — numbers the Web API never returned.
- 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.
Dapatkan kunci dan ambil jumlah pemutaran pertama Anda
Kedua endpoint jumlah pemutaran ada di setiap plan, RapidAPI maupun portal langsung; di Apify, kedua actor di atas mengembalikan jumlah yang sama sebagai baris dataset, ditagih per hasil. Tier gratis RapidAPI adalah 1.000 permintaan per bulan: dengan hingga 50 lagu per panggilan, hingga 50.000 jumlah pemutaran.
Belum siap membeli? Dapatkan kunci uji coba gratis: 500 permintaan selama 7 hari, tanpa kartu.