Kugou Music Scraper: 酷狗音乐 Catalog, Charts & Lyrics

Kugou Music data on demand: songs, charts, playlists and lyrics. Look up any song, album or artist on Kugou (酷狗音乐), pull full playlist tracklists, or watch a chart update every 30 minutes, automatically, with no account required.

🔍 Full catalog search Song, album and artist lookups with cover art, release date and audio quality tiers

🏆 Live chart tracking All 55 official charts and their ranked songs, refreshed on Kugou's own 30-minute cycle

📋 Complete playlists Search playlists by keyword or pull a full tracklist, creator and play count included

🎤 Timed lyrics included Full time-stamped lyrics for any song, ready for subtitles or karaoke tools

Give this Actor a keyword or an ID and it returns structured Kugou data in seconds: song search results, a full album or artist catalog, a playlist tracklist, a chart snapshot, or timed lyrics. Built for music-industry researchers tracking Chinese catalog and chart trends, marketing teams watching what's climbing the playlists this week, and developers who want clean Kugou data without digging through the app by hand. Runs on the Apify platform with scheduling, integrations (Make, Zapier, Google Sheets), and run monitoring built in.

🔍 What does Kugou Music Scraper do?

This Actor reads public catalog data from Kugou Music (酷狗音乐), one of China's largest music streaming platforms, part of the Tencent Music Entertainment family.

Pick one of eight modes per run: search songs by keyword, pull a full album tracklist by ID, get an artist's complete catalog plus biography, search playlists by keyword, pull a full playlist tracklist by ID, list all 55 official Kugou charts, snapshot the ranked songs on any one chart, or fetch full time-stamped lyrics for a song. Every mode returns clean, structured rows, ready to download or send to your own system. A field a specific song or album doesn't have (no high-resolution audio tier, no music video, no album name on some lookups) is simply left out of that row rather than filled in with a placeholder.

A note on comments: this Actor does not return song, album or playlist comments. Comment threads sit behind a much stricter verification wall on Kugou's platform than the catalog, chart and lyrics data covered here. Reliable comment support is a bigger, separate project we're tracking based on demand for this Actor first, not something bolted on halfway.

💡 Why use Kugou Music Scraper?

• I track Chinese music trends for licensing or A&R and need real catalog depth and chart movement for an artist or genre on one of China's largest platforms, without hiring a local researcher.
• I monitor playlist culture and marketing trends and want to know what's actually climbing the charts and showing up in playlists this week, sourced straight from Kugou's own numbers.
• I'm building a music app or dataset and need structured song, album and lyric data for Kugou, ready to drop into my own product without reverse-engineering the platform myself.
• I run a scheduled chart-monitoring job and want a feed that updates itself, timed to match how often Kugou's own charts actually refresh.

🚀 How to use Kugou Music Scraper

STEP 1 Pick a mode Song search, album, artist, playlist, chart, or lyrics.

STEP 2 Enter a keyword or ID Search by name, or paste an ID from a previous run.

STEP 3 Export your results Download as JSON, CSV or Excel, or send it to your own system.

⚙️ Input

Field	Type	Required	Description
mode	enum	No	songSearch, albumTracklist, artistCatalog, playlistSearch, playlistTracklist, chartIndex, chartSnapshot, or lyrics. Defaults to songSearch.
query	string	No	Search keyword. Used by Song search and Playlist search (any keyword) and Lyrics mode (works best as "singer song title", e.g. "周杰伦 晴天").
albumId	string	No	Kugou album ID. Used by Album tracklist mode.
singerId	string	No	Kugou singer/artist ID. Used by Artist catalog mode.
specialId	string	No	Kugou playlist ID. Used by Playlist tracklist mode.
rankId	string	No	Kugou chart ID. Defaults to 8888 (TOP500). Used by Chart snapshot mode; run Chart index mode first to see all chart IDs and names.
maxItems	integer	No	Maximum number of records to fetch and push in this run. Defaults to 50.
proxyConfiguration	object	No	Proxy routing settings. Defaults to Apify's standard proxy, which this target works reliably with.

📦 Output

Download the results as a spreadsheet, a table, or structured data ready for your own systems. A song row from Song search mode looks like this:

{
  "recordType": "song",
  "sourceMode": "songSearch",
  "scrapedAt": "2026-07-19T00:00:00.000Z",
  "songId": "8AC4F90B1E3DF716D216D74223016E17",
  "songName": "千山万水",
  "singerName": "周杰伦",
  "singerId": "3520",
  "albumId": "2606360",
  "albumName": "北京2008年奥运会歌曲专辑",
  "durationSec": 247,
  "publishDate": "2008-05-02",
  "coverUrl": "http://imge.kugou.com/stdmusic/480/20250125/20250125121629695890.jpg",
  "isPaid": false,
  "hash128": "8AC4F90B1E3DF716D216D74223016E17",
  "hash320": "5BFD0161C4BE57FA4C355B76386233EF",
  "hashFlac": "6C5C7B66CEBA518DA71FDA7EA2E4559A",
  "songPageUrl": "https://www.kugou.com/mixsong/64574642.html"
}

