# Changelog of Kugou Music Scraper: 酷狗音乐 Catalog, Charts & Lyrics (`getascraper/kugou-music-scraper`) Actor

- **URL**: https://apify.com/getascraper/kugou-music-scraper/changelog.md
- **Full Actor documentation**: https://apify.com/getascraper/kugou-music-scraper.md

## Changelog

All notable changes to this project will be documented in this file.

### \[0.2.0] - 2026-09-27

#### Fixed

- 🔍 Song search often returned zero results; it now reliably returns real songs, so default runs succeed with data.
- ▶️ A run started with completely empty input now returns songs instead of failing.

### \[0.1.0] - 2026-07-19

#### Added

- 🚀 Initial release of Kugou Music Scraper.
- 🔍 Song search by keyword: title, singer(s), album, multi-bitrate file hashes (128k/320k/lossless), paid/VIP flag, cover image, publish date, and a direct Kugou song-page link.
- 💿 Full album tracklist lookup by album ID.
- 👤 Artist catalog + bio lookup by singer ID (full song catalog plus biography and song count).
- 📋 Playlist search by keyword and full playlist tracklist lookup by playlist ID.
- 🏆 Chart index (all 55 official Kugou charts with their refresh cadence) and chart snapshot mode (ranked songs for one chart) - built as a recurring/scheduled anchor around Kugou's own 30-minute chart refresh cycle.
- 🎤 Timed lyrics (full LRC) lookup by singer + song keyword, via Kugou's two-step search-then-download lyrics flow.
- 🛡️ Datacenter proxy by default - no anti-bot signature, signed parameter, or WAF was observed anywhere on the legacy catalog API during build-time recon.
- 🧹 Clean output: fields a given song/album/artist/playlist doesn't have (e.g. no lossless tier, no MV) are omitted rather than shown as a placeholder.
- 🚫 Comments are intentionally NOT included in this release - they live behind a separate, newer, signed Kugou API generation. See the README and AGENTS.md for the full explanation; this is a deliberate scope cut, not a missing feature.