플랫폼 가용성
- 24시간 상태
- 정상
최근 30일
제공 기능
각 SoundCloud 액션의 기능, 가격, 최근 24시간 상태를 확인할 수 있습니다. 액션을 열면 파라미터, 응답 필드, 코드 예제를 볼 수 있습니다.
| 기능 | 설명 | 1,000건당 | 24시간 상태 |
|---|---|---|---|
검색search | keyword로 SoundCloud 트랙을 검색하며, 아티스트, 장르, 태그, 재생 시간, 재생 수, 좋아요 수, 리포스트 수, 다운로드 수, 각 트랙의 라이선스를 제공합니다. | 요청 1,000개당 $1.39 | 정상 |
사용자 검색search_users | keyword로 SoundCloud 아티스트와 계정을 찾습니다. | 요청 1,000개당 $1.39 | 정상 |
플레이리스트 검색search_playlists | keyword에 맞는 SoundCloud 플레이리스트와 앨범을 찾으며, 장르, 트랙 수, 총 재생 시간, 좋아요 수, 리포스트 수, 제작자 이름과 인증 여부를 제공합니다. | 요청 1,000개당 $1.39 | 정상 |
트랙track | 링크로 SoundCloud 트랙 하나를 읽어 옵니다. | 요청 1,000개당 $1.39 | 정상 |
아티스트 상세 정보artist | 프로필 링크로 SoundCloud 아티스트나 사용자를 확인합니다. | 요청 1,000개당 $1.39 | 정상 |
플레이리스트playlist | 전체 /sets/ url로 SoundCloud 플레이리스트나 앨범을 엽니다. | 요청 1,000개당 $1.39 | 정상 |
기능을 열면 파라미터, 응답 필드, 코드 샘플을 확인하고 직접 사용해 볼 수 있습니다.
SoundCloud 액션별로 어떤 입력을 받나요?
아래 각 답변은 호출 가능한 액션 하나와 실제 입력값을 짝지어 보여 줍니다. 파라미터의 의미와 허용 값은 액션마다 다릅니다. 익숙한 이름이라도 모든 플랫폼에서 같은 의미를 갖지는 않습니다.
공식 출처 링크는 옆에 있는 플랫폼 용어를 설명하기 위한 것입니다. 플랫폼의 승인이나 보증을 의미하지 않으며, 이 페이지에 명시되지 않은 공식 사이트의 기능은 EveryInfra API에 포함되지 않습니다.
| 액션 | 필수 | 선택 | 전달 방식 | 한도 | 1,000건당 | 응답 필드 |
|---|---|---|---|---|---|---|
search검색
| keyword | — | Sync 응답 | 카탈로그 값: defaultLimit=20, maxLimit=100. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. | 요청 1,000개당 $1.39 | id · url · title · text · genre · tags · duration_sec · duration_seconds · artist_name · artist_url · artist_avatar_url · artist_follower_count · artist_verified · play_count · like_count · comment_count · repost_count · download_count · artwork_url · license · posted_at · platform |
search_users사용자 검색
| keyword | — | Sync 응답 | 카탈로그 값: defaultLimit=20, maxLimit=50. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. | 요청 1,000개당 $1.39 | id · username · name · url · bio · avatar_url · city · country · follower_count · following_count · track_count · playlist_count · like_count · is_verified · is_pro · created_at · platform |
search_playlists플레이리스트 검색
| keyword | — | Sync 응답 | 카탈로그 값: defaultLimit=20, maxLimit=50. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. | 요청 1,000개당 $1.39 | id · title · url · text · genre · track_count · duration_sec · duration_seconds · like_count · repost_count · is_album · artwork_url · artist_name · artist_url · artist_verified · posted_at · platform |
track트랙 링크로 SoundCloud 트랙 하나를 읽어 옵니다. 장르, 태그, 초 단위 재생 시간, 재생 수, 좋아요 수, 리포스트 수, 다운로드 수, 라이선스, 아티스트 정보를 받을 수 있습니다. 오디오는 다운로드하지 않습니다. 트랙에 명시된 범위를 넘는 라이선스는 부여되지 않으며, 재생 기록은 보관되지 않습니다. | url | — | Sync 응답 | — | 요청 1,000개당 $1.39 | id · url · title · text · genre · tags · duration_sec · duration_seconds · artist_name · artist_url · artist_avatar_url · artist_follower_count · artist_verified · play_count · like_count · comment_count · repost_count · download_count · artwork_url · license · posted_at · platform |
artist아티스트 상세 정보 프로필 링크로 SoundCloud 아티스트나 사용자를 확인합니다. 소개, 도시와 국가, 팔로워 수, 트랙 수와 플레이리스트 수, 인증 및 Pro 여부, 계정 생성일을 받을 수 있습니다. 신원은 검증되지 않습니다. 청취자, 수익, 비공개 분석 데이터는 제공되지 않습니다. | url | — | Sync 응답 | — | 요청 1,000개당 $1.39 | id · username · name · url · bio · avatar_url · city · country · follower_count · following_count · track_count · playlist_count · like_count · is_verified · is_pro · created_at · platform |
playlist플레이리스트 전체 /sets/ | url | keyword, query | Sync 응답 | — | 요청 1,000개당 $1.39 | id · title · url · text · genre · track_count · duration_sec · duration_seconds · like_count · repost_count · is_album · artwork_url · artist_name · artist_url · artist_verified · posted_at · platform |
SoundCloud search 파라미터는 각각 무엇을 의미하나요?
keyword로 SoundCloud 트랙을 검색하며, 아티스트, 장르, 태그, 재생 시간, 재생 수, 좋아요 수, 리포스트 수, 다운로드 수, 각 트랙의 라이선스를 제공합니다. 재생 시간은 초 단위이며, 재사용하거나 리믹스하기 전에 라이선스 필드를 확인하는 것이 좋습니다.
keyword필수- search로 트랙을, search_users로 아티스트를, search_playlists로 세트를 찾을 때 사용하는 검색어를 지정합니다. 여러 엔드포인트에서 공통으로 사용되지만 액션마다 반환하는 엔티티 유형이 다릅니다. playlist 액션에서는 /sets/ 전체 URL이 없을 때만 대체 검색어로 쓰이며, 정확한 플레이리스트 일치를 보장하지 않습니다.SoundCloud: 트랙, 사용자, 플레이리스트는 서로 다른 검색 대상이다 — SoundCloud 공식 검색 문서는 개별 오디오 트랙, 사용자 계정, 플레이리스트를 구분하며, 사용자 계정은 밴드일 수도 있고 일반 청취자일 수도 있습니다. 이러한 리소스 유형은 각각 다른 액션으로 조회합니다. SoundCloud 웹 인터페이스에 날짜, 길이, 개인화 필터가 있다고 해서 이 엔드포인트가 해당 옵션을 지원하는 것은 아닙니다. · 확인일
SoundCloud search_users 파라미터는 각각 무엇을 의미하나요?
keyword로 SoundCloud 아티스트와 계정을 찾습니다. 소개, 도시, 국가, 팔로워 수, 트랙 수와 플레이리스트 수, 인증 및 Pro 플래그를 받을 수 있습니다. 이름이 일치한다고 해서 신원이나 섭외 가능 여부가 확인되는 것은 아닙니다.
keyword필수- search로 트랙을, search_users로 아티스트를, search_playlists로 세트를 찾을 때 사용하는 검색어를 지정합니다. 여러 엔드포인트에서 공통으로 사용되지만 액션마다 반환하는 엔티티 유형이 다릅니다. playlist 액션에서는 /sets/ 전체 URL이 없을 때만 대체 검색어로 쓰이며, 정확한 플레이리스트 일치를 보장하지 않습니다.SoundCloud: 트랙, 사용자, 플레이리스트는 서로 다른 검색 대상이다 — SoundCloud 공식 검색 문서는 개별 오디오 트랙, 사용자 계정, 플레이리스트를 구분하며, 사용자 계정은 밴드일 수도 있고 일반 청취자일 수도 있습니다. 이러한 리소스 유형은 각각 다른 액션으로 조회합니다. SoundCloud 웹 인터페이스에 날짜, 길이, 개인화 필터가 있다고 해서 이 엔드포인트가 해당 옵션을 지원하는 것은 아닙니다. · 확인일
SoundCloud search_playlists 파라미터는 각각 무엇을 의미하나요?
keyword에 맞는 SoundCloud 플레이리스트와 앨범을 찾으며, 장르, 트랙 수, 총 재생 시간, 좋아요 수, 리포스트 수, 제작자 이름과 인증 여부를 제공합니다. is_album은 세트가 표시되는 방식을 반영할 뿐 공식 발매를 증명하지 않습니다.
keyword필수- search로 트랙을, search_users로 아티스트를, search_playlists로 세트를 찾을 때 사용하는 검색어를 지정합니다. 여러 엔드포인트에서 공통으로 사용되지만 액션마다 반환하는 엔티티 유형이 다릅니다. playlist 액션에서는 /sets/ 전체 URL이 없을 때만 대체 검색어로 쓰이며, 정확한 플레이리스트 일치를 보장하지 않습니다.SoundCloud: 플레이리스트, 앨범, 트랙의 소유권 경계 — SoundCloud 공식 문서에 따르면 플레이리스트는 사용자 본인 또는 다른 사용자의 트랙을 모은 컬렉션이며, 앨범이나 세트 형식으로 구성할 수 있습니다. 따라서 컬렉션을 만든 사람이 수록된 모든 트랙의 제작자라고 할 수는 없습니다. 이 엔드포인트는 컬렉션 요약을 반환하며, 공식 플레이리스트 편집 기능을 제공하지 않습니다. · 확인일
SoundCloud track 파라미터는 각각 무엇을 의미하나요?
링크로 SoundCloud 트랙 하나를 읽어 옵니다. 장르, 태그, 초 단위 재생 시간, 재생 수, 좋아요 수, 리포스트 수, 다운로드 수, 라이선스, 아티스트 정보를 받을 수 있습니다. 오디오는 다운로드하지 않습니다. 트랙에 명시된 범위를 넘는 라이선스는 부여되지 않으며, 재생 기록은 보관되지 않습니다.
전체 API 레퍼런스: 파라미터, 코드 예제, 응답 예시, 상태url필수- 대상 SoundCloud 리소스 링크를 지정합니다. track에는 트랙 URL을, artist에는 아티스트 프로필 링크(크리에이터 경로로 파싱됨)를, playlist에는 완전한 /sets/ URL을 사용하세요. playlist 액션에 플레이리스트가 아닌 링크를 전달하면 일반 검색으로 대체되어 원하는 대상 엔티티가 반환되지 않을 수 있습니다.SoundCloud: All Rights Reserved와 Creative Commons 라이선스의 차이 — SoundCloud 공식 라이선스 문서는 All Rights Reserved와 여러 Creative Commons 조건을 구분합니다. `license` 필드는 권리를 확인하기 위한 지표일 뿐, 상업적 이용이나 재사용을 일괄 허가하는 것이 아닙니다. 구체적인 후속 이용 가능 여부는 해당 라이선스 조건에 따라 판단해야 합니다. · 확인일
SoundCloud artist 파라미터는 각각 무엇을 의미하나요?
프로필 링크로 SoundCloud 아티스트나 사용자를 확인합니다. 소개, 도시와 국가, 팔로워 수, 트랙 수와 플레이리스트 수, 인증 및 Pro 여부, 계정 생성일을 받을 수 있습니다. 신원은 검증되지 않습니다. 청취자, 수익, 비공개 분석 데이터는 제공되지 않습니다.
전체 API 레퍼런스: 파라미터, 코드 예제, 응답 예시, 상태url필수- 대상 SoundCloud 리소스 링크를 지정합니다. track에는 트랙 URL을, artist에는 아티스트 프로필 링크(크리에이터 경로로 파싱됨)를, playlist에는 완전한 /sets/ URL을 사용하세요. playlist 액션에 플레이리스트가 아닌 링크를 전달하면 일반 검색으로 대체되어 원하는 대상 엔티티가 반환되지 않을 수 있습니다.SoundCloud: 프로필에는 아티스트, 밴드, 청취자가 모두 포함된다 — SoundCloud의 Profiles/People 카테고리에는 뮤지션, 밴드, 크리에이터, 일반 청취자가 포함됩니다. `artist` 액션 이름은 게이트웨이의 액션 식별자일 뿐이며, 임의의 프로필을 전문 아티스트로 인증하지 않습니다. · 확인일
SoundCloud playlist 파라미터는 각각 무엇을 의미하나요?
전체 /sets/ url로 SoundCloud 플레이리스트나 앨범을 엽니다. 설명, 장르, 트랙 수, 총 재생 시간, 좋아요 수, 리포스트 수를 받을 수 있습니다. 다른 링크를 전달하면 keyword 또는 query로 검색하는 방식으로 대체됩니다. 이 검색이 원하는 세트를 찾지 못할 수 있습니다.
url필수- 대상 SoundCloud 리소스 링크를 지정합니다. track에는 트랙 URL을, artist에는 아티스트 프로필 링크(크리에이터 경로로 파싱됨)를, playlist에는 완전한 /sets/ URL을 사용하세요. playlist 액션에 플레이리스트가 아닌 링크를 전달하면 일반 검색으로 대체되어 원하는 대상 엔티티가 반환되지 않을 수 있습니다.SoundCloud: 컬렉션 요약과 상세 트랙 목록은 다르다 — SoundCloud 공식 문서는 플레이리스트를 트랙 컬렉션으로 설명하고 앨범이나 세트 형식으로 변경하는 방법을 안내합니다. 이 참고 자료는 객체 관계만 정의합니다. 이 엔드포인트는 `tracks` 상세 배열을 반환하지 않으며, SoundCloud 공식 플레이리스트 저장 한도가 이 엔드포인트의 출력 수량을 보장하지는 않습니다. · 확인일
keyword선택- search로 트랙을, search_users로 아티스트를, search_playlists로 세트를 찾을 때 사용하는 검색어를 지정합니다. 여러 엔드포인트에서 공통으로 사용되지만 액션마다 반환하는 엔티티 유형이 다릅니다. playlist 액션에서는 /sets/ 전체 URL이 없을 때만 대체 검색어로 쓰이며, 정확한 플레이리스트 일치를 보장하지 않습니다.
query선택- playlist 액션의 보조 대체 검색어로, keyword보다 우선순위가 낮습니다. 이 파라미터를 전달해도 url은 여전히 필수입니다.
SoundCloud 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":"soundcloud","action":"search","params":{"keyword":"<keyword>"}}'
SoundCloud API 자주 묻는 질문
SoundCloud API로 무엇을 가져올 수 있나요?
platform을 soundcloud 값으로 설정하세요. 현재 카탈로그에 등록된 항목은 검색, 사용자 검색, 플레이리스트 검색, 트랙, 아티스트 상세 정보 및 more입니다. 각 액션 이름은 서로 다른 SoundCloud 객체나 뷰를 가리키며, 서로 바꿔 쓸 수 있는 검색 모드가 아닙니다.
SoundCloud search 요청에는 어떤 입력이 필요한가요?
search로 트랙을, search_users로 아티스트를, search_playlists로 세트를 찾을 때 사용하는 검색어를 지정합니다. 여러 엔드포인트에서 공통으로 사용되지만 액션마다 반환하는 엔티티 유형이 다릅니다. playlist 액션에서는 /sets/ 전체 URL이 없을 때만 대체 검색어로 쓰이며, 정확한 플레이리스트 일치를 보장하지 않습니다. params 안의 keyword 필드로 전달하세요.
SoundCloud search 액션은 어떤 필드를 반환하나요?
선언된 스키마에 포함된 필드는 title, text, genre 및 tags입니다. 선언된 필드라도 개별 레코드에는 없을 수 있으며, 다른 액션은 각각 고유한 필드 목록을 가집니다.
모든 SoundCloud 액션이 즉시 결과를 반환하나요?
비동기로 표시된 액션은 폴링할 작업 ID를 반환합니다. 그 밖의 모든 액션도 비동기로 실행할 수 있습니다. 요청 본문에 "mode": "async"를 추가하면 작업 ID를 즉시 받을 수 있어, 오래 걸리는 작업이나 조회 한도가 큰 요청에 유용합니다. 현재 카탈로그의 액션 구성은 sync 응답입니다.