Spotify 播放次数 API：按 ID 或 ISRC 获取任意歌曲的累计播放次数

官方歌曲对象缺了什么

返回什么

逐个字段说明，依据规范中的响应模式。单曲调用把播放次数命名为 streams；批量调用命名为 playcount。

0 表示不足 1,000，而不是从未播放。 规范指出，Spotify 对播放次数不足 1,000 的歌曲报告 0，所以请把 0 存为“低于 1,000”，而不是当作一个计数。

一首歌曲，或每次调用 50 首

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

  参数spotify_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.

  参数ids, 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).

  参数id, slim, cache

/partner/tracks/count 最多接受 50 个以逗号分隔的 ID，并按发送的顺序返回结果，所以 50 首歌曲只算一次请求，而不是 50 次。

获取播放次数

按 Spotify ID 查询一首歌曲

ID 是任意 Spotify URL 中 /track/ 之后的 22 个字符。若要按 ISRC 查询歌曲，请用 isrc= 代替 id= 发送。

一次调用最多查询 50 首歌曲

请先看每一项的 status，再看它的播放次数。结果按 ID 的顺序返回；没有播放次数的项会被标记为 not_found 或 error，并再次列在 missing 中。

无需写代码获取播放次数

如果这些播放次数是用于电子表格，而不是自己的代码，同一位维护者的两个 Apify Actor 会把它们作为数据集返回。运行只需要 Apify 账号，不需要 API 密钥：粘贴链接，下载 JSON 或 CSV。

• Spotify Play Count Scraper （在新标签页中打开）eduair94/spotify-play-count-scraper

  粘贴歌曲、专辑、艺人或播放列表的链接、URI 或 ID；每首歌曲返回一行及其播放次数——可以是艺人的热门歌曲或全部作品、专辑或播放列表中的每首歌曲——如有需要，还会返回一行艺人的每月听众数。

• Spotify Scraper （在新标签页中打开）eduair94/spotify-scraper

  通用 Actor：共 61 个类别，其中 5 个是播放次数类别（track_play_count, album_play_counts, artist_play_counts, artist_discography_play_counts, playlist_play_counts），另有 isrc，可按 ISRC 找到歌曲及其播放次数。

两者都按结果计费，价格以 2026年10月22日 列出的为准：Apify 免费方案每行 $0.001，Gold 及以上低至 $0.0006。一次运行什么时候比密钥划算、什么时候不划算，见爬虫指南。

已有历史记录： 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.

在 AI 助手中使用（MCP）：向 Claude、Cursor 或 VS Code 询问一首歌曲的播放次数，Spotify MCP 服务器的 get_track_play_count 工具就会从本 API 返回累计播放次数。设置 MCP 服务器。

常见问题

来源

• Get Track：Spotify Web API 参考文档 — 官方歌曲对象：没有播放次数，popularity 已标记为弃用。
• 2026 年 2 月变更：Spotify for Developers 参考文档 — 被移除的字段中包括歌曲的 popularity。
• 2026 年 2 月迁移指南：Spotify for Developers — 移除影响的对象：开发模式应用，即 2026 年 2 月 11 日起新建的应用；扩展配额应用不受影响。
• 本站的 GET /partner/track/count — 其参数、错误状态和“运行”按钮。
• 本站的 GET /partner/tracks/count — 批量调用，同样如此。
• Apify 上的 Spotify Play Count Scraper — 无需写代码的方式：其输入，以及目前公布的每行价格。

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 monthly listeners APIMonthly listeners, follower counts, world rank and top cities per artist — numbers the Web API never returned.
• 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.