Spotify Web API 가이드: 완벽튜토리얼 (2026)

Spotify Web API 가이드: 전체 튜토리얼 (2026)

Spotify Web API를 통해 개발자는 Spotify의 방대한 음악 카탈로그, 사용자 플레이리스트, 재생 제어, 오디오 기능 및 추천 엔진에 접근할 수 있습니다. 음악 탐색 앱, 플레이리스트 생성기, 데이터 시각화 도구를 제작하거나 기존 제품에 Spotify를 통합하려는 경우, 이 가이드는 시작하는 데 필요한 모든 내용을 다룹니다.

Spotify API로 무엇을 만들 수 있을까요?

시작하기

1단계: Spotify Developer 계정 생성

1. developer.spotify.com으로 이동합니다.
2. Spotify 계정으로 로그인합니다 (무료 또는 Premium 계정 모두 가능).
3. Dashboard로 이동합니다.
4. Create App을 클릭합니다.
5. 앱 이름, 설명, redirect URI를 입력합니다 (개발용으로는 http://localhost:3000/callback을 사용하세요).
6. Client ID와 Client Secret을 메모해 둡니다.

2단계: 인증 흐름(Authentication Flows) 이해하기

Spotify는 사용 사례에 따라 여러 가지 흐름의 OAuth 2.0을 사용합니다.

대부분의 애플리케이션에서는 공개 데이터용으로 Client Credentials를, 사용자 특정 데이터용으로 Authorization Code + PKCE를 사용하게 됩니다.

3단계: SDK 설치

Python:

pip install spotipy

Node.js:

npm install spotify-web-api-node

또는 API가 REST 기반이므로 모든 언어에서 원시 HTTP 요청을 사용할 수 있습니다.

인증: Client Credentials Flow

사용자의 개인 데이터에 접근할 필요 없이 공개 데이터(검색, 아티스트 정보, 앨범 트랙)만 필요한 경우 이 흐름을 사용합니다.

Spotipy를 사용한 Python 예시

import spotipy
from spotipy.oauth2 import SpotifyClientCredentials

client_credentials_manager = SpotifyClientCredentials(
    client_id="your-client-id",
    client_secret="your-client-secret",
)

sp = spotipy.Spotify(client_credentials_manager=client_credentials_manager)

# 트랙 검색
results = sp.search(q="artist:Radiohead", type="track", limit=10)

for track in results["tracks"]["items"]:
    print(f"{track['name']} - {track['album']['name']}")

Node.js

import SpotifyWebApi from "spotify-web-api-node";

const spotifyApi = new SpotifyWebApi({
  clientId: "your-client-id",
  clientSecret: "your-client-secret",
});

// access token 가져오기
const data = await spotifyApi.clientCredentialsGrant();
spotifyApi.setAccessToken(data.body["access_token"]);

// 트랙 검색
const results = await spotifyApi.searchTracks("artist:Radiohead", { limit: 10 });

results.body.tracks.items.forEach((track) => {
  console.log(`${track.name} - ${track.album.name}`);
});

cURL

# access token 가져오기
TOKEN=$(curl -s -X POST https://accounts.spotify.com/api/token \
  -u "your-client-id:your-client-secret" \
  -d "grant_type=client_credentials" | jq -r '.access_token')

# 트랙 검색
curl -s "https://api.spotify.com/v1/search?q=artist:Radiohead&type=track&limit=5" \
  -H "Authorization: Bearer $TOKEN" | jq '.tracks.items[] | {name, album: .album.name}'

인증: Authorization Code Flow with PKCE

사용자의 플레이리스트, 많이 들은 트랙 또는 재생 제어와 같은 사용자 특정 데이터에 접근해야 할 때 이 흐름을 사용합니다.

Flask를 사용한 Python 예시

import spotipy
from spotipy.oauth2 import SpotifyOAuth
from flask import Flask, redirect, request, session

app = Flask(__name__)
app.secret_key = "your-secret-key"

SCOPE = "user-read-recently-played user-top-read playlist-modify-public"

@app.route("/login")
def login():
    sp_oauth = SpotifyOAuth(
        client_id="your-client-id",
        client