A chart snapshot row, a playlist row, an artist bio row and a lyrics row each carry their own set of fields, described in full below. Every mode shares the same recordType and sourceMode fields so you can tell rows apart when combining runs.

📊 Output data fields

Field	Type	Description
recordType	string	song, chart, playlist, artist, or lyrics. Tells you which field group below applies to a given row.
sourceMode	string	Which run mode produced this row.
scrapedAt	string	Timestamp when this row was collected.
songId, songName, singerName, singerId	string	Core song identity, present on every song row.
albumId / albumName	string	Album identity, when the source data includes it.
durationSec	number	Track length in seconds.
publishDate	string	Release date, when published.
coverUrl	string	Cover art image link.
isPaid / payType	boolean / number	Whether the track requires a paid or VIP tier to stream.
hash128, hash320, hashFlac	string	Kugou's own identifiers for the standard, high, and lossless audio quality tiers available for the track.
position	number	Chart rank or track order, when the source data provides one.
songPageUrl	string	Direct link to the song's page on kugou.com, when available.
chartId, chartName, chartRefreshCadenceSec, chartUpdateFrequencyText, chartItemCount, chartIntro, chartCoverUrl	string / number	Chart identity and metadata, present on chart rows and attached to song rows from Chart snapshot mode. chartRefreshCadenceSec is Kugou's own stated refresh interval (1800 seconds / 30 minutes for most charts).
playlistId, playlistName, playlistCreator, playlistPlayCount, playlistSongCount, playlistPublishTime, playlistCoverUrl	number / string	Playlist identity and stats, present on playlist rows.
artistId, artistName, artistBio, artistSongCount, artistAvatarUrl	string / number	Artist biography fields, present on the one artist row an Artist catalog run returns.
lyricsId, lyricsAccessKey, lyricsSinger, lyricsSong, lyricsContent, lyricsSource, lyricsScore	string / number	Timed lyrics text and match metadata, present on lyrics rows. lyricsContent is the full time-stamped lyric text.
engagementTag	string	A short popularity tag Kugou attaches to some search results, when present.
sourceQuery	string	The search keyword that produced this row, when the mode is keyword-based.
sourceUrl	string	The Kugou data source this row was collected from.

💰 Pricing

This Actor uses pay-per-result pricing: you pay for the records you actually get back, and nothing for an empty run. There is no subscription and no minimum spend. Use maxItems to control how many results a run returns.

⭐ Enjoying Kugou Music Scraper: 酷狗音乐 Catalog, Charts & Lyrics?

⭐ ⭐ ⭐ ⭐ ⭐ Found a hit before it topped the charts? A 5-star rating takes 10 seconds and helps other music researchers, marketers, and developers tracking Chinese platforms find this Actor. Your feedback also tells us what to build next.

★  Rate this Actor on Apify

✨ Tips

• Run Song search or Playlist search first to discover the IDs you need for Album tracklist, Artist catalog, and Playlist tracklist modes.
• Run Chart index mode once to see all 55 official chart IDs and names, then use the one you want in Chart snapshot mode.
• Schedule Chart snapshot mode on a 30-minute interval in the Apify Console to match Kugou's own chart refresh cycle for a self-updating trend feed.
• For Lyrics mode, "singer song title" (either script) matches better than the song title alone, since Kugou indexes lyrics by both.
• A missing albumName on some song rows is expected: a few Kugou lookups return the album ID but not a separate album name field.

❓ FAQ, disclaimers, and support

如何获取酷狗音乐的歌词数据？ Set mode to lyrics and enter a singer and song title in query (e.g. "周杰伦 晴天"). The Actor returns the matching candidates with full time-stamped lyric text for each.

酷狗音乐排行榜多久更新一次？ Kugou's own charts report a 30-minute refresh cycle for most rankings. Run Chart index mode to see each chart's exact cadence, then schedule Chart snapshot mode at that interval for a self-updating feed.

Does this Actor return song, album or playlist comments? Not yet. Comments live behind a much stricter verification wall on Kugou's platform than the catalog, chart and lyrics data this Actor covers. Reliable comment support is a bigger, separate project we're tracking based on demand for this Actor first.

Do I need a Kugou account or login? No. Every mode in this Actor reads publicly available catalog data with no sign-in required.

How fresh is the data? Every run reads current data directly from Kugou at run time. There is no cached or stale data.

Is scraping Kugou data legal? This Actor collects publicly available catalog, chart, playlist and lyrics data. You are responsible for complying with Kugou's Terms of Service and applicable laws in your use of the data.

Found a bug or need a field added? Open an issue on the Actor's Issues tab. Custom solutions are available on request.

🔗 Other actors

• Xigua Video Search Scraper: Keyword, Comments & Video Links ↗ - pulls search results, comments and video links from another major Chinese content platform.
• Buyee Scraper: Yahoo Auctions & Mercari Japan Data ↗ - structured listing data from Japan's largest cross-border auction and marketplace proxy.
• Viewstats YouTube Analytics & Rankings Scraper ↗ - channel and video analytics for tracking what's trending on YouTube.
• Twitch Scraper: channels, live streams, clips and games ↗ - live stream, clip and channel data for media monitoring.
• Google Lens OCR API ↗ - a fast, agent-friendly text and object recognition utility.