Panduan
API pendengar bulanan Spotify: pendengar, pengikut, kedudukan dunia dan bandar teratas bagi setiap artis
Nombor di bawah nama setiap artis dalam aplikasi Spotify — pendengar bulanan — tiada dalam Web API. Objek artis rasmi paling banyak membawa kiraan pengikut dan skor popularity 0–100, tiada apa-apa lagi tentang khalayak, dan Spotify menandakan kedua-duanya sebagai deprecated serta mengeluarkannya untuk aplikasi mod pembangunan yang dicipta dari 11 Februari 2026. Satu panggilan di sini mengembalikan pendengar, pengikut, kedudukan dunia dan lima bandar tempat artis itu paling kerap dimainkan.
Oleh Eduardo Airaudo, penyelenggara API · Dikemas kini 22 Oktober 2026
Apa yang ditinggalkan oleh objek artis rasmi
GET /v1/artists/{id} pada Spotify Web API mengembalikan followers.total, integer popularity, genre, imej dan nama — tiga yang pertama ditandakan deprecated, dan followers serta popularity dikeluarkan untuk aplikasi mod pembangunan yang dicipta dari 11 Februari 2026. Pendengar bulanan — angka yang Spotify sendiri letakkan pada halaman artis dan yang sebenarnya dijejaki oleh label, pengurus dan pempromosi senarai main — tidak muncul di mana-mana dalam rujukan, dan tiada skop yang menambahkannya.
Popularity ialah skor relatif yang legap, dikira semula oleh Spotify daripada main terkini; ia tidak boleh ditukar kepada pendengar, dibandingkan antara bulan, atau dijelaskan kepada pelanggan. Pendengar bulanan ialah kiraan mutlak yang bergerak mengikut keluaran baharu, penempatan sync atau penambahan senarai main, itulah sebabnya ia nombor yang orang mahukan.
/artist_overview di sini mengembalikan halaman artis seperti yang dipaparkan aplikasi, termasuk blok khalayak. Panggilan yang sama membawa diskografi, artis berkaitan dan item yang disematkan, jadi nombor khalayak datang bersama konteks yang diperlukan untuk membacanya.
Apa yang dikembalikan
Dibaca daripada respons /artist_overview yang dirakam untuk Arijit Singh (4YRxDV8wJFPHPTeXepOstw), diambil pada 2026-10-22. Rakaman penuh ada pada halaman endpoint itu sendiri.
- stats.monthlyListeners
- Angka khalayak pada halaman artis: pendengar berbeza sepanjang 28 hari kebelakangan, sebagai integer. 53,500,280 dalam rakaman.
- stats.followers
- Kiraan pengikut. Spotify mengeluarkannya daripada objek artisnya sendiri untuk aplikasi mod pembangunan yang dicipta dari 11 Februari 2026; aplikasi kuota lanjutan masih mendapatnya. 195,766,074 dalam rakaman.
- stats.worldRank
- Kedudukan artis dalam senarai kedudukan global Spotify mengikut pendengar — 56 dalam rakaman. Tiada bagi artis di luar set yang diberi kedudukan.
- stats.topCities.items[]
- Lima baris city, region, country dan numberOfListeners. Rakaman bermula dengan Pune, IN pada 4,174,171 pendengar, kemudian Delhi, New Delhi, Mumbai dan Bengaluru.
- profile.name
- Nama paparan. Rakaman turut membawa biografi, senarai externalLinks (kosong bagi artis ini), item yang disematkan dan senarai main milik artis itu di bawah profile, dan tiada bendera disahkan.
- discography, relatedContent
- Keluaran terkini, album, single, muncul pada, dan blok artis berkaitan, dalam respons yang sama — satu panggilan meliputi keseluruhan halaman artis.
53,500,280
stats.monthlyListeners
195,766,074
stats.followers
#56
stats.worldRank
Tiga nombor daripada satu rakaman, 2026-10-22. Ia ditunjukkan untuk menjadikan bentuknya jelas, bukan sebagai angka semasa — tekan Jalankan pada halaman endpoint untuk angka hari ini.
Seorang artis, 10 artis, atau senarai kedudukan
- 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 menerima sehingga 10 ID yang dipisahkan dengan koma dan mengembalikan objek yang sama bagi setiap artis, jadi 10 artis menelan kos satu permintaan dan bukannya 10.
Dalam kata-kata spesifikasi, /top_20_by_monthly_listeners ialah “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” dan /top_20_by_followers ialah “Wikipedia's list of the most-followed artists on Spotify (followers in millions). Not country-specific”. Kedua-duanya tidak menerima parameter.
Respons pendengar yang dirakam, diambil pada 2026-10-22, mengandungi 50 baris rank, artist dan monthlyListeners dinyatakan dalam juta — baris pertama menunjukkan Bruno Mars pada 128.6.
Dapatkan nombor khalayak seseorang artis
| curl -X GET \ |
| "https://spotify-proxy.checkleaked.cc/spotify-data/artist_overview?id=4YRxDV8wJFPHPTeXepOstw" \ |
| -H "x-rapidapi-key: $SPOTIFY_API_KEY" |
ID ialah rentetan 22 aksara selepas /artist/ dalam mana-mana URL Spotify. Ada nama sahaja? /search?q=&type=artists mengembalikan ID.
Menjejaki nombor itu dari semasa ke semasa
Spotify menerbitkan satu nilai semasa, bukan sejarah. Siri masa terpulang kepada Anda untuk dibina: panggil /artist_overview mengikut jadual, simpan stats.monthlyListeners dengan cap masa, dan tolakkan baris. Kerja harian untuk senarai 25 artis ialah 3 permintaan kelompok sehari — 90 permintaan sebulan, dalam lingkungan 1,000 peringkat percuma.
Supaya API menyimpan sejarah, /tracking/track?spotifyType=artist&spotifyId= mendaftarkan artis itu; baris monthly_listeners_change dan followers_change bagi artis itu terkumpul dalam /tracking/logs, yang Anda tinjau. Webhook hanya meliputi perubahan senarai main. Kedua-duanya ada pada rujukan di bawah Tracking; ia endpoint operasi, jadi demo di laman ini tidak menjalankannya.
Tanpa kod: 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.
Soalan
Adakah Spotify Web API mengembalikan pendengar bulanan?
Tidak. Objek artis dalam rujukan Web API menyenaraikan followers.total, popularity, genre, imej dan nama. Tiga yang pertama ditandakan deprecated, dan followers serta popularity dikeluarkan untuk aplikasi mod pembangunan yang dicipta dari 11 Februari 2026. Pendengar bulanan ditunjukkan dalam klien Spotify sendiri tetapi bukan sebahagian daripada API yang didokumenkan dan tiada skop OAuth yang mendedahkannya.
Setakat mana terkininya nombor itu?
Gambaran keseluruhan artis dicache selama kira-kira sejam, jadi respons boleh ketinggalan daripada angka dalam aplikasi Spotify sehingga selama itu. Tambahkan cache=false untuk memaksa pengambilan baharu; pengepala X-Cache menyatakan bagaimana setiap respons dihidangkan. Butang Jalankan di laman ini turut melalui cache demo sendiri, jadi angka di sana mungkin lebih lama.
Bolehkah saya mendapatkan pendengar bulanan untuk ramai artis sekali gus?
Boleh. GET /artist_overview_batch menerima sehingga 10 ID artis yang dipisahkan dengan koma dan mengembalikan objek gambaran keseluruhan yang sama bagi setiap satu, jadi 10 artis menelan kos satu permintaan. GET /artists?ids= juga menerima senarai, tetapi mengembalikan objek artis Spotify sendiri: tiada pendengar bulanan, dan bagi ramai artis tiada kiraan pengikut juga.
Adakah worldRank satu kedudukan global?
Ia ialah kedudukan yang Spotify sendiri paparkan pada halaman artis ("#56 di dunia" dalam rakaman yang digunakan di sini). Artis di luar set yang diberi kedudukan tiada medan worldRank, jadi anggap ia pilihan.
Apakah bandar teratas?
stats.topCities.items menyenaraikan lima bandar dengan pendengar terbanyak bagi artis itu, masing-masing dengan city, region, country dan numberOfListeners. Ia blok yang sama yang dipaparkan halaman artis di bawah Perihal.
Bolehkah saya mendapatkan sejarah pendengar bulanan seseorang artis?
Bukan daripada Spotify, yang hanya menerbitkan nilai semasa. Simpan nombor itu mengikut jadual dan Anda mempunyai sejarahnya dari hari itu; 3 panggilan kelompok sehari bagi 25 artis menelan kos 90 permintaan sebulan.
Pelan mana yang saya perlukan?
Mana-mana. Endpoint yang digunakan oleh panduan ini 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
- Get Artist — rujukan Spotify Web API — objek artis rasmi: followers, popularity dan genres ditandakan deprecated; tiada medan pendengar bulanan.
- Perubahan Februari 2026 — rujukan Spotify for Developers — followers dan popularity artis dikeluarkan untuk aplikasi mod pembangunan yang dicipta dari 11 Februari 2026.
- GET /artist_overview di laman ini — respons rakaman yang dibaca oleh halaman ini, secara penuh, dengan tarikh diambil.
- GET /top_20_by_monthly_listeners di laman ini — senarai kedudukan platform, dengan rakamannya sendiri.
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.
Dapatkan kunci dan tarik artis pertama Anda
Endpoint yang sama pada ketiga-tiganya, dengan harga berbeza. Peringkat percuma RapidAPI ialah 1,000 permintaan sebulan — cukup untuk menjejaki senarai artis setiap hari.
Belum bersedia untuk membeli? Dapatkan kunci percubaan percuma: 500 permintaan selama 7 hari, tanpa kad.