# NetEase Cloud Music Song, Chart & Playlist Scraper (`dataspryva/netease-cloud-music-song-chart-and-playlist`) Actor

Search NetEase Cloud Music songs, fetch song details by URL, pull an artist's top songs or album list, browse playlists by genre, or get any top-100 chart. Returns artist, album, duration, cover art, and popularity for each track.

- **URL**: https://apify.com/dataspryva/netease-cloud-music-song-chart-and-playlist.md
- **Developed by:** [Dataspryva](https://apify.com/dataspryva) (community)
- **Categories:** Automation, Developer tools, Social media
- **Security:** Limited permissions
- **Stats:** 3 total users, 2 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.49 / 1,000 results

This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## NetEase Cloud Music Scraper: Songs, Charts & Comments

NetEase Cloud Music (网易云音乐) is one of China's largest music streaming catalogs. This actor reads its public catalog without an account: search songs, albums, artists and playlists; pull song details with full LRC, translated, romanized and word-by-word lyrics; walk an artist's complete discography; read album and playlist tracklists; collect every current chart; and export comments with optional replies. No login, cookies, API keys or proxy setup.

### What this actor does

- **Ten modes:** `search`, `bySongUrl`, `byArtist`, `byArtistAlbums`, `byAlbum`, `byPlaylist`, `byPlaylistUrl`, `byToplist`, `toplists`, `comments`.
- **Catalog search:** songs, albums, artists and playlists through NetEase's modern search endpoint, with popularity and duration included.
- **Lyrics:** full LRC plus translation, romanization and word-by-word lyrics whenever NetEase publishes them.
- **Playlists and charts:** complete tracklists from `trackIds`, including each track's playlist rank and the time it was added.
- **Comments:** recommended or hot comments for songs, albums, playlists and charts, with an optional reply floor.
- **Clean output:** empty fields are omitted; invalid or unavailable inputs become explicit `error` records instead of disappearing.

### Services

- **Music catalog lookup** — song, album, artist and playlist search.
- **Song enrichment** — release dates, quality tiers, maximum bitrate, music-video links and full lyric variants.
- **Artist intelligence** — full song catalogue, album catalogue, profile biography, images, ranks, identities and fan count.
- **Playlist and chart coverage** — 70 live playlist categories, all 65 current charts, chart positions and rank movement where NetEase publishes it.
- **Audience research** — comment text, likes, timestamps, authors, avatars, IP locations and replies.

### How it works

The actor reads NetEase Cloud Music's public web catalog anonymously. Each mode calls the matching public catalog, lyric, chart or comment view and converts the response into flat, readable records. When NetEase responds with a verification challenge instead of data, the actor keeps the run alive by switching to a working connection automatically and continues from the same page. Runs stop on the requested item cap or when NetEase runs out of matching results — never on a fixed time limit.

### Input

| Field | Type | Default | Description |
|---|---|---|---|
| `mode` | string | `search` | One of the ten modes listed above |
| `searchQueries` | array | `["周杰伦"]` | Queries for `search` |
| `searchType` | string | `song` | `song`, `album`, `artist` or `playlist` |
| `songUrls` | array | – | Song URLs or bare IDs for `bySongUrl` |
| `artistIds` | array | – | Artist IDs, URLs or exact names for `byArtist` / `byArtistAlbums` |
| `artistOrder` | string | `hot` | `hot` or `time` for an artist's songs |
| `albumUrls` | array | – | Album URLs or IDs for `byAlbum` |
| `playlistUrls` | array | – | Playlist URLs or IDs for `byPlaylistUrl` |
| `playlistCat` | string | `华语` | 70 NetEase categories plus `全部` for `byPlaylist` |
| `toplistIds` | array | – | Chart IDs, names or URLs for `byToplist`; `all` or empty scans every chart |
| `maxTracksPerChart` | int | `0` | Tracks per chart; `0` reads all |
| `commentUrls` | array | – | Song/album/playlist/chart URLs or IDs for `comments` |
| `commentOrder` | string | `recommended` | `recommended` or `hot` |
| `maxCommentsPerItem` | int | `100` | Top-level comments per resource (1–1,100) |
| `includeReplies` | boolean | `false` | Also read reply floors |
| `maxRepliesPerComment` | int | `20` | Replies read per comment |
| `includeArtistProfile` | boolean | `false` | Emit an artist profile record |
| `includeLyrics` | boolean | `false` | Attach every available lyric variant |
| `includeAlbumTracks` | boolean | `true` | Emit album tracks as songs |
| `includePlaylistTracks` | boolean | `true` | Emit the complete playlist tracklist |
| `includeToplistInfo` | boolean | `true` | Emit a chart summary before tracks |
| `minDurationSec` / `maxDurationSec` | int | – | Song duration window; metadata records are unaffected |
| `minPopularity` | int | – | Song popularity floor (0–100) |
| `minPlayCount` / `minTrackCount` | int | – | Playlist browse filters |
| `containsKeyword` | string | – | Name must contain this text (case-insensitive) |
| `maxItems` | int | `100` | Hard cap on all dataset records, including errors (1–100,000) |

#### Example: search songs

```json
{
  "mode": "search",
  "searchQueries": ["周杰伦", "晴天"],
  "searchType": "song",
  "maxItems": 50
}
```

#### Example: song details with every lyric variant

```json
{
  "mode": "bySongUrl",
  "songUrls": ["https://music.163.com/#/song?id=186016"],
  "includeLyrics": true,
  "maxItems": 1
}
```

#### Example: a complete playlist with added-at timestamps

```json
{
  "mode": "byPlaylistUrl",
  "playlistUrls": ["https://music.163.com/#/playlist?id=8803637201"],
  "includePlaylistTracks": true,
  "maxItems": 500
}
```

#### Example: all current charts, first 20 tracks each

```json
{
  "mode": "byToplist",
  "toplistIds": ["all"],
  "maxTracksPerChart": 20,
  "includeToplistInfo": true,
  "maxItems": 1000
}
```

#### Example: hot comments with replies

```json
{
  "mode": "comments",
  "commentUrls": ["https://music.163.com/#/song?id=186016"],
  "commentOrder": "hot",
  "maxCommentsPerItem": 100,
  "includeReplies": true,
  "maxRepliesPerComment": 10,
  "maxItems": 200
}
```

### Output

Every record carries `recordType`, `sourceUrl` and `scrapedAt` (UTC ISO). Empty fields are omitted at every depth.

#### Song (`recordType: "song"`)

- `songId`, `name`, `alias[]`, `transName`
- `artists[]`, `artist`, `albumId`, `album`, `coverUrl`
- `durationSec`, `popularity`, `score`, `playedNum`, `starredNum`
- `fee`, `copyright`, `copyrightId`, `single`
- `mvid`, `mvUrl`, `disc`, `trackNo`, `position`
- `publishTimeMs`, `publishDate`, `commentThreadId`
- `availableQualities[]`, `maxBitrateKbps`
- `lyric`, `lyricTranslation`, `lyricRomanization`, `lyricWordByWord`, `lyricCredit`
- `rankPosition`, `chartId`, `chartName`, `previousRank`, `rankChange`
- `playlistId`, `playlistName`, `addedToPlaylistAt`
- `mp3Url` only when NetEase exposes a valid HTTPS source value

#### Album (`recordType: "album"`)

`albumId`, `name`, `coverUrl`, `trackCount`, `publishTimeMs`, `publishDate`, `company`, `type`, `subType`, `paid`, `onSale`, `artists[]`, `artist`, `description`, `commentThreadId`, `albumUrl`, `sourceUrl`.

#### Artist (`recordType: "artist"`)

`artistId`, `name`, `alias[]`, `transNames[]`, `briefDesc`, `avatarUrl`, `coverUrl`, `picUrl`, `albumSize`, `musicSize`, `mvSize`, `videoCount`, `fansCount`, `fansSize`, `rank`, `identities[]`, `sourceUrl`.

#### Playlist (`recordType: "playlist"`)

`playlistId`, `name`, `coverUrl`, `playCount`, `trackCount`, `totalDurationMs`, `creatorName`, `creatorId`, `creatorAvatarUrl`, `tags[]`, `description`, `updateTimeMs`, `createTimeMs`, `commentThreadId`, `playlistType`, `privacy`, `updateFrequency`, `sourceUrl`.

#### Chart summary (`recordType: "toplist"`)

`toplistId`, `name`, `englishTitle`, `coverUrl`, `description`, `playCount`, `trackCount`, `subscribedCount`, `updateFrequency`, `commentThreadId`, `createTimeMs`, `publishDate`, `specialType`, `playlistType`, `sourceUrl`.

#### Comment (`recordType: "comment"`)

`commentId`, `parentCommentId`, `content`, `likedCount`, `createdAt`, `createdAtMs`, `authorNickname`, `authorUserId`, `authorAvatarUrl`, `ipLocation`, `isHot`, `replyCount`, `repliedToCommentId`, `repliedToUser`, `repliedToContent`, `threadId`, `resourceType`, `resourceId`, `sourceUrl`.

#### Error (`recordType: "error"`)

`errorCode`, `errorMessage`, `inputValue` — emitted for an input that could not be parsed or found. Error records count toward `maxItems`, so a partially valid list still returns every usable record alongside clear failures.

### Use cases

- Build a searchable NetEase catalog slice for a genre, artist or mood.
- Export synchronized, translated and romanized lyrics for language or music research.
- Track chart positions and rank movement over time.
- Audit a playlist's full running order and when each track was added.
- Study listener sentiment and fan culture through comments and replies.
- Mirror an artist's complete discography and album metadata into a local database.

### Usage cost

NetEase access is free and needs no subscription. You pay for the Apify run itself and the actor's Store price, which is shown on the listing. A small search run costs a fraction of a cent; large playlist, chart or comment runs cost more because they process more records. The daily prefill is deliberately tiny (`search`, one query, three records).

### FAQ

**Do I need a NetEase account, cookie or API key?**
No. Every mode reads public data anonymously. Nothing in the input asks for credentials.

**Do I need to configure a proxy?**
No. The actor chooses a working connection automatically. Just fill in the input and run it.

**Why do comments stop before the total shown on NetEase?**
NetEase's public comment pages stop around 1,100 comments per resource. The actor reads up to 1,100 top-level comments, then stops with a note instead of pretending the rest are available.

**Why do only a few songs show `previousRank` and `rankChange`?**
NetEase publishes rank movement for the first six preview tracks of each chart. Every track still gets its current `rankPosition`; the comparison fields are omitted when the source has no previous rank.

**Why are translation, romanization or word-by-word lyrics missing on some songs?**
NetEase provides those variants only for some tracks. The main LRC is usually present; the other variants are added only when NetEase publishes them.

**Can I get an artist's entire catalog, not just top songs?**
Yes. `byArtist` paginates the full song catalog, and `byArtistAlbums` walks every album. Set `includeArtistProfile` to add a profile record.

**Can I search in Chinese and English?**
Yes. Search queries, artist names and chart names accept Chinese, English and mixed text.

**What happened to the old `playlistOrder: "new"` option?**
NetEase no longer serves a newest-first playlist listing; it returns nothing for every category. The setting is accepted for old saved tasks but is ignored, and the run says so in its status message.

**Is the data live?**
Yes. Each run reads NetEase at run time, so chart positions, play counts and comments reflect the moment of the run.

### Notes

- Bare numeric IDs are accepted alongside music.163.com URLs.
- For comments, a bare ID is treated as a song; use `album:123`, `playlist:123` or `chart:123` when the ID belongs to another resource.
- `toplistIds: ["all"]` or an empty list scans every chart currently published by NetEase.
- Legacy saved inputs (`searchQuery`, `artistId`, `artistName`, `toplistId`, `includeLyric`, `playlistOrder`) continue to work without being shown in the input form.
- API callers can pass a `modes` array (for example `["bySongUrl","byArtist"]`) to run several modes in one run; the console's single `mode` field remains the normal path.
- The chart catalogue is served live when available and falls back to the built-in 65-chart list if NetEase withholds it.
- Song records include a valid `mp3Url` only when NetEase exposes one; the actor does not download audio.

### Limitations

- Comment pagination is capped around 1,100 per resource by NetEase; time-ordered ("newest") comments are not exposed by the public API.
- `previousRank` and `rankChange` exist only for the top six preview tracks of a chart.
- The newest-first playlist browse sort is no longer available upstream.
- Translation, romanization and word-by-word lyrics are conditional on NetEase publishing them.
- Playback/audio URLs are signed and can expire, so audio download is out of scope.
- A temporary NetEase verification challenge can add latency while the actor switches connections; it does not produce an empty run.

# Actor input Schema

## `mode` (type: `string`):

What to fetch. Each mode reads its own list field.

## `searchQueries` (type: `array`):

Free-text queries (mode=search). One or more artist, song, album or playlist names.

## `searchType` (type: `string`):

Which catalog entity to search for (mode=search).

## `songUrls` (type: `array`):

music.163.com song URLs or bare song IDs, e.g. 186016.

## `artistIds` (type: `array`):

Artist IDs, music.163.com artist URLs, or exact artist names.

## `artistOrder` (type: `string`):

Order the artist's song catalogue by popularity or release time (mode=byArtist).

## `albumUrls` (type: `array`):

music.163.com album URLs or bare album IDs.

## `playlistUrls` (type: `array`):

music.163.com playlist URLs or bare playlist IDs. Full tracklists are read.

## `playlistCat` (type: `string`):

NetEase playlist genre, scene or mood to browse (mode=byPlaylist).

## `toplistIds` (type: `array`):

Chart IDs, music.163.com toplist URLs, or Chinese/English chart names. Use `all` or leave empty for every current chart.

## `maxTracksPerChart` (type: `integer`):

Limit tracks read from each chart before the global max items cap (mode=byToplist). 0 reads every track.

## `commentUrls` (type: `array`):

Song, album, playlist or chart URLs/IDs. A bare ID is treated as a song; use `album:123`, `playlist:123` or `chart:123` to be explicit.

## `commentOrder` (type: `string`):

Recommended comments or NetEase's hot-comment selection (mode=comments).

## `maxCommentsPerItem` (type: `integer`):

Maximum top-level comments read per song, album, playlist or chart (mode=comments). NetEase stops anonymous pagination around 1,100.

## `includeReplies` (type: `boolean`):

Fetch the reply floor for comments that have replies (mode=comments).

## `maxRepliesPerComment` (type: `integer`):

How many replies to read for each comment when replies are enabled (mode=comments).

## `includeArtistProfile` (type: `boolean`):

Emit one artist profile record with bio, images, sizes, rank, identities and fan count (mode=byArtist / byArtistAlbums).

## `includeLyrics` (type: `boolean`):

Attach full LRC lyrics plus translation, romanization and word-by-word lyrics when NetEase has them (every song mode).

## `includeAlbumTracks` (type: `boolean`):

Emit each album's tracks as song records (mode=byAlbum).

## `includePlaylistTracks` (type: `boolean`):

Emit the playlist's full tracklist as song records (mode=byPlaylistUrl).

## `includeToplistInfo` (type: `boolean`):

Emit a chart summary record before each chart's tracks (mode=byToplist).

## `minDurationSec` (type: `integer`):

Skip song records shorter than this. Album, artist, playlist and chart metadata are unaffected.

## `maxDurationSec` (type: `integer`):

Skip song records longer than this. Album, artist, playlist and chart metadata are unaffected.

## `minPopularity` (type: `integer`):

Skip song records below this NetEase popularity score (0-100). Metadata records are unaffected.

## `minPlayCount` (type: `integer`):

Skip browsed playlists with fewer plays (mode=byPlaylist).

## `minTrackCount` (type: `integer`):

Skip browsed playlists with fewer tracks (mode=byPlaylist).

## `containsKeyword` (type: `string`):

Keep only records whose name contains this text (case-insensitive). Applies to songs, albums, artists, playlists and charts.

## `maxItems` (type: `integer`):

Hard cap on total dataset records for the run, including error records.

## Actor input object example

```json
{
  "mode": "search",
  "searchQueries": [
    "周杰伦"
  ],
  "searchType": "song",
  "songUrls": [],
  "artistIds": [],
  "artistOrder": "hot",
  "albumUrls": [],
  "playlistUrls": [],
  "playlistCat": "华语",
  "toplistIds": [],
  "maxTracksPerChart": 0,
  "commentUrls": [],
  "commentOrder": "recommended",
  "maxCommentsPerItem": 100,
  "includeReplies": false,
  "maxRepliesPerComment": 20,
  "includeArtistProfile": false,
  "includeLyrics": false,
  "includeAlbumTracks": true,
  "includePlaylistTracks": true,
  "includeToplistInfo": true,
  "maxItems": 3
}
```

# Actor output Schema

## `items` (type: `string`):

Dataset containing song, album, artist, playlist, toplist, comment and error records.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "mode": "search",
    "searchQueries": [
        "周杰伦"
    ],
    "searchType": "song",
    "songUrls": [],
    "artistIds": [],
    "artistOrder": "hot",
    "albumUrls": [],
    "playlistUrls": [],
    "playlistCat": "华语",
    "toplistIds": [],
    "maxTracksPerChart": 0,
    "commentUrls": [],
    "commentOrder": "recommended",
    "maxCommentsPerItem": 100,
    "includeReplies": false,
    "maxRepliesPerComment": 20,
    "includeArtistProfile": false,
    "includeLyrics": false,
    "includeAlbumTracks": true,
    "includePlaylistTracks": true,
    "includeToplistInfo": true,
    "maxItems": 3
};

