OrbTop

NetEase Cloud Music — Toplist & Playlist Scraper

SOCIAL MEDIAFOR CREATORS

NetEase Cloud Music — Toplist & Playlist Scraper

Scrapes track rankings and metadata from NetEase Cloud Music (网易云音乐) toplists and playlists using the public API. Returns playlist info, rank positions, artist/album metadata, and popularity scores — no login required.

What This Scraper Does

NetEase Cloud Music is one of China's two dominant streaming platforms (~600M MAU). This actor uses the unsigned public legacy API (/api/playlist/detail) to pull ranked track data from official toplists — 飙升榜 (Hot Rise), 新歌榜 (New Songs), 原创榜 (Original), 热歌榜 (Hot Songs), and 10+ others — as well as any user-supplied playlist ID.

Each run returns one flat record per track with full playlist context, making the output ready for chart analysis, playlist migration tooling, or music-licensing research.

Key Features

  • Covers 14 built-in official toplists by default (no configuration needed)
  • Accepts a custom list of playlist IDs to scrape arbitrary public playlists
  • Returns playlist-level stats (play count, subscriber count, cover URL) alongside every track record
  • Rank position within each playlist is included as rankPosition (1-indexed)
  • Multi-artist tracks are pipe-separated in artists and artistIds
  • No authentication, no captcha, no proxy required

Input

Field Type Default Description
maxItems integer 10 Maximum number of track records to return across all playlists
playlistIds array [] List of NetEase playlist IDs. Leave empty to use all built-in toplists

Example Input

{
    "maxItems": 500,
    "playlistIds": [3779629, 19723756, 3778678]
}

Leave playlistIds empty to scrape all 14 built-in official toplists (~1,400 records total, one per track).

Output

Each record in the dataset represents one track in one playlist:

{
    "playlistId": 3779629,
    "playlistName": "飙升榜",
    "playlistType": "toplist",
    "playlistCoverUrl": "https://p3.music.126.net/...",
    "playlistTrackCount": 100,
    "playlistPlayCount": 3197395200,
    "playlistSubscribedCount": 2797359,
    "playlistUpdatedAt": "2026-06-01T00:10:00.510Z",
    "rankPosition": 1,
    "trackId": 3382908505,
    "trackName": "玻璃",
    "trackAlias": null,
    "durationMs": 185040,
    "artists": "Gareth.T",
    "artistIds": "32944030",
    "albumId": 376798712,
    "albumName": "玻璃",
    "albumCoverUrl": "http://p4.music.126.net/...",
    "publishTimeMs": 1779206400000,
    "trackShareUrl": "https://music.163.com/song?id=3382908505",
    "isExplicit": false,
    "popularityScore": 100,
    "snapshottedAt": "2026-06-01T17:38:08.095Z"
}

Use Cases

  • Music-licensing research — identify trending Chinese tracks with artist/album attribution
  • A&R scouting — monitor chart movers across 14 official NetEase toplists
  • Playlist migration — extract track IDs for cross-platform mapping to Spotify/Apple Music via ISRC
  • Chart analytics — track popularity scores and rank shifts over time with periodic runs

Built-in Toplists

Playlist ID Name Description
3779629 飙升榜 Hot Rise Chart
19723756 新歌榜 New Songs Chart
3778678 原创榜 Original Chart
2884035 云音乐热歌榜 Hot Song Chart
3778679 云音乐飙升榜 Rise Chart
71384707 云音乐新歌榜 New Music Chart
10520166 抖音排行榜 Douyin/TikTok Chart
745956260 云音乐国际榜 International Chart
991319590 云音乐说唱榜 Hip-Hop Chart
180106 云音乐ACG音乐榜 ACG Chart
60198 云音乐韩语榜 Korean Chart
3812895 云音乐粤语榜 Cantonese Chart
1978921795 云音乐摇滚榜 Rock Chart
2006421348 云音乐民谣榜 Folk Chart

Technical Notes

The actor calls the unsigned public legacy API endpoint (/api/playlist/detail?id=<id>). Each playlist returns up to 100 tracks in a single response. No authentication is required. Modern /weapi/* encrypted endpoints are intentionally avoided.