가이드
Spotify 월간 리스너 API: 아티스트별 리스너, 팔로워, 전 세계 순위, 상위 도시
Spotify 앱에서 모든 아티스트 이름 아래에 표시되는 숫자, 즉 월간 리스너는 Web API에 없습니다. 공식 아티스트 객체에는 많아야 팔로워 수와 0~100 인기도 점수만 있고 청중에 관한 다른 정보는 없습니다. Spotify는 이 둘을 지원 중단으로 표시했고, 2026년 2월 11일부터 생성된 개발 모드 앱에서는 제거했습니다. 이곳에서는 호출 한 번으로 리스너, 팔로워, 전 세계 순위, 아티스트가 가장 많이 재생되는 도시 다섯 곳을 반환합니다.
작성: Eduardo Airaudo, API 관리자 · 2026년 10월 22일 업데이트
공식 아티스트 객체에 없는 것
Spotify Web API의 GET /v1/artists/{id} 호출은 followers.total, 정수형 popularity, 장르, 이미지, 이름을 반환합니다. 앞의 세 가지는 지원 중단으로 표시되어 있고, 팔로워와 인기도는 2026년 2월 11일부터 생성된 개발 모드 앱에서 제거되었습니다. Spotify가 아티스트 페이지에 직접 표시하는 수치이자 레이블, 매니저, 플레이리스트 피칭 담당자가 실제로 추적하는 월간 리스너는 레퍼런스 어디에도 없고, 어떤 스코프로도 얻을 수 없습니다.
인기도는 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
- 표시 이름. 기록에는 profile 아래에 약력, externalLinks 목록(이 아티스트는 비어 있음), 고정 항목, 아티스트 본인의 플레이리스트도 들어 있으며, 인증 여부 플래그는 없습니다.
- 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 엔드포인트는 쉼표로 구분한 ID를 최대 10개 받아 아티스트마다 같은 객체를 반환하므로, 아티스트 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에 캡처한 리스너 기록 응답에는 rank, artist, 백만 단위로 표시된 monthlyListeners 필드로 이뤄진 행 50개가 들어 있습니다. 첫 행은 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에 쌓이고, 이를 폴링해서 가져옵니다. 웹훅은 플레이리스트 변경만 다룹니다. 둘 다 레퍼런스의 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), 장르, 이미지, 이름입니다. 앞의 세 가지는 지원 중단으로 표시되어 있고, 팔로워와 인기도는 2026년 2월 11일부터 생성된 개발 모드 앱에서 제거되었습니다. 월간 리스너는 Spotify 자체 클라이언트에는 표시되지만 문서화된 API에는 포함되지 않으며, 어떤 OAuth 스코프로도 얻을 수 없습니다.
숫자는 얼마나 최신인가요?
아티스트 개요는 약 1시간 캐시되므로 응답이 Spotify 앱의 수치보다 최대 그만큼 뒤처질 수 있습니다. 새로 가져오도록 강제하려면 다음을 추가하세요: cache=false. X-Cache 헤더에서 각 응답이 어떻게 제공되었는지 확인할 수 있습니다. 이 사이트의 실행 버튼도 데모 자체 캐시를 거치므로 그곳의 수치는 더 오래되었을 수 있습니다.
여러 아티스트의 월간 리스너를 한 번에 가져올 수 있나요?
네. GET /artist_overview_batch 엔드포인트는 쉼표로 구분한 아티스트 ID를 최대 10개 받아 각각에 대해 같은 개요 객체를 반환하므로, 아티스트 10명이 요청 한 건입니다. GET /artists?ids= 엔드포인트도 목록을 받지만 Spotify 자체 아티스트 객체를 반환하므로 월간 리스너가 없고, 많은 아티스트는 팔로워 수도 없습니다.
worldRank 필드는 전 세계 순위인가요?
Spotify가 아티스트 페이지에 직접 표시하는 순위입니다(여기서 사용한 기록에서는 “전 세계 56위”). 순위에 들지 않은 아티스트에는 worldRank 필드가 없으므로 선택 항목으로 처리하세요.
상위 도시란 무엇인가요?
stats.topCities.items 필드는 아티스트의 리스너가 가장 많은 도시 다섯 곳을 나열하며, 각 도시마다 city, region, country, numberOfListeners 필드가 들어 있습니다. 아티스트 페이지의 정보 영역에 표시되는 것과 같은 블록입니다.
아티스트의 월간 리스너 이력을 가져올 수 있나요?
Spotify에서는 불가능합니다. 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건, 카드 불필요.