Panduan

API kiraan main Spotify: strim sepanjang masa bagi mana-mana lagu, melalui ID atau ISRC

Web API Spotify tidak pernah menyatakan berapa kali sesebuah lagu telah dimainkan. Yang paling hampir ialah popularity, skor 0–100 yang rujukannya sendiri huraikan sebagai berdasarkan terutamanya jumlah main, dan tandakan sebagai deprecated. Endpoint ini mengembalikan kiraan itu sendiri: satu lagu melalui ID Spotify atau ISRC, atau sehingga 50 lagu dalam satu panggilan.

Oleh Eduardo Airaudo, penyelenggara API · Dikemas kini 22 Oktober 2026

Apa yang ditinggalkan oleh objek lagu rasmi

GET /v1/tracks/{id} pada Spotify Web API mengembalikan album, artis, duration_ms, explicit, external_ids, nama, popularity dan beberapa lagi. Tiada satu pun yang mengira main. Popularity yang paling hampir: rujukan Spotify memberikannya sebagai nilai dari 0 hingga 100, dikira terutamanya daripada berapa kali sesebuah lagu dimainkan dan betapa baharunya main itu, dan menandakannya sebagai deprecated. Perubahan Spotify pada Februari 2026 mengeluarkannya untuk aplikasi mod pembangunan yang dicipta dari 11 Februari 2026.

Skor tidak boleh melakukan apa yang dilakukan oleh kiraan. Ia relatif, jadi ia tidak boleh dijumlahkan merentas album atau katalog, dan ia mengutamakan main terkini — rujukan yang sama menyatakan lagu yang banyak dimainkan sekarang mendapat skor lebih tinggi daripada lagu yang banyak dimainkan pada masa lalu — jadi ia tidak boleh menyatakan berapa kali sesebuah lagu pernah dimainkan.

Dalam kata-kata spesifikasi, kumpulan Partner API ini ialah “Spotify's internal (pathfinder) data, including play counts”. /partner/track/count mengembalikan kiraan sepanjang masa bagi satu lagu, /partner/tracks/count bagi sehingga 50 lagu sekali gus, dan /partner/track membawanya di dalam rekod lagu penuh.

Apa yang dikembalikan

Medan demi medan, seperti yang ditakrifkan oleh skema respons spesifikasi. Panggilan satu lagu menamakan kiraan itu streams; panggilan kelompok menamakannya playcount.

Satu lagu

GET /partner/track/count

streams
Kiraan main sepanjang masa, sebagai integer (int64). Nullable dalam spesifikasi, dan 0 bagi lagu di bawah 1,000 main.
spotify_track_id
ID Spotify bagi lagu itu.
isrc
ISRC bagi lagu itu. Nullable dalam spesifikasi.
result
success atau error, dengan message ringkas di sebelahnya.

Satu kelompok

GET /partner/tracks/count

tracks[]
Satu entri bagi setiap ID yang diminta, mengikut susunan permintaan.
tracks[].playcount
Jumlah main sepanjang masa (int64, nullable); 0 bagi lagu di bawah 1,000.
tracks[].status
ok, not_found atau error, dengan teks error apabila statusnya error.
tracks[].name
Nama lagu itu; null apabila ia tidak ditemui.
tracks[].artists[]
id dan name setiap artis.
tracks[].releaseDate
Tarikh keluaran album lagu itu: YYYY-MM-DD, atau ketepatan yang lebih kasar.
missing[]
ID yang diminta yang statusnya bukan ok.

0 bermaksud di bawah 1,000, bukan tidak pernah dimainkan. Spesifikasi menyatakan Spotify melaporkan 0 bagi lagu dengan kurang daripada 1,000 main, jadi simpan 0 sebagai "di bawah 1,000" dan bukannya sebagai kiraan.

Sampel rakaman · diambil pada 2026-10-22

GET /partner/track/count

6 baris — keseluruhan badan yang dirakam.

Sampel rakaman · diambil pada 2026-10-22

GET /partner/tracks/count

18 baris — keseluruhan badan yang dirakam.

Satu lagu, atau 50 bagi setiap panggilan

  • 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.

    Parameterspotify_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.

    Parameterids, 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).

    Parameterid, slim, cache

/partner/tracks/count menerima sehingga 50 ID yang dipisahkan dengan koma dan menjawab mengikut susunan yang Anda hantar, jadi 50 lagu menelan kos satu permintaan dan bukannya 50.

Dapatkan kiraan main

Satu lagu, melalui ID Spotify

ID ialah rentetan 22 aksara selepas /track/ dalam mana-mana URL Spotify. Untuk mencari lagu melalui ISRC-nya, hantar isrc= sebagai ganti id=.

Sehingga 50 lagu dalam satu panggilan

