Dataspryva
Actors/NetEase Cloud Music Song, Chart & Playlist Scraper

NetEase Cloud Music Song, Chart & Playlist Scraper

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.

Open on ApifyGitHub source

Input schema

Input fields, types, required flags, descriptions, defaults, and prefills come from the published definition. Prefill examples are distinct from defaults.

FieldTypeRequiredDescription
modestringrequiredWhat to fetch. Each mode reads its own list field.
searchQueriesarrayoptionalFree-text queries (mode=search). One or more artist, song, album or playlist names.
searchTypestringoptionalWhich catalog entity to search for (mode=search).
Show all input fields
FieldTypeRequiredDescription
modestringrequiredWhat to fetch. Each mode reads its own list field.
searchQueriesarrayoptionalFree-text queries (mode=search). One or more artist, song, album or playlist names.
searchTypestringoptionalWhich catalog entity to search for (mode=search).
songUrlsarrayoptionalmusic.163.com song URLs or bare song IDs, e.g. 186016.
artistIdsarrayoptionalArtist IDs, music.163.com artist URLs, or exact artist names.
artistOrderstringoptionalOrder the artist's song catalogue by popularity or release time (mode=byArtist).
albumUrlsarrayoptionalmusic.163.com album URLs or bare album IDs.
playlistUrlsarrayoptionalmusic.163.com playlist URLs or bare playlist IDs. Full tracklists are read.
playlistCatstringoptionalNetEase playlist genre, scene or mood to browse (mode=byPlaylist).
toplistIdsarrayoptionalChart IDs, music.163.com toplist URLs, or Chinese/English chart names. Use `all` or leave empty for every current chart.
maxTracksPerChartintegeroptionalLimit tracks read from each chart before the global max items cap (mode=byToplist). 0 reads every track.
commentUrlsarrayoptionalSong, 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.
commentOrderstringoptionalRecommended comments or NetEase's hot-comment selection (mode=comments).
maxCommentsPerItemintegeroptionalMaximum top-level comments read per song, album, playlist or chart (mode=comments). NetEase stops anonymous pagination around 1,100.
includeRepliesbooleanoptionalFetch the reply floor for comments that have replies (mode=comments).
maxRepliesPerCommentintegeroptionalHow many replies to read for each comment when replies are enabled (mode=comments).
includeArtistProfilebooleanoptionalEmit one artist profile record with bio, images, sizes, rank, identities and fan count (mode=byArtist / byArtistAlbums).
includeLyricsbooleanoptionalAttach full LRC lyrics plus translation, romanization and word-by-word lyrics when NetEase has them (every song mode).
includeAlbumTracksbooleanoptionalEmit each album's tracks as song records (mode=byAlbum).
includePlaylistTracksbooleanoptionalEmit the playlist's full tracklist as song records (mode=byPlaylistUrl).
includeToplistInfobooleanoptionalEmit a chart summary record before each chart's tracks (mode=byToplist).
minDurationSecintegeroptionalSkip song records shorter than this. Album, artist, playlist and chart metadata are unaffected.
maxDurationSecintegeroptionalSkip song records longer than this. Album, artist, playlist and chart metadata are unaffected.
minPopularityintegeroptionalSkip song records below this NetEase popularity score (0-100). Metadata records are unaffected.
minPlayCountintegeroptionalSkip browsed playlists with fewer plays (mode=byPlaylist).
minTrackCountintegeroptionalSkip browsed playlists with fewer tracks (mode=byPlaylist).
containsKeywordstringoptionalKeep only records whose name contains this text (case-insensitive). Applies to songs, albums, artists, playlists and charts.
maxItemsintegeroptionalHard cap on total dataset records for the run, including error records.

Download the published input schema

