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.