指南

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_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。

取得藝人的受眾數據

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 次請求。

來源

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

取得金鑰,拉取第一位藝人的資料

三種管道的端點相同,只是定價不同。RapidAPI 的免費額度為每月 1,000 次請求,足夠每天追蹤一批藝人。

還沒決定要購買?取得免費試用金鑰:7 天內 500 次請求,無須信用卡。