View complete JSON
{
  "description": "Search NetEase Cloud Music, fetch songs, lyrics, artists, albums, playlists, all charts and comments. No login or proxy setup required.",
  "properties": {
    "albumUrls": {
      "default": [],
      "description": "music.163.com album URLs or bare album IDs.",
      "editor": "stringList",
      "prefill": [],
      "title": "Album URLs or IDs (mode=byAlbum)",
      "type": "array"
    },
    "artistIds": {
      "default": [],
      "description": "Artist IDs, music.163.com artist URLs, or exact artist names.",
      "editor": "stringList",
      "prefill": [],
      "title": "Artist IDs, URLs or names (mode=byArtist / byArtistAlbums)",
      "type": "array"
    },
    "artistOrder": {
      "default": "hot",
      "description": "Order the artist's song catalogue by popularity or release time (mode=byArtist).",
      "editor": "select",
      "enum": [
        "hot",
        "time"
      ],
      "enumTitles": [
        "Most popular",
        "Newest release"
      ],
      "prefill": "hot",
      "title": "Artist song order",
      "type": "string"
    },
    "commentOrder": {
      "default": "recommended",
      "description": "Recommended comments or NetEase's hot-comment selection (mode=comments).",
      "editor": "select",
      "enum": [
        "recommended",
        "hot"
      ],
      "enumTitles": [
        "Recommended",
        "Hot comments"
      ],
      "prefill": "recommended",
      "title": "Comment order",
      "type": "string"
    },
    "commentUrls": {
      "default": [],
      "description": "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.",
      "editor": "stringList",
      "prefill": [],
      "title": "Comment targets (mode=comments)",
      "type": "array"
    },
    "containsKeyword": {
      "description": "Keep only records whose name contains this text (case-insensitive). Applies to songs, albums, artists, playlists and charts.",
      "editor": "textfield",
      "title": "Contains keyword",
      "type": "string"
    },
    "includeAlbumTracks": {
      "default": true,
      "description": "Emit each album's tracks as song records (mode=byAlbum).",
      "prefill": true,
      "title": "Include album tracks",
      "type": "boolean"
    },
    "includeArtistProfile": {
      "default": false,
      "description": "Emit one artist profile record with bio, images, sizes, rank, identities and fan count (mode=byArtist / byArtistAlbums).",
      "prefill": false,
      "title": "Include artist profile",
      "type": "boolean"
    },
    "includeLyrics": {
      "default": false,
      "description": "Attach full LRC lyrics plus translation, romanization and word-by-word lyrics when NetEase has them (every song mode).",
      "prefill": false,
      "title": "Include lyrics",
      "type": "boolean"
    },
    "includePlaylistTracks": {
      "default": true,
      "description": "Emit the playlist's full tracklist as song records (mode=byPlaylistUrl).",
      "prefill": true,
      "title": "Include playlist tracks",
      "type": "boolean"
    },
    "includeReplies": {
      "default": false,
      "description": "Fetch the reply floor for comments that have replies (mode=comments).",
      "prefill": false,
      "title": "Include comment replies",
      "type": "boolean"
    },
    "includeToplistInfo": {
      "default": true,
      "description": "Emit a chart summary record before each chart's tracks (mode=byToplist).",
      "prefill": true,
      "title": "Include chart summary",
      "type": "boolean"
    },
    "maxCommentsPerItem": {
      "default": 100,
      "description": "Maximum top-level comments read per song, album, playlist or chart (mode=comments). NetEase stops anonymous pagination around 1,100.",
      "maximum": 1100,
      "minimum": 1,
      "prefill": 100,
      "title": "Max comments per resource",
      "type": "integer"
    },
    "maxDurationSec": {
      "description": "Skip song records longer than this. Album, artist, playlist and chart metadata are unaffected.",
      "maximum": 86400,
      "minimum": 0,
      "title": "Max song duration (seconds)",
      "type": "integer"
    },
    "maxItems": {
      "default": 100,
      "description": "Hard cap on total dataset records for the run, including error records.",
      "maximum": 100000,
      "minimum": 1,
      "prefill": 3,
      "title": "Max items",
      "type": "integer"
    },
    "maxRepliesPerComment": {
      "default": 20,
      "description": "How many replies to read for each comment when replies are enabled (mode=comments).",
      "maximum": 100,
      "minimum": 1,
      "prefill": 20,
      "title": "Max replies per comment",
      "type": "integer"
    },
    "maxTracksPerChart": {
      "default": 0,
      "description": "Limit tracks read from each chart before the global max items cap (mode=byToplist). 0 reads every track.",
      "maximum": 1000,
      "minimum": 0,
      "prefill": 0,
      "title": "Max tracks per chart",
      "type": "integer"
    },
    "minDurationSec": {
      "description": "Skip song records shorter than this. Album, artist, playlist and chart metadata are unaffected.",
      "maximum": 86400,
      "minimum": 0,
      "title": "Min song duration (seconds)",
      "type": "integer"
    },
    "minPlayCount": {
      "description": "Skip browsed playlists with fewer plays (mode=byPlaylist).",
      "maximum": 1000000000000,
      "minimum": 0,
      "title": "Min playlist plays",
      "type": "integer"
    },
    "minPopularity": {
      "description": "Skip song records below this NetEase popularity score (0-100). Metadata records are unaffected.",
      "maximum": 100,
      "minimum": 0,
      "title": "Min song popularity",
      "type": "integer"
    },
    "minTrackCount": {
      "description": "Skip browsed playlists with fewer tracks (mode=byPlaylist).",
      "maximum": 1000000000,
      "minimum": 0,
      "title": "Min playlist tracks",
      "type": "integer"
    },
    "mode": {
      "default": "search",
      "description": "What to fetch. Each mode reads its own list field.",
      "editor": "select",
      "enum": [
        "search",
        "bySongUrl",
        "byArtist",
        "byArtistAlbums",
        "byAlbum",
        "byPlaylist",
        "byPlaylistUrl",
        "byToplist",
        "toplists",
        "comments"
      ],
      "enumTitles": [
        "Search songs, albums, artists or playlists",
        "Song details by URL or ID (with lyrics)",
        "Artist full song catalogue",
        "Artist album discography",
        "Album details and tracks",
        "Browse playlists by category",
        "Playlist details and full tracklist",
        "One or more charts (or all charts)",
        "Chart catalogue",
        "Comments and replies"
      ],
      "prefill": "search",
      "title": "Mode",
      "type": "string"
    },
    "playlistCat": {
      "default": "华语",
      "description": "NetEase playlist genre, scene or mood to browse (mode=byPlaylist).",
      "editor": "select",
      "enum": [
        "全部",
        "综艺",
        "流行",
        "怀旧",
        "清晨",
        "华语",
        "影视原声",
        "摇滚",
        "夜晚",
        "清新",
        "欧美",
        "ACG",
        "民谣",
        "学习",
        "浪漫",
        "儿童",
        "日语",
        "工作",
        "校园",
        "电子",
        "韩语",
        "游戏",
        "午休",
        "粤语",
        "伤感",
        "舞曲",
        "治愈",
        "下午茶",
        "说唱",
        "70后",
        "地铁",
        "轻音乐",
        "放松",
        "80后",
        "驾车",
        "爵士",
        "孤独",
        "90后",
        "乡村",
        "感动",
        "运动",
        "网络歌曲",
        "旅行",
        "兴奋",
        "R&B/Soul",
        "KTV",
        "古典",
        "快乐",
        "经典",
        "散步",
        "翻唱",
        "民族",
        "酒吧",
        "安静",
        "英伦",
        "思念",
        "吉他",
        "金属",
        "钢琴",
        "朋克",
        "器乐",
        "蓝调",
        "榜单",
        "雷鬼",
        "00后",
        "世界音乐",
        "拉丁",
        "New Age",
        "古风",
        "后摇",
        "Bossa Nova"
      ],
      "enumTitles": [
        "全部",
        "综艺",
        "流行",
        "怀旧",
        "清晨",
        "华语",
        "影视原声",
        "摇滚",
        "夜晚",
        "清新",
        "欧美",
        "ACG",
        "民谣",
        "学习",
        "浪漫",
        "儿童",
        "日语",
        "工作",
        "校园",
        "电子",
        "韩语",
        "游戏",
        "午休",
        "粤语",
        "伤感",
        "舞曲",
        "治愈",
        "下午茶",
        "说唱",
        "70后",
        "地铁",
        "轻音乐",
        "放松",
        "80后",
        "驾车",
        "爵士",
        "孤独",
        "90后",
        "乡村",
        "感动",
        "运动",
        "网络歌曲",
        "旅行",
        "兴奋",
        "R&B/Soul",
        "KTV",
        "古典",
        "快乐",
        "经典",
        "散步",
        "翻唱",
        "民族",
        "酒吧",
        "安静",
        "英伦",
        "思念",
        "吉他",
        "金属",
        "钢琴",
        "朋克",
        "器乐",
        "蓝调",
        "榜单",
        "雷鬼",
        "00后",
        "世界音乐",
        "拉丁",
        "New Age",
        "古风",
        "后摇",
        "Bossa Nova"
      ],
      "prefill": "华语",
      "title": "Playlist category",
      "type": "string"
    },
    "playlistUrls": {
      "default": [],
      "description": "music.163.com playlist URLs or bare playlist IDs. Full tracklists are read.",
      "editor": "stringList",
      "prefill": [],
      "title": "Playlist URLs or IDs (mode=byPlaylistUrl)",
      "type": "array"
    },
    "searchQueries": {
      "default": [
        "周杰伦"
      ],
      "description": "Free-text queries (mode=search). One or more artist, song, album or playlist names.",
      "editor": "stringList",
      "prefill": [
        "周杰伦"
      ],
      "title": "Search queries",
      "type": "array"
    },
    "searchType": {
      "default": "song",
      "description": "Which catalog entity to search for (mode=search).",
      "editor": "select",
      "enum": [
        "song",
        "album",
        "artist",
        "playlist"
      ],
      "enumTitles": [
        "Songs",
        "Albums",
        "Artists",
        "Playlists"
      ],
      "prefill": "song",
      "title": "Search result type",
      "type": "string"
    },
    "songUrls": {
      "default": [],
      "description": "music.163.com song URLs or bare song IDs, e.g. 186016.",
      "editor": "stringList",
      "prefill": [],
      "title": "Song URLs or IDs (mode=bySongUrl)",
      "type": "array"
    },
    "toplistIds": {
      "default": [],
      "description": "Chart IDs, music.163.com toplist URLs, or Chinese/English chart names. Use `all` or leave empty for every current chart.",
      "editor": "stringList",
      "prefill": [],
      "title": "Chart IDs, names or URLs (mode=byToplist)",
      "type": "array"
    }
  },
  "required": [
    "mode"
  ],
  "schemaVersion": 1,
  "title": "NetEase Cloud Music Scraper Input",
  "type": "object"
}