// Run the Actor and wait for it to finish
const run = await client.actor("dataspryva/netease-cloud-music-song-chart-and-playlist").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "mode": "search",
    "searchQueries": ["周杰伦"],
    "searchType": "song",
    "songUrls": [],
    "artistIds": [],
    "artistOrder": "hot",
    "albumUrls": [],
    "playlistUrls": [],
    "playlistCat": "华语",
    "toplistIds": [],
    "maxTracksPerChart": 0,
    "commentUrls": [],
    "commentOrder": "recommended",
    "maxCommentsPerItem": 100,
    "includeReplies": False,
    "maxRepliesPerComment": 20,
    "includeArtistProfile": False,
    "includeLyrics": False,
    "includeAlbumTracks": True,
    "includePlaylistTracks": True,
    "includeToplistInfo": True,
    "maxItems": 3,
}

# Run the Actor and wait for it to finish
run = client.actor("dataspryva/netease-cloud-music-song-chart-and-playlist").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "mode": "search",
  "searchQueries": [
    "周杰伦"
  ],
  "searchType": "song",
  "songUrls": [],
  "artistIds": [],
  "artistOrder": "hot",
  "albumUrls": [],
  "playlistUrls": [],
  "playlistCat": "华语",
  "toplistIds": [],
  "maxTracksPerChart": 0,
  "commentUrls": [],
  "commentOrder": "recommended",
  "maxCommentsPerItem": 100,
  "includeReplies": false,
  "maxRepliesPerComment": 20,
  "includeArtistProfile": false,
  "includeLyrics": false,
  "includeAlbumTracks": true,
  "includePlaylistTracks": true,
  "includeToplistInfo": true,
  "maxItems": 3
}' |
apify call dataspryva/netease-cloud-music-song-chart-and-playlist --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,dataspryva/netease-cloud-music-song-chart-and-playlist"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/vXYLnAW7cJHKOW6xQ/builds/OBp2YCjuqgFzas3t0/openapi.json