API lượt phát Spotify: tổng lượt phát của mọi bài hát, theo ID hoặc ISRC

Những gì đối tượng bài hát chính thức bỏ sót

Dữ liệu trả về

Từng trường một, theo các schema phản hồi của spec. Lệnh gọi một bài hát đặt tên con số này là streams; lệnh gọi theo lô đặt tên là playcount.

Số 0 nghĩa là dưới 1.000, không phải chưa từng được phát. Spec nêu rằng Spotify báo cáo 0 cho các bài hát dưới 1.000 lượt phát, nên hãy lưu số 0 là “dưới 1.000” chứ đừng coi đó là một con số đếm.

Một bài hát, hoặc 50 bài mỗi lệnh gọi

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

  Tham số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.

  Tham số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).

  Tham sốid, slim, cache

/partner/tracks/count nhận tối đa 50 ID phân tách bằng dấu phẩy và trả lời theo đúng thứ tự bạn gửi, nên 50 bài hát chỉ tốn một yêu cầu thay vì 50.

Lấy lượt phát

Một bài hát, theo ID Spotify

ID là chuỗi 22 ký tự đứng sau /track/ trong mọi URL Spotify. Để tra bài hát theo ISRC, hãy gửi isrc= thay cho id=.

Tối đa 50 bài hát trong một lệnh gọi

Hãy đọc status của từng mục trước khi đọc số lượt phát. Các mục trả về theo thứ tự của các ID; mục không có lượt phát được đánh dấu not_found hoặc error ở vị trí của nó, và được liệt kê lại trong missing.

Lượt phát không cần code

Nếu các con số dành cho bảng tính chứ không phải code của bạn, hai actor Apify của cùng người duy trì sẽ trả về chúng dưới dạng dataset. Một lần chạy cần tài khoản Apify và không cần khóa API: bạn dán liên kết và tải về JSON hoặc CSV.

• Spotify Play Count Scraper (mở trong tab mới)eduair94/spotify-play-count-scraper

  Dán liên kết, URI hoặc ID của bài hát, album, nghệ sĩ hoặc danh sách phát; actor trả về một dòng cho mỗi bài hát kèm lượt phát — các bài hàng đầu hoặc toàn bộ danh sách đĩa nhạc của nghệ sĩ, mọi bài hát trong album hoặc danh sách phát — và, nếu được yêu cầu, một dòng với số người nghe hằng tháng của nghệ sĩ.

• Spotify Scraper (mở trong tab mới)eduair94/spotify-scraper

  Actor đa dụng: 61 danh mục, trong đó 5 danh mục là lượt phát (track_play_count, album_play_counts, artist_play_counts, artist_discography_play_counts, playlist_play_counts), và isrc, tìm bài hát theo ISRC kèm lượt phát.

Cả hai đều tính theo kết quả, với giá niêm yết ngày 22 tháng 10, 2026: $0.001 mỗi dòng ở gói miễn phí của Apify, xuống còn $0.0006 từ gói Gold trở lên. Khi nào một lần chạy rẻ hơn khóa, và khi nào không, có ở hướng dẫn về scraper.

Lịch sử đã được lưu sẵn: 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.

Dùng từ trợ lý AI (MCP): hãy hỏi Claude, Cursor hoặc VS Code về lượt phát của một bài hát, và công cụ get_track_play_count của Spotify MCP server sẽ trả về tổng lượt phát từ API này. Thiết lập MCP server.

Câu hỏi

Nguồn

• Get Track — tài liệu tham khảo Spotify Web API — đối tượng bài hát chính thức: không có lượt phát, và popularity bị đánh dấu ngừng hỗ trợ.
• Thay đổi tháng 2 năm 2026 — tài liệu tham khảo Spotify for Developers — popularity của bài hát nằm trong số các trường bị gỡ.
• Hướng dẫn chuyển đổi tháng 2 năm 2026 — Spotify for Developers — việc gỡ bỏ áp dụng cho ai: các ứng dụng ở chế độ phát triển, ứng dụng mới từ ngày 11 tháng 2 năm 2026; ứng dụng có hạn mức mở rộng không bị ảnh hưởng.
• GET /partner/track/count trên trang này — tham số, trạng thái lỗi và nút Chạy của nó.
• GET /partner/tracks/count trên trang này — lệnh gọi theo lô, với các mục tương tự.
• Spotify Play Count Scraper trên Apify — hướng không cần code: đầu vào và giá mỗi dòng của nó, như đang được công bố.

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.