Output schema

Published result links and storage locations. This schema is not an exhaustive contract for every field in a dataset record.

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

Download the published output schema

View complete JSON
{
  "actorOutputSchemaVersion": 1,
  "description": "NetEase Cloud Music songs, albums, artists, playlists, chart summaries, comments and lyrics metadata.",
  "properties": {
    "items": {
      "description": "Dataset containing song, album, artist, playlist, toplist, comment and error records.",
      "template": "{{links.apiDefaultDatasetUrl}}/items",
      "title": "NetEase Cloud Music records",
      "type": "string"
    }
  },
  "title": "NetEase Cloud Music Scraper Output"
}

Dataset schema

Published dataset views and any declared field definitions. A view can select only a subset of the returned record fields.

Download the published dataset schema

View complete JSON
{
  "actorSpecification": 1,
  "views": {
    "overview": {
      "display": {
        "component": "table",
        "properties": {}
      },
      "title": "NetEase records",
      "transformation": {
        "fields": [
          "recordType",
          "name",
          "artist",
          "album",
          "rankPosition",
          "chartName",
          "playlistName",
          "durationSec",
          "sourceUrl"
        ]
      }
    }
  }
}

Key-value schema

Published key-value store definitions, when provided by this build.

This definition is not present in the default published build. See the published README for available documentation.

Published README

Read the full published documentation

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

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

Example: song details with every lyric variant

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

Example: a complete playlist with added-at timestamps

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

Example: all current charts, first 20 tracks each

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

Example: hot comments with replies

{
  "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.

Python quickstart

Use a schema-derived input and the Python standard library to start a run. An Apify account and token are required for execution.

Open the step-by-step Python guide →

Source build OBp2YCjuqgFzas3t0. Documentation is regenerated from the default published build; private drafts are not included.