指南
Spotify 每月聽眾 API:每位藝人的聽眾數、追蹤者數、全球排名與熱門城市
Spotify 應用程式裡每位藝人名字下方的那個數字——每月聽眾——不在 Web API 中。官方藝人物件最多帶有追蹤者數和一個 0–100 的 popularity 分數,關於受眾沒有別的資訊,而且 Spotify 把這兩項都標示為已棄用,並已對 2026 年 2 月 11 日起建立的開發模式應用程式移除了它們。這裡一次呼叫即可回傳聽眾數、追蹤者數、全球排名,以及該藝人播放最多的五個城市。
作者:Eduardo Airaudo,API 維護者 · 更新於 2026年10月22日
官方藝人物件缺了什麼
Spotify Web API 的 GET /v1/artists/{id} 回傳 followers.total、整數 popularity、曲風、圖片與名稱——前三項標示為已棄用,追蹤者數與 popularity 已對 2026 年 2 月 11 日起建立的開發模式應用程式移除。每月聽眾——Spotify 自己放在藝人頁面上的數字,也是唱片公司、經紀人與播放清單推廣人員真正在追蹤的數字——在參考文件裡根本沒有出現,也沒有任何權限範圍能加上它。
popularity 是一個相對的、不透明的分數,由 Spotify 依近期播放重新計算;它無法換算成聽眾數,無法跨月比較,也無法向客戶解釋。每月聽眾數是絕對的數量,會隨著一次發行、一次影視配樂合作或一次加入播放清單而變化,所以人們想要的是這個數字。
這裡的 /artist_overview 回傳應用程式中呈現出的藝人頁面,包括受眾資料區塊。同一次呼叫還帶有作品集、相關藝人與置頂內容,所以受眾數字附帶了解讀它們所需的背景。
回傳什麼
取自 Arijit Singh(4YRxDV8wJFPHPTeXepOstw)的 /artist_overview 錄製回應,擷取於 2026-10-22。完整錄製內容在該端點自己的頁面上。
- stats.monthlyListeners
- 藝人頁面上的受眾數字:過去 28 天內不同聽眾的數量,整數。錄製中為 53,500,280。
- stats.followers
- 追蹤者數。Spotify 已對 2026 年 2 月 11 日起建立的開發模式應用程式,從其自身的藝人物件中移除了它;擴充配額應用程式仍可取得。錄製中為 195,766,074。
- stats.worldRank
- 藝人在 Spotify 依聽眾數排列的全球排名中的位置——錄製中為 56。不在排名範圍內的藝人沒有此項。
- stats.topCities.items[]
- 五列資料,含 city、region、country 與 numberOfListeners。錄製中第一列是 Pune, IN,4,174,171 位聽眾,其後是 Delhi、New Delhi、Mumbai和Bengaluru。
- profile.name
- 顯示名稱。錄製中還帶有簡介、externalLinks 清單(該藝人為空)、置頂項目,以及 profile 下藝人自己的播放清單,沒有認證標記。
- discography, relatedContent
- 最新發行、專輯、單曲、參與作品與相關藝人區塊,都在同一個回應裡——一次呼叫就涵蓋了整個藝人頁面。
53,500,280
stats.monthlyListeners
195,766,074
stats.followers
#56
stats.worldRank
來自同一份錄製的三個數字,2026-10-22。展示它們是為了讓資料結構更具體,不代表目前的數字——想看今天的,請在端點頁面按「執行」。
一位藝人、10 位藝人,或一份排名
- 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 最多接受 10 個以逗號分隔的 ID,並為每位藝人回傳同樣的物件,所以 10 位藝人只算一次請求,而不是 10 次。
依規格的原話,/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」。 兩者都不需要參數。
擷取於 2026-10-22 的每月聽眾錄製回應包含 50 列資料,欄位有 rank、artist 與以百萬為單位的 monthlyListeners——第一列是 Bruno Mars,為 128.6。
取得藝人的受眾數據
| curl -X GET \ |
| "https://spotify-proxy.checkleaked.cc/spotify-data/artist_overview?id=4YRxDV8wJFPHPTeXepOstw" \ |
| -H "x-rapidapi-key: $SPOTIFY_API_KEY" |
ID 是任何 Spotify URL 中 /artist/ 之後的 22 個字元。只有名稱?/search?q=&type=artists 會回傳 ID。
隨時間追蹤這個數字
Spotify 只公布一個目前的值,不提供歷史。時間序列要自己建立:依排程呼叫 /artist_overview,連同時間戳記一起存下 stats.monthlyListeners,再對各列做差。 一份 25 位藝人的名單,每天的任務是 3 次批次請求——每月 90 次請求,在免費額度的 1,000 次之內。
想讓 API 來保存歷史,/tracking/track?spotifyType=artist&spotifyId= 會登記該藝人;它的 monthly_listeners_change 與 followers_change 列會匯集在 /tracking/logs 中,由您輪詢。Webhook 只涵蓋播放清單的變化。兩者都在參考文件的 Tracking 下;它們是維運類端點,所以本站的示範不會執行它們。
不寫程式碼: 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.
常見問題
Spotify Web API 會回傳每月聽眾數嗎?
不會。Web API 參考文件中的藝人物件列出了 followers.total、popularity、曲風、圖片與名稱。前三項標示為已棄用,追蹤者數與 popularity 已對 2026 年 2 月 11 日起建立的開發模式應用程式移除。每月聽眾數顯示在 Spotify 自己的用戶端裡,但不屬於有文件的 API,也沒有任何 OAuth 權限範圍能取得它。
這個數字有多新?
藝人總覽快取約一小時,因此回應可能比 Spotify 應用程式中的數字落後最多一小時。加上 cache=false 可強制重新取得;X-Cache 回應標頭會註明每個回應的提供方式。本站的「執行」按鈕也要經過示範站自己的快取,所以那裡的數字可能更舊。
可以一次取得多位藝人的每月聽眾數嗎?
可以。GET /artist_overview_batch 最多接受 10 個以逗號分隔的藝人 ID,並為每位藝人回傳同樣的總覽物件,所以 10 位藝人只算一次請求。GET /artists?ids= 也接受清單,但回傳的是 Spotify 自己的藝人物件:沒有每月聽眾數,許多藝人也沒有追蹤者數。
worldRank 是全球排名嗎?
它就是 Spotify 自己在藝人頁面上顯示的排名(此處使用的錄製中顯示為「全球第 56 名」)。不在排名範圍內的藝人沒有 worldRank 欄位,所以請把它當作選用項目。
什麼是熱門城市?
stats.topCities.items 列出該藝人聽眾最多的五個城市,每個都含 city、region、country 與 numberOfListeners。它與藝人頁面「簡介」下顯示的區塊相同。
能取得藝人每月聽眾數的歷史嗎?
無法從 Spotify 取得,它只公布目前的值。依排程把數字存下來,就有了從那天起的歷史;為 25 位藝人每天進行 3 次批次呼叫,每月需要 90 次請求。
需要哪個方案?
任何一個。本指南用到的端點在每個方案上都有,RapidAPI 與直購入口網站都一樣,方案只在每月用量上有差別。每個 RapidAPI 方案都允許每秒 5 次請求,每個直購金鑰內含每秒 10 次。RapidAPI 的免費方案每月允許 1,000 次請求。
來源
- Get Artist:Spotify Web API 參考文件 — 官方藝人物件:追蹤者數、popularity 與曲風已標示為棄用;沒有每月聽眾欄位。
- 2026 年 2 月變更:Spotify for Developers 參考文件 — 已對 2026 年 2 月 11 日起建立的開發模式應用程式移除藝人的追蹤者數與 popularity。
- 本站的 GET /artist_overview — 本頁所依據的錄製回應,完整收錄,並註明擷取日期。
- 本站的 GET /top_20_by_monthly_listeners — 平台排名,帶有它自己的錄製回應。
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.
取得金鑰,拉取第一位藝人的資料
三種管道的端點相同,只是定價不同。RapidAPI 的免費額度為每月 1,000 次請求,足夠每天追蹤一批藝人。
還沒決定要購買?取得免費試用金鑰:7 天內 500 次請求,無須信用卡。