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 엔드포인트는 쉼표로 구분한 ID를 최대 50개 받아 보낸 순서대로 응답하므로, 트랙 50개를 요청 50건이 아니라 한 건으로 조회합니다.

재생 횟수 가져오기

Spotify ID로 트랙 하나

ID는 Spotify URL에서 /track/ 뒤에 오는 22자 문자열입니다. ISRC로 트랙을 조회하려면 id= 대신 isrc= 매개변수를 보내세요.

한 번의 호출로 최대 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.