플랫폼 가용성
- 24시간 상태
- 정상
최근 30일
제공 기능
각 Spotify 액션의 기능, 가격, 최근 24시간 상태를 확인할 수 있습니다. 액션을 열면 파라미터, 응답 필드, 코드 예제를 볼 수 있습니다.
| 기능 | 설명 | 1,000건당 | 24시간 상태 |
|---|---|---|---|
상세 정보profile | 전체 링크로 Spotify 앨범이나 싱글을 조회합니다. | 요청 1,000개당 $1.39 | 정상 |
검색search | 키워드로 Spotify에서 트랙, 아티스트, 앨범, 플레이리스트를 검색합니다. | 요청 1,000개당 $1.39 | 정상 |
아티스트 상세 정보artist | Spotify 아티스트의 소개, 장르, 월간 청취자 수, 팔로워 수, 세계 순위와 인기 트랙, 주요 청취 도시, 관련 아티스트를 읽어 옵니다. | 요청 1,000개당 $1.39 | 정상 |
트랙track | Spotify 트랙 하나의 아티스트, 앨범, 길이, 재생 수, 트랙 및 디스크 번호, 발매일, 레이블, 콘텐츠 등급을 가져옵니다. | 요청 1,000개당 $1.39 | 정상 |
앨범album | 링크, URI 또는 ID로 Spotify 앨범의 유형, 아티스트, 발매일, 레이블, 저작권 표기, 커버 아트, 전체 트랙 목록을 가져옵니다. | 요청 1,000개당 $1.39 | 정상 |
플레이리스트playlist | Spotify 플레이리스트를 열어 소유자, 설명, 저장 수, 팔로워 수, 트랙 수, 수록 트랙을 확인합니다. | 요청 1,000개당 $1.39 | 정상 |
팟캐스트podcast | 키워드로 Spotify 팟캐스트 쇼나 개별 에피소드를 찾습니다. | 요청 1,000개당 $1.39 | 정상 |
기능을 열면 파라미터, 응답 필드, 코드 샘플을 확인하고 직접 사용해 볼 수 있습니다.
Spotify 액션별로 어떤 입력을 받나요?
아래 각 답변은 호출 가능한 액션 하나와 실제 입력값을 짝지어 보여 줍니다. 파라미터의 의미와 허용 값은 액션마다 다릅니다. 익숙한 이름이라도 모든 플랫폼에서 같은 의미를 갖지는 않습니다.
공식 출처 링크는 옆에 있는 플랫폼 용어를 설명하기 위한 것입니다. 플랫폼의 승인이나 보증을 의미하지 않으며, 이 페이지에 명시되지 않은 공식 사이트의 기능은 EveryInfra API에 포함되지 않습니다.
| 액션 | 필수 | 선택 | 전달 방식 | 한도 | 1,000건당 | 응답 필드 |
|---|---|---|---|---|---|---|
profile상세 정보 전체 링크로 Spotify 앨범이나 싱글을 조회합니다. 발매 유형, 날짜, 음반 레이블, 참여 아티스트, 커버, 트랙 목록을 받을 수 있습니다. 이전부터 제공되던 이 진입점은 사용자 프로필이 아닌 음반을 읽어 옵니다. 오디오는 재생하지 않습니다. | url | — | Sync 응답 | — | 요청 1,000개당 $1.39 | id · url · name · type · release_date · label · artists · image_url · track_count · tracks · platform |
search검색 키워드로 Spotify에서 트랙, 아티스트, 앨범, 플레이리스트를 검색합니다. 각 결과의 이름, 유형, 아티스트, 링크와 결과 종류에 맞는 수치를 받을 수 있습니다. 종류는 | keyword | content_type | Sync 응답 | 카탈로그 값: defaultLimit=20, maxLimit=100. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. | 요청 1,000개당 $1.39 | id · url · type · name · text · artists · album_name · owner_name · publisher · image_url · duration_ms · play_count · follower_count · monthly_listener_count · track_count · episode_count · release_date · is_explicit · preview_url · rank · platform |
artist아티스트 상세 정보 Spotify 아티스트의 소개, 장르, 월간 청취자 수, 팔로워 수, 세계 순위와 인기 트랙, 주요 청취 도시, 관련 아티스트를 읽어 옵니다. 아티스트 링크, spotify:artist: URI 또는 접두사 없는 ID를 전달하세요. 수치는 특정 시점의 스냅샷이며 수익이나 이력 데이터가 아닙니다. | url | — | Sync 응답 | — | 요청 1,000개당 $1.39 | id · url · name · bio · monthly_listener_count · follower_count · world_rank · genres · image_url · header_image_url · album_count · single_count · compilation_count · top_cities · top_tracks · related_artists · platform |
track트랙 Spotify 트랙 하나의 아티스트, 앨범, 길이, 재생 수, 트랙 및 디스크 번호, 발매일, 레이블, 콘텐츠 등급을 가져옵니다. | url | — | Sync 응답 | — | 요청 1,000개당 $1.39 | id · url · name · artists · album_name · duration_ms · play_count · track_number · disc_number · is_explicit · release_date · preview_url · image_url · added_at · platform · album_id · album_type · label · content_rating |
album앨범 링크, URI 또는 ID로 Spotify 앨범의 유형, 아티스트, 발매일, 레이블, 저작권 표기, 커버 아트, 전체 트랙 목록을 가져옵니다. 재생은 하지 않으며, 같은 음반의 지역별 에디션이 일치한다는 보장은 없습니다. | url | — | Sync 응답 | — | 요청 1,000개당 $1.39 | id · url · name · album_type · artists · release_date · label · copyright · track_count · image_url · tracks · platform |
playlist플레이리스트 Spotify 플레이리스트를 열어 소유자, 설명, 저장 수, 팔로워 수, 트랙 수, 수록 트랙을 확인합니다. 플레이리스트는 변경되지 않고 개별 팔로워 이름은 제공되지 않으며, 트랙이 여전히 재생 가능하다는 보장은 없습니다. | url | — | Sync 응답 | — | 요청 1,000개당 $1.39 | id · url · name · text · owner_name · save_count · follower_count · track_count · image_url · tracks · platform |
podcast팟캐스트 키워드로 Spotify 팟캐스트 쇼나 개별 에피소드를 찾습니다. 해당하는 경우 게시자, 에피소드 수, 재생 시간, 공개일을 받을 수 있습니다. 에피소드를 찾으려면 | keyword | content_type | Sync 응답 | 카탈로그 값: defaultLimit=20, maxLimit=100. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. | 요청 1,000개당 $1.39 | id · url · type · name · text · artists · album_name · owner_name · publisher · image_url · duration_ms · play_count · follower_count · monthly_listener_count · track_count · episode_count · release_date · is_explicit · preview_url · rank · platform |
Spotify profile 파라미터는 각각 무엇을 의미하나요?
전체 링크로 Spotify 앨범이나 싱글을 조회합니다. 발매 유형, 날짜, 음반 레이블, 참여 아티스트, 커버, 트랙 목록을 받을 수 있습니다. 이전부터 제공되던 이 진입점은 사용자 프로필이 아닌 음반을 읽어 옵니다. 오디오는 재생하지 않습니다.
전체 API 레퍼런스: 파라미터, 코드 예제, 응답 예시, 상태url필수- 선택한 액션(artist, track, album, playlist)에 맞는 open.spotify.com 링크, spotify:type:ID URI 또는 엔티티 ID 자체를 지정합니다. 입력 유형은 엔드포인트 액션과 일치해야 하며 서로 바꿔 쓸 수 없습니다. 레거시 profile 엔드포인트는 Spotify 전체 링크를 받아 사용자 계정 정보가 아니라 앨범 및 싱글의 스트리밍 메타데이터를 반환합니다.Spotify: 리소스 URL, URI, 사용자 식별자는 서로 바꿔 쓸 수 없다 — Spotify 공식 문서는 리소스 URL, URI, ID, 사용자 식별자를 구분합니다. 레거시 `profile` 액션은 전체 발매 이력 URL만 받습니다. 이름은 비슷하지만 공식 사용자 프로필 엔드포인트로 작동하지 않으며, 다른 액션용 URI를 자동으로 파싱하지도 않습니다. · 확인일
Spotify search 파라미터는 각각 무엇을 의미하나요?
키워드로 Spotify에서 트랙, 아티스트, 앨범, 플레이리스트를 검색합니다. 각 결과의 이름, 유형, 아티스트, 링크와 결과 종류에 맞는 수치를 받을 수 있습니다. 종류는 content_type으로 지정합니다. 결과는 지역마다 다를 수 있으며, 시간에 따른 인기도 변화는 보여 주지 않습니다.
keyword필수- search 액션의 검색어를 지정하며, 대상 엔티티는 content_type으로 제한됩니다. podcast 액션에서는 특정 에피소드 상세 정보를 조회하는 대신 기본적으로 팟캐스트 프로그램 단위로 검색합니다.
content_type선택- 대상 카탈로그 유형을 필터링합니다. search 액션에서 허용되는 값은 tracks, artists, albums, playlists입니다. podcast 액션은 별도의 값을 사용하며, 팟캐스트 프로그램은 podcasts_shows(기본값), 개별 에피소드는 podcast_episodes_individual_episodes를 지정합니다. 한 액션의 값은 다른 액션에서 사용할 수 없습니다.허용 값:
albumsartistsplayliststracks
Spotify artist 파라미터는 각각 무엇을 의미하나요?
Spotify 아티스트의 소개, 장르, 월간 청취자 수, 팔로워 수, 세계 순위와 인기 트랙, 주요 청취 도시, 관련 아티스트를 읽어 옵니다. 아티스트 링크, spotify:artist: URI 또는 접두사 없는 ID를 전달하세요. 수치는 특정 시점의 스냅샷이며 수익이나 이력 데이터가 아닙니다.
전체 API 레퍼런스: 파라미터, 코드 예제, 응답 예시, 상태url필수- 선택한 액션(artist, track, album, playlist)에 맞는 open.spotify.com 링크, spotify:type:ID URI 또는 엔티티 ID 자체를 지정합니다. 입력 유형은 엔드포인트 액션과 일치해야 하며 서로 바꿔 쓸 수 없습니다. 레거시 profile 엔드포인트는 Spotify 전체 링크를 받아 사용자 계정 정보가 아니라 앨범 및 싱글의 스트리밍 메타데이터를 반환합니다.Spotify: 월간 청취자와 월간 능동 청취자 지표는 어떻게 다른가 — Spotify는 월간 청취자를 지난 28일 동안 능동적 스트리밍과 알고리즘 추천을 통해 들은 고유 청취자로 정의합니다. 월간 능동 청취자는 이 중 능동적으로 청취한 일부만 나타냅니다. 이 페이지의 `monthly_listener_count` 필드를 이 능동 청취자 수, 재생 수, 팔로워 총수로 해석해서는 안 됩니다. · 확인일
Spotify track 파라미터는 각각 무엇을 의미하나요?
Spotify 트랙 하나의 아티스트, 앨범, 길이, 재생 수, 트랙 및 디스크 번호, 발매일, 레이블, 콘텐츠 등급을 가져옵니다. duration_ms는 밀리초 단위이며, 응답에는 오디오 파일이 포함되지 않고 지역별 권리도 확인해 주지 않습니다.
url필수- 선택한 액션(artist, track, album, playlist)에 맞는 open.spotify.com 링크, spotify:type:ID URI 또는 엔티티 ID 자체를 지정합니다. 입력 유형은 엔드포인트 액션과 일치해야 하며 서로 바꿔 쓸 수 없습니다. 레거시 profile 엔드포인트는 Spotify 전체 링크를 받아 사용자 계정 정보가 아니라 앨범 및 싱글의 스트리밍 메타데이터를 반환합니다.Spotify: ID만으로는 리소스 유형을 알 수 없다 — 공식 문서에 따르면 Spotify ID만으로는 호출 맥락 없이 해당 리소스 유형을 명시적으로 알 수 없지만, URI에는 유형 정보가 포함됩니다. 원시 문자열은 리소스 유형 간에 자동으로 변환되지 않으므로, 호출자는 선택한 액션, URL 경로, 대상 ID 유형을 일치시켜야 합니다. · 확인일Spotify: 트랙, 상위 앨범, 콘텐츠 이용 범위 — Spotify 공식 트랙 문서는 `track`과 `album` 객체를 구분하고, 콘텐츠 출처 표시, 다운로드, 모델 학습에 대한 제한을 설명합니다. 이 엔드포인트로 메타데이터를 조회해도 전체 오디오 다운로드나 AI 학습 권한은 제공되지 않으며, 공식 플랫폼 필드와 `market` 파라미터가 자동으로 이 엔드포인트에 포함되지도 않습니다. · 확인일
Spotify album 파라미터는 각각 무엇을 의미하나요?
링크, URI 또는 ID로 Spotify 앨범의 유형, 아티스트, 발매일, 레이블, 저작권 표기, 커버 아트, 전체 트랙 목록을 가져옵니다. 재생은 하지 않으며, 같은 음반의 지역별 에디션이 일치한다는 보장은 없습니다.
전체 API 레퍼런스: 파라미터, 코드 예제, 응답 예시, 상태url필수- 선택한 액션(artist, track, album, playlist)에 맞는 open.spotify.com 링크, spotify:type:ID URI 또는 엔티티 ID 자체를 지정합니다. 입력 유형은 엔드포인트 액션과 일치해야 하며 서로 바꿔 쓸 수 없습니다. 레거시 profile 엔드포인트는 Spotify 전체 링크를 받아 사용자 계정 정보가 아니라 앨범 및 싱글의 스트리밍 메타데이터를 반환합니다.Spotify: ID만으로는 리소스 유형을 알 수 없다 — 공식 문서에 따르면 Spotify ID만으로는 호출 맥락 없이 해당 리소스 유형을 명시적으로 알 수 없지만, URI에는 유형 정보가 포함됩니다. 원시 문자열은 리소스 유형 간에 자동으로 변환되지 않으므로, 호출자는 선택한 액션, URL 경로, 대상 ID 유형을 일치시켜야 합니다. · 확인일
Spotify playlist 파라미터는 각각 무엇을 의미하나요?
Spotify 플레이리스트를 열어 소유자, 설명, 저장 수, 팔로워 수, 트랙 수, 수록 트랙을 확인합니다. 플레이리스트는 변경되지 않고 개별 팔로워 이름은 제공되지 않으며, 트랙이 여전히 재생 가능하다는 보장은 없습니다.
전체 API 레퍼런스: 파라미터, 코드 예제, 응답 예시, 상태url필수- 선택한 액션(artist, track, album, playlist)에 맞는 open.spotify.com 링크, spotify:type:ID URI 또는 엔티티 ID 자체를 지정합니다. 입력 유형은 엔드포인트 액션과 일치해야 하며 서로 바꿔 쓸 수 없습니다. 레거시 profile 엔드포인트는 Spotify 전체 링크를 받아 사용자 계정 정보가 아니라 앨범 및 싱글의 스트리밍 메타데이터를 반환합니다.Spotify: ID만으로는 리소스 유형을 알 수 없다 — 공식 문서에 따르면 Spotify ID만으로는 호출 맥락 없이 해당 리소스 유형을 명시적으로 알 수 없지만, URI에는 유형 정보가 포함됩니다. 원시 문자열은 리소스 유형 간에 자동으로 변환되지 않으므로, 호출자는 선택한 액션, URL 경로, 대상 ID 유형을 일치시켜야 합니다. · 확인일
Spotify podcast 파라미터는 각각 무엇을 의미하나요?
키워드로 Spotify 팟캐스트 쇼나 개별 에피소드를 찾습니다. 해당하는 경우 게시자, 에피소드 수, 재생 시간, 공개일을 받을 수 있습니다. 에피소드를 찾으려면 content_type을 podcast_episodes_individual_episodes로 설정하세요. 각 행의 유형으로 쇼와 에피소드를 구분할 수 있습니다. 오디오는 다운로드하지 않습니다.
keyword필수- search 액션의 검색어를 지정하며, 대상 엔티티는 content_type으로 제한됩니다. podcast 액션에서는 특정 에피소드 상세 정보를 조회하는 대신 기본적으로 팟캐스트 프로그램 단위로 검색합니다.
content_type선택- 대상 카탈로그 유형을 필터링합니다. search 액션에서 허용되는 값은 tracks, artists, albums, playlists입니다. podcast 액션은 별도의 값을 사용하며, 팟캐스트 프로그램은 podcasts_shows(기본값), 개별 에피소드는 podcast_episodes_individual_episodes를 지정합니다. 한 액션의 값은 다른 액션에서 사용할 수 없습니다.허용 값:
podcast_episodes_individual_episodespodcasts_showsSpotify: 팟캐스트 쇼와 에피소드 객체는 다르다 — Spotify 공식 문서는 에피소드를 상위 쇼 페이지 아래에 구성하며, 쇼 팔로우와 에피소드 저장을 구분합니다. 이 구조 참고 자료는 리소스 계층만 설명하며, 오디오 재생, 오프라인 다운로드, 유료 구독 콘텐츠 접근 같은 Spotify 앱 기능을 제공하지 않습니다. · 확인일
Spotify API 사용 방법
- 01공개 카탈로그에서 플랫폼 액션을 선택합니다.
- 02플랫폼, 액션, 필수 파라미터를 POST /api/v1/social로 보냅니다.
- 03응답에서 결과를 읽습니다. 비동기 액션이면 반환된 작업 ID를 폴링합니다.
- 04애플리케이션에 필요한 응답 필드를 저장합니다.
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"spotify","action":"profile","params":{"url":"<url>"}}'
Spotify API 자주 묻는 질문
Spotify API로 무엇을 가져올 수 있나요?
platform을 spotify 값으로 설정하세요. 현재 카탈로그에 등록된 항목은 상세 정보, 검색, 아티스트 상세 정보, 트랙, 앨범 및 more입니다. 각 액션 이름은 서로 다른 Spotify 객체나 뷰를 가리키며, 서로 바꿔 쓸 수 있는 검색 모드가 아닙니다.
Spotify에 공식 API가 있나요?
네. Spotify의 Web API는 카탈로그 메타데이터와 앱에 권한을 부여한 사용자의 데이터를 제공합니다. 새 앱은 Development Mode로 시작하며(소유자는 Premium 이용자여야 하고, 앱 사용자는 최대 5명으로 제한되며, 엔드포인트는 일부만 제공), 확장 접근 권한은 서비스를 출시했고 월간 활성 사용자가 250,000명 이상인 등록 조직에만 부여됩니다.
공식 출처: Spotify Web API: quota modes · Spotify: update on developer access and platform security · 확인일
Spotify 개발자 계정이나 API 키가 필요한가요?
아니요. 요청은 EveryInfra API 키를 사용해 EveryInfra를 통해 전송됩니다. 회원가입 후 콘솔에서 키를 생성하고 Authorization: Bearer <API_KEY> 형식으로 보내면 됩니다. Spotify 개발자 앱을 등록하거나, Spotify API 접근을 신청하거나, Spotify 계정으로 로그인할 필요가 없으며, 액션은 공개된 Spotify 데이터만 반환합니다.
Spotify API 요금은 요청 1,000건당 얼마인가요?
액션에 따라 요청 1,000개당 $1.39이며, 각 액션의 가격은 이 페이지의 표와 공개 카탈로그에서 확인할 수 있습니다. 구독제가 아니며, USD 잔액을 충전한 뒤 API 호출당 비용을 지불합니다. 실패한 호출과 빈 결과에는 과금되지 않습니다.
Spotify profile 요청에는 어떤 입력이 필요한가요?
선택한 액션(artist, track, album, playlist)에 맞는 open.spotify.com 링크, spotify:type:ID URI 또는 엔티티 ID 자체를 지정합니다. 입력 유형은 엔드포인트 액션과 일치해야 하며 서로 바꿔 쓸 수 없습니다. 레거시 profile 엔드포인트는 Spotify 전체 링크를 받아 사용자 계정 정보가 아니라 앨범 및 싱글의 스트리밍 메타데이터를 반환합니다. params 안의 url 필드로 전달하세요.
Spotify profile 액션은 어떤 필드를 반환하나요?
선언된 스키마에 포함된 필드는 name, type, release_date 및 label입니다. 선언된 필드라도 개별 레코드에는 없을 수 있으며, 다른 액션은 각각 고유한 필드 목록을 가집니다.
모든 Spotify 액션이 즉시 결과를 반환하나요?
비동기로 표시된 액션은 폴링할 작업 ID를 반환합니다. 그 밖의 모든 액션도 비동기로 실행할 수 있습니다. 요청 본문에 "mode": "async"를 추가하면 작업 ID를 즉시 받을 수 있어, 오래 걸리는 작업이나 조회 한도가 큰 요청에 유용합니다. 현재 카탈로그의 액션 구성은 sync 응답입니다.