QQ Music Charts, Albums and Playlists Scraper
Pricing
from $0.49 / 1,000 results
QQ Music Charts, Albums and Playlists Scraper
Search QQ Music songs, fetch top-100 chart rankings, or pull album and playlist track lists with singer, duration, cover art and file-size data, no login required.
Pricing
from $0.49 / 1,000 results
Rating
0.0
(0)
Developer
Nimbryxo-studio
Maintained by CommunityActor stats
0
Bookmarked
2
Total users
1
Monthly active users
19 hours ago
Last modified
Categories
Features
Share
QQ Music (QQ音乐) is one of mainland China's largest streaming catalogs, run by Tencent. This actor turns a search term, song link, chart, album or playlist into structured track metadata — titles, singers, album art, duration and file-size info — without needing to log in.
What this actor does
- Searches QQ Music by free-text query, including Chinese-language queries
- Fetches full song metadata from one or more song URLs, optionally including a lyric excerpt
- Pulls any of QQ Music's 20 top-100 chart types (hot songs, new songs, rising, rap, EDM, Douyin hits, anime, game soundtracks, and more), with a summary record plus the full track list
- Fetches an album's or playlist's own metadata together with its full track list, by ID or by URL
- Filters returned songs by duration range, title keyword and singer keyword
- Omits any field the source record didn't carry — no empty strings or nulls in the output
- Never fails silently on a bad song/album/playlist reference — it returns an error record instead so you can see what didn't resolve
Output: per song (mode = search / bySongUrl / byToplist / byAlbum / byPlaylist track rows)
mid,mediaMid,songId— QQ Music's song identifiersname— song titlesingers[],singer— all credited singers, and the first one as a convenience fieldsingerMids[]album,albumId,albumMid,coverUrldurationSecpubTimeSec,pubTimeText— release time, when QQ Music provides itvid— linked music-video ID, when one existssize128,size320,sizeFlac— file size in bytes for each available audio qualitypayPlay,payDownload,payStatus— whether the track requires a paid plan to stream or downloadlyric— first part of the LRC lyric text, only whenincludeLyricis on (mode=bySongUrl)sourceUrl,scrapedAt,recordType: "song"
Output: per chart (mode = byToplist, summary record)
toplistId,namelistenCountcoverUrlupdateFrequency,updateTimesourceUrl,scrapedAt,recordType: "toplist"
Output: per album (mode = byAlbum, summary record)
albumId,albumMid,name,singertimePublic— release dategenre,language,description,companytrackCountsourceUrl,scrapedAt,recordType: "album"
Output: per playlist (mode = byPlaylist, summary record)
playlistId,name,coverUrlcreatorName,creatorUin,creatorAvatarUrllistenerCount,visitCount,songCountdescription,tags[]createTimeMs,updateTimeMssourceUrl,scrapedAt,recordType: "playlist"
Output: per unresolved reference (recordType: "error")
errorCode— e.g.BAD_URL,NOT_FOUND,INVALID_INPUTerrorMessage— human-readable reasoninputValue— the song URL, album ID, playlist ID or toplist ID that didn't resolvescrapedAt
Input
| Field | Type | Default | Description |
|---|---|---|---|
mode | string | search | search, bySongUrl, byToplist, byAlbum or byPlaylist |
searchQuery | string | 周杰伦 | Free-text search query (mode=search) |
songUrls | array | [] | QQ Music song URLs to fetch (mode=bySongUrl) |
toplistId | string | – | Chart to fetch — one of 20 QQ Music top-100 charts (mode=byToplist) |
includeToplistInfo | boolean | true | Emit the chart's summary record before its tracks (mode=byToplist) |
albumId | integer | – | Numeric album ID (mode=byAlbum) |
albumUrls | array | [] | Album URLs, as an alternative to albumId (mode=byAlbum) |
playlistId | string | – | Playlist disstid (mode=byPlaylist) |
playlistUrls | array | [] | Playlist URLs, as an alternative to playlistId (mode=byPlaylist) |
includeLyric | boolean | false | Attach a lyric excerpt to each song record (mode=bySongUrl) |
minDurationSec | integer | – | Drop songs shorter than this |
maxDurationSec | integer | – | Drop songs longer than this |
containsKeyword | string | – | Keep only songs whose title contains this substring |
singerKeyword | string | – | Keep only songs whose first singer contains this substring |
maxItems | integer | 30 | Hard cap on emitted records, including error records (1–1000) |
Example: search by artist name
{"mode": "search","searchQuery": "周杰伦","maxItems": 20}
Example: a specific chart with its tracks
{"mode": "byToplist","toplistId": "26","includeToplistInfo": true,"maxItems": 100}
Example: album tracks by ID
{"mode": "byAlbum","albumId": 20612,"maxItems": 50}
Example: song lookup with lyrics
{"mode": "bySongUrl","songUrls": ["https://y.qq.com/n/ryqq/songDetail/001Bbywq2gicae"],"includeLyric": true}
Use cases
- Music data research — collect structured chart history for Mandarin-pop and C-pop analysis
- Playlist curation tools — pull track lists from public playlists into your own catalog
- A&R and trend tracking — monitor which songs are rising on QQ Music's charts
- Catalog enrichment — attach QQ Music album art, duration and singer credits to an existing song database
- Lyric research — fetch LRC excerpts alongside track metadata for a known set of songs
FAQ
Is this affiliated with QQ Music or Tencent? No. This is an independent actor that reads QQ Music's publicly available song, chart, album and playlist pages; it is not operated by or affiliated with Tencent or QQ Music.
Why do some playlists return zero tracks?
Some user-created playlists on QQ Music only serve their track list to logged-in accounts. When that happens, this actor still returns the playlist's own summary record with a songCount of whatever is visible publicly, rather than failing the run.
What's in size128, size320 and sizeFlac?
These are the file sizes, in bytes, for each audio quality QQ Music offers for that track. A quality tier that the track doesn't have available is simply omitted.
Why would I get an error record instead of song/album/playlist data?
If a song URL, album ID or playlist ID you supplied doesn't resolve to a real QQ Music record, the actor returns an error record carrying the offending input rather than silently skipping it.
Can I fetch artist pages directly? No — this actor covers search, song, chart, album and playlist lookups; it does not expose a dedicated artist/singer mode.
Do I need a QQ account or API key? No login or key is required for any mode.
How fresh are the chart rankings? Each run reads QQ Music's live chart and catalog pages, so rankings and track lists reflect whatever QQ Music is currently showing.