指南
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 次请求，无需银行卡。