Hướng dẫn

API người nghe hằng tháng Spotify: người nghe, người theo dõi, hạng thế giới và thành phố hàng đầu của từng nghệ sĩ

Con số dưới tên mỗi nghệ sĩ trong ứng dụng Spotify — người nghe hằng tháng — không có trong Web API. Đối tượng nghệ sĩ chính thức chỉ có tối đa số người theo dõi và điểm popularity 0–100, không có gì khác về khán giả; Spotify đánh dấu cả hai là ngừng hỗ trợ và đã gỡ chúng khỏi các ứng dụng ở chế độ phát triển được tạo từ ngày 11 tháng 2 năm 2026. Một lệnh gọi ở đây trả về người nghe, người theo dõi, hạng thế giới và năm thành phố nơi nghệ sĩ được phát nhiều nhất.

Bởi Eduardo Airaudo, người duy trì API · Cập nhật 22 tháng 10, 2026

Những gì đối tượng nghệ sĩ chính thức bỏ sót

GET /v1/artists/{id} trên Spotify Web API trả về followers.total, một số nguyên popularity, thể loại, hình ảnh và tên — ba trường đầu bị đánh dấu ngừng hỗ trợ, còn followers và popularity đã bị gỡ khỏi các ứng dụng ở chế độ phát triển được tạo từ ngày 11 tháng 2 năm 2026. Người nghe hằng tháng — con số mà chính Spotify đặt trên trang nghệ sĩ và là con số mà hãng đĩa, quản lý và người giới thiệu danh sách phát thực sự theo dõi — không xuất hiện ở đâu trong tài liệu, và không có scope nào bổ sung nó.

Popularity là điểm số tương đối, không rõ cách tính, được Spotify tính lại từ các lượt phát gần đây; nó không thể quy đổi thành số người nghe, không so sánh được giữa các tháng và cũng không giải thích được cho khách hàng. Người nghe hằng tháng là con số tuyệt đối, thay đổi theo một bản phát hành, một vị trí sync hay một lượt thêm vào danh sách phát, và đó là lý do nó là con số mà mọi người muốn.

/artist_overview ở đây trả về trang nghệ sĩ đúng như ứng dụng hiển thị, gồm cả khối thông tin khán giả. Cùng lệnh gọi đó mang theo danh sách đĩa nhạc, nghệ sĩ liên quan và các mục được ghim, nên các số liệu khán giả đi kèm bối cảnh cần để đọc chúng.

Dữ liệu trả về

Đọc từ phản hồi /artist_overview đã ghi của Arijit Singh (4YRxDV8wJFPHPTeXepOstw), thu ngày 2026-10-22. Bản ghi đầy đủ nằm trên trang riêng của endpoint.

stats.monthlyListeners
Số liệu khán giả trên trang nghệ sĩ: số người nghe khác nhau trong 28 ngày gần nhất, dạng số nguyên. 53.500.280 trong bản ghi.
stats.followers
Số người theo dõi. Spotify đã gỡ nó khỏi đối tượng nghệ sĩ của chính mình cho các ứng dụng ở chế độ phát triển được tạo từ ngày 11 tháng 2 năm 2026; ứng dụng có hạn mức mở rộng vẫn nhận được. 195.766.074 trong bản ghi.
stats.worldRank
Vị trí của nghệ sĩ trong bảng xếp hạng toàn cầu của Spotify theo số người nghe — 56 trong bản ghi. Không có với nghệ sĩ nằm ngoài nhóm được xếp hạng.
stats.topCities.items[]
Năm dòng gồm city, region, country và numberOfListeners. Bản ghi mở đầu bằng Pune, IN với 4.174.171 người nghe, rồi đến Delhi, New Delhi, Mumbai và Bengaluru.
profile.name
Tên hiển thị. Bản ghi cũng có tiểu sử, danh sách externalLinks (trống với nghệ sĩ này), mục được ghim và các danh sách phát của chính nghệ sĩ trong profile, và không có cờ xác minh.
discography, relatedContent
Bản phát hành mới nhất, album, đĩa đơn, xuất hiện trong và khối nghệ sĩ liên quan, trong cùng một phản hồi — một lệnh gọi bao quát toàn bộ trang nghệ sĩ.

53.500.280

stats.monthlyListeners

195.766.074

stats.followers

#56

stats.worldRank

Ba con số từ một bản ghi, 2026-10-22. Chúng được hiển thị để minh họa cấu trúc, không phải số liệu hiện tại — hãy nhấn Chạy trên trang endpoint để lấy số hôm nay.

Một nghệ sĩ, 10 nghệ sĩ, hoặc một bảng xếp hạng

/artist_overview_batch nhận tối đa 10 ID phân tách bằng dấu phẩy và trả về cùng đối tượng cho mỗi nghệ sĩ, nên 10 nghệ sĩ chỉ tốn một yêu cầu thay vì 10.

Theo lời mô tả trong spec, /top_20_by_monthly_listeners là “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” và /top_20_by_followers là “Wikipedia's list of the most-followed artists on Spotify (followers in millions). Not country-specific”. Cả hai đều không nhận tham số.

