플랫폼 가용성
- 24시간 상태
- 정상
최근 30일
제공 기능
각 NetEase Cloud Music 액션의 기능, 가격, 최근 24시간 상태를 확인할 수 있습니다. 액션을 열면 파라미터, 응답 필드, 코드 예제를 볼 수 있습니다.
기능을 열면 파라미터, 응답 필드, 코드 샘플을 확인하고 직접 사용해 볼 수 있습니다.
NetEase Cloud Music 액션별로 어떤 입력을 받나요?
아래 각 답변은 호출 가능한 액션 하나와 실제 입력값을 짝지어 보여 줍니다. 파라미터의 의미와 허용 값은 액션마다 다릅니다. 익숙한 이름이라도 모든 플랫폼에서 같은 의미를 갖지는 않습니다.
공식 출처 링크는 옆에 있는 플랫폼 용어를 설명하기 위한 것입니다. 플랫폼의 승인이나 보증을 의미하지 않으며, 이 페이지에 명시되지 않은 공식 사이트의 기능은 EveryInfra API에 포함되지 않습니다.
| 액션 | 필수 | 선택 | 전달 방식 | 한도 | 1,000건당 | 응답 필드 |
|---|---|---|---|---|---|---|
toplist음악 차트 NetEase Cloud Music 차트의 트랙을 가져옵니다. 각 트랙에는 순위, 아티스트, 앨범, 재생 시간, 인기 점수가 포함되며, 차트 이름, 재생 수, 최근 업데이트 시각도 함께 제공됩니다. | — | Sync 응답 | 카탈로그 값: defaultLimit=20, maxLimit=100. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. | 요청 1,000개당 $0.56 | rank · track_id · track_name · track_alias · duration_ms · artists · artist_ids · album_id · album_name · album_cover_url · published_at · is_explicit · popularity_score · track_url · playlist_id · playlist_name · playlist_type · playlist_cover_url · playlist_track_count · playlist_play_count · playlist_subscribed_count · playlist_updated_at · snapshotted_at · platform | |
playlist플레이리스트
| playlist_id | — | Sync 응답 | 카탈로그 값: defaultLimit=20, maxLimit=100. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. | 요청 1,000개당 $0.56 | rank · track_id · track_name · track_alias · duration_ms · artists · artist_ids · album_id · album_name · album_cover_url · published_at · is_explicit · popularity_score · track_url · playlist_id · playlist_name · playlist_type · playlist_cover_url · playlist_track_count · playlist_play_count · playlist_subscribed_count · playlist_updated_at · snapshotted_at · platform |
comments댓글
| song_id | sort | Sync 응답 | 카탈로그 값: defaultLimit=50, maxLimit=1000. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. 더 큰 limit도 허용되지만 최대 1000까지만 적용됩니다. | 요청 1,000개당 $0.56 | id · song_id · song_name · url · text · like_count · reply_count · is_hot · is_reply · parent_comment_id · author_name · author_avatar_url · posted_at · platform |
NetEase Cloud Music toplist 파라미터는 각각 무엇을 의미하나요?
NetEase Cloud Music 차트의 트랙을 가져옵니다. 각 트랙에는 순위, 아티스트, 앨범, 재생 시간, 인기 점수가 포함되며, 차트 이름, 재생 수, 최근 업데이트 시각도 함께 제공됩니다. popularity_score는 0부터 100까지의 값으로 재생 수가 아닙니다. rank는 해당 시점의 스냅샷에만 적용됩니다.
이 액션에는 비즈니스 파라미터가 없습니다. 플랫폼과 액션 식별자만 보내면 됩니다.
NetEase Cloud Music playlist 파라미터는 각각 무엇을 의미하나요?
playlist_id 또는 링크로 NetEase Cloud Music 플레이리스트의 트랙을 순서대로 나열하며, 각 트랙의 아티스트, 앨범, 재생 시간, 발매일을 제공합니다. 재생 시간은 밀리초 단위이며, 목록에 있는 트랙이 모든 지역에서 재생된다는 보장은 없습니다.
playlist_id필수- playlist 액션에 사용할 NetEase Cloud Music 플레이리스트 ID를 지정합니다. 숫자 플레이리스트 ID 또는 playlist?id=나 /playlist/ID가 포함된 URL을 받습니다. 곡 ID와는 별개이며 toplist 액션에서는 사용하지 않습니다.NetEase Cloud Music: 차트 컨테이너와 곡별 내부 링크 — NetEase Cloud Music 공식 차트 페이지는 차트와 곡 목록을 구분하며, 각 트랙은 고유한 `song?id=` 링크를 사용합니다. 여기서 `playlist_id`는 플레이리스트 또는 차트 컨테이너를, `song_id`는 트랙을 식별합니다. 차트 페이지가 있다고 해서 API가 전체 또는 실시간으로 커버한다는 의미는 아닙니다. · 확인일
NetEase Cloud Music comments 파라미터는 각각 무엇을 의미하나요?
song_id 또는 곡 링크로 NetEase Cloud Music 곡의 댓글을 가져옵니다. 좋아요 수, 답글 수, 인기 댓글 플래그, 각 답글의 상위 댓글을 받을 수 있습니다. 정렬은 hot(기본값), recommend, time을 지원합니다. 고정 댓글은 정렬 순서와 관계없이 표시될 수 있습니다.
song_id필수- comments 액션에 사용할 NetEase Cloud Music 곡 ID를 지정합니다. 숫자 곡 ID 또는 song?id=나 /song/ID가 포함된 URL을 받습니다. 곡 ID 대신 플레이리스트 ID를 사용할 수 없습니다.NetEase Cloud Music: 댓글 조회는 차트가 아닌 곡을 대상으로 해야 한다 — 공식 차트의 곡 목록은 각 곡 페이지로 연결되며, 이를 통해 곡과 차트가 별개의 객체임을 확인할 수 있습니다. 이 출처는 댓글 정렬이나 답글 범위를 설명하지 않으며, 이는 위에 문서화된 파라미터를 따릅니다. · 확인일
sort선택- comments 액션의 곡 댓글을 정렬합니다. 지원 값은 hot(기본값), recommend, time입니다. 호환용 별칭인 latest와 new는 time 정렬로 처리됩니다. newest는 지원하지 않으며 hot으로 대체됩니다. 정렬 방식과 관계없이 상단 고정 댓글이 결과에 포함될 수 있습니다.
NetEase Cloud Music 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":"netease_music","action":"toplist","params":{}}'
NetEase Cloud Music API 자주 묻는 질문
NetEase Cloud Music API로 무엇을 가져올 수 있나요?
platform을 netease_music 값으로 설정하세요. 현재 카탈로그에 등록된 항목은 음악 차트, 플레이리스트 및 댓글입니다. 각 액션 이름은 서로 다른 NetEase Cloud Music 객체나 뷰를 가리키며, 서로 바꿔 쓸 수 있는 검색 모드가 아닙니다.
NetEase Cloud Music toplist 요청에는 어떤 입력이 필요한가요?
toplist 액션에는 필수 비즈니스 입력이 없습니다. 플랫폼과 액션 식별자, 그리고 필요한 선택 파라미터만 전달하세요.
NetEase Cloud Music toplist 액션은 어떤 필드를 반환하나요?
선언된 스키마에 포함된 필드는 rank, track_id, track_name 및 track_alias입니다. 선언된 필드라도 개별 레코드에는 없을 수 있으며, 다른 액션은 각각 고유한 필드 목록을 가집니다.
모든 NetEase Cloud Music 액션이 즉시 결과를 반환하나요?
비동기로 표시된 액션은 폴링할 작업 ID를 반환합니다. 그 밖의 모든 액션도 비동기로 실행할 수 있습니다. 요청 본문에 "mode": "async"를 추가하면 작업 ID를 즉시 받을 수 있어, 오래 걸리는 작업이나 조회 한도가 큰 요청에 유용합니다. 현재 카탈로그의 액션 구성은 sync 응답입니다.