Baca status setiap entri sebelum kiraannya. Entri kembali mengikut susunan ID; yang tiada kiraan main ditandakan not_found atau error sebagai ganti, dan disenaraikan semula dalam missing.

Kiraan main tanpa kod

Jika kiraan itu untuk hamparan dan bukan untuk kod Anda sendiri, dua actor Apify daripada penyelenggara yang sama mengembalikannya sebagai dataset. Sesuatu larian memerlukan akaun Apify dan tiada kunci API: Anda menampal pautan dan memuat turun JSON atau CSV.

Kedua-duanya membilkan mengikut hasil, pada harga yang disenaraikan pada : $0.001 sebaris pada pelan percuma Apify, turun kepada $0.0006 dari Gold ke atas. Bila sesuatu larian mengalahkan kunci, dan bila tidak, ada pada panduan scraper.

Sejarah yang sudah disimpan: 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.

Gunakannya daripada pembantu AI (MCP): minta Claude, Cursor atau VS Code untuk strim sesebuah lagu, dan alat get_track_play_count pelayan MCP Spotify mengembalikan kiraan main sepanjang masa daripada API ini. Sediakan pelayan MCP.

Soalan

Adakah Spotify Web API mengembalikan kiraan main?

Tidak. Objek lagu dalam rujukan Web API tiada medan kiraan main. Medan yang paling hampir, popularity, ialah skor 0–100 yang Spotify kira terutamanya daripada jumlah main dan betapa baharunya main itu; rujukan menandakannya sebagai deprecated, dan perubahan Spotify pada Februari 2026 mengeluarkannya untuk aplikasi mod pembangunan yang dicipta dari 11 Februari 2026.

Mengapakah sesebuah lagu menunjukkan 0 main?

Kerana ia mempunyai kurang daripada 1,000. Spesifikasi menyatakan Spotify melaporkan 0 bagi lagu dengan kurang daripada 1,000 main, jadi 0 bermaksud di bawah 1,000, bukan tidak pernah dimainkan.

Bolehkah saya mendapatkan kiraan main untuk banyak lagu sekali gus?

Boleh. GET /partner/tracks/count menerima sehingga 50 ID lagu yang dipisahkan dengan koma dan menjawab mengikut susunan permintaan, setiap entri dengan status ok, not_found atau error; ID tanpa kiraan main turut disenaraikan dalam missing. 50 lagu menelan kos satu permintaan dan bukannya 50.

Bolehkah saya mencari lagu melalui ISRC?

Boleh. GET /partner/track/count menerima isrc sebagai ganti ID Spotify, jadi katalog yang berkunci ISRC tidak memerlukan carian ID dahulu.

Setakat mana terkininya nombor itu?

Kiraan main dicache selama sejam, jadi sesuatu kiraan lazimnya paling lama sekian lama. Nilai X-Cache yang bermula dengan STALE atau FALLBACK bermaksud salinan lebih lama dihidangkan kerana pengambilan live perlahan atau gagal; X-Cache-Stale-Age memberikan usianya dalam saat. Tambahkan cache=false untuk mendapatkan yang baharu. Butang Jalankan di laman ini turut melalui cache demo sendiri, jadi angka di sana mungkin lebih lama.

Bolehkah saya mendapatkan kiraan main tanpa menulis kod?

Boleh, di Apify: sesuatu larian memerlukan akaun Apify dan tiada kunci API. Spotify Play Count Scraper (eduair94/spotify-play-count-scraper) menerima pautan lagu, album, artis atau senarai main dan mengembalikan satu baris bagi setiap lagu dengan kiraan mainnya; Spotify Scraper (eduair94/spotify-scraper) mempunyai 5 kategori kiraan main antara 61 kategorinya. Kedua-duanya membilkan mengikut hasil.

Pelan mana yang saya perlukan?

Mana-mana. Kedua-dua endpoint kiraan main ada pada setiap pelan, RapidAPI dan portal langsung sama sahaja, dan pelan berbeza mengikut volum bulanan. Setiap pelan RapidAPI membenarkan 5 permintaan sesaat dan setiap kunci langsung termasuk 10. Pelan percuma RapidAPI membenarkan 1,000 permintaan sebulan.

Sumber

More guides

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

Dapatkan kunci dan tarik kiraan main pertama Anda

Kedua-dua endpoint kiraan main ada pada setiap pelan, RapidAPI dan portal langsung sama sahaja; di Apify, dua actor di atas mengembalikan kiraan yang sama sebagai baris dataset, dibilkan mengikut hasil. Peringkat percuma RapidAPI ialah 1,000 permintaan sebulan: pada sehingga 50 lagu bagi setiap panggilan, sehingga 50,000 kiraan main.

RapidAPI Apify Portal Langsung

Belum bersedia untuk membeli? Dapatkan kunci percubaan percuma: 500 permintaan selama 7 hari, tanpa kad.