Phản hồi người nghe đã ghi, thu ngày 2026-10-22, có 50 dòng gồm rank, artist và monthlyListeners tính theo triệu — dòng đầu là Bruno Mars với 128,6.

Lấy số liệu khán giả của nghệ sĩ

ID là chuỗi 22 ký tự đứng sau /artist/ trong mọi URL Spotify. Chỉ có tên? /search?q=&type=artists trả về ID.

Theo dõi con số này theo thời gian

Spotify chỉ công bố một giá trị hiện tại, không có lịch sử. Chuỗi thời gian là việc của bạn: gọi /artist_overview theo lịch, lưu stats.monthlyListeners kèm dấu thời gian, rồi lấy hiệu giữa các dòng. Một tác vụ hằng ngày cho danh sách 25 nghệ sĩ là 3 yêu cầu theo lô mỗi ngày — 90 yêu cầu mỗi tháng, nằm trong mức 1.000 của gói miễn phí.

Để API giữ lịch sử, /tracking/track?spotifyType=artist&spotifyId= đăng ký nghệ sĩ; các dòng monthly_listeners_change và followers_change của nó được thu thập trong /tracking/logs, mà bạn truy vấn. Webhook chỉ bao quát thay đổi của danh sách phát. Cả hai đều có trong tài liệu tham khảo ở nhóm Tracking; chúng là các endpoint vận hành, nên bản demo trên trang này không chạy chúng.

Không cần code: 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.

Câu hỏi

Spotify Web API có trả về người nghe hằng tháng không?

Không. Đối tượng nghệ sĩ trong tài liệu Web API liệt kê followers.total, popularity, thể loại, hình ảnh và tên. Ba trường đầu bị đánh dấu ngừng hỗ trợ, còn followers và popularity đã bị gỡ khỏi các ứng dụng ở chế độ phát triển được tạo từ ngày 11 tháng 2 năm 2026. Người nghe hằng tháng được hiển thị trong các ứng dụng của chính Spotify nhưng không thuộc API được ghi tài liệu và không có OAuth scope nào cung cấp nó.

Con số này được cập nhật mới đến mức nào?

Tổng quan nghệ sĩ được lưu đệm khoảng một giờ, nên một phản hồi có thể chậm hơn con số trong ứng dụng Spotify tối đa chừng đó. Thêm cache=false để buộc lấy dữ liệu mới; header X-Cache cho biết mỗi phản hồi được phục vụ như thế nào. Các nút Chạy trên trang này cũng đi qua bộ đệm riêng của bản demo, nên con số ở đó có thể cũ hơn.

Tôi có thể lấy người nghe hằng tháng của nhiều nghệ sĩ cùng lúc không?

Được. GET /artist_overview_batch nhận tối đa 10 ID nghệ sĩ phân tách bằng dấu phẩy và trả về cùng đối tượng tổng quan cho từng nghệ sĩ, nên 10 nghệ sĩ chỉ tốn một yêu cầu. GET /artists?ids= cũng nhận danh sách, nhưng trả về đối tượng nghệ sĩ của chính Spotify: không có người nghe hằng tháng, và với nhiều nghệ sĩ cũng không có số người theo dõi.

worldRank có phải là vị trí toàn cầu không?

Đó là hạng mà chính Spotify hiển thị trên trang nghệ sĩ (“Hạng #56 thế giới” trong bản ghi dùng ở đây). Nghệ sĩ nằm ngoài nhóm được xếp hạng không có trường worldRank, nên hãy coi nó là tùy chọn.

Thành phố hàng đầu là gì?

stats.topCities.items liệt kê năm thành phố có nhiều người nghe nhất của nghệ sĩ, mỗi thành phố có city, region, country và numberOfListeners. Đây là cùng khối mà trang nghệ sĩ hiển thị trong phần Giới thiệu.

Tôi có thể lấy lịch sử người nghe hằng tháng của một nghệ sĩ không?

Không lấy được từ Spotify, nơi chỉ công bố giá trị hiện tại. Hãy lưu con số theo lịch và bạn sẽ có lịch sử từ ngày đó trở đi; 3 lệnh gọi theo lô mỗi ngày cho 25 nghệ sĩ tốn 90 yêu cầu mỗi tháng.

Tôi cần gói nào?

Gói nào cũng được. Các endpoint mà hướng dẫn này dùng đều có ở mọi gói, cả RapidAPI lẫn cổng trực tiếp, và các gói chỉ khác nhau về khối lượng hằng tháng. Mọi gói RapidAPI cho phép 5 yêu cầu mỗi giây và mọi khóa trực tiếp đã gồm 10. Gói miễn phí của RapidAPI cho phép 1.000 yêu cầu mỗi tháng.

Nguồn

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

Lấy khóa và lấy nghệ sĩ đầu tiên của bạn

Cùng các endpoint ở cả ba kênh, giá khác nhau. Gói miễn phí của RapidAPI là 1.000 yêu cầu mỗi tháng — đủ để theo dõi một danh sách nghệ sĩ hằng ngày.

Chưa muốn mua? Nhận khóa dùng thử miễn phí: 500 yêu cầu trong 7 ngày, không cần thẻ.