QQ Music Charts, Albums and Playlists Scraper avatar

QQ Music Charts, Albums and Playlists Scraper

Pricing

from $0.49 / 1,000 results

Go to Apify Store
QQ Music Charts, Albums and Playlists Scraper

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

Nimbryxo-studio

Maintained by Community

Actor stats

0

Bookmarked

2

Total users

1

Monthly active users

19 hours ago

Last modified

Features

Limited permissions

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 identifiers
  • name — song title
  • singers[], singer — all credited singers, and the first one as a convenience field
  • singerMids[]
  • album, albumId, albumMid, coverUrl
  • durationSec
  • pubTimeSec, pubTimeText — release time, when QQ Music provides it
  • vid — linked music-video ID, when one exists
  • size128, size320, sizeFlac — file size in bytes for each available audio quality
  • payPlay, payDownload, payStatus — whether the track requires a paid plan to stream or download
  • lyric — first part of the LRC lyric text, only when includeLyric is on (mode=bySongUrl)
  • sourceUrl, scrapedAt, recordType: "song"

Output: per chart (mode = byToplist, summary record)

  • toplistId, name
  • listenCount
  • coverUrl
  • updateFrequency, updateTime
  • sourceUrl, scrapedAt, recordType: "toplist"

Output: per album (mode = byAlbum, summary record)

  • albumId, albumMid, name, singer
  • timePublic — release date
  • genre, language, description, company
  • trackCount
  • sourceUrl, scrapedAt, recordType: "album"

Output: per playlist (mode = byPlaylist, summary record)

  • playlistId, name, coverUrl
  • creatorName, creatorUin, creatorAvatarUrl
  • listenerCount, visitCount, songCount
  • description, tags[]
  • createTimeMs, updateTimeMs
  • sourceUrl, scrapedAt, recordType: "playlist"

Output: per unresolved reference (recordType: "error")

  • errorCode — e.g. BAD_URL, NOT_FOUND, INVALID_INPUT
  • errorMessage — human-readable reason
  • inputValue — the song URL, album ID, playlist ID or toplist ID that didn't resolve
  • scrapedAt

Input

FieldTypeDefaultDescription
modestringsearchsearch, bySongUrl, byToplist, byAlbum or byPlaylist
searchQuerystring周杰伦Free-text search query (mode=search)
songUrlsarray[]QQ Music song URLs to fetch (mode=bySongUrl)
toplistIdstring–Chart to fetch — one of 20 QQ Music top-100 charts (mode=byToplist)
includeToplistInfobooleantrueEmit the chart's summary record before its tracks (mode=byToplist)
albumIdinteger–Numeric album ID (mode=byAlbum)
albumUrlsarray[]Album URLs, as an alternative to albumId (mode=byAlbum)
playlistIdstring–Playlist disstid (mode=byPlaylist)
playlistUrlsarray[]Playlist URLs, as an alternative to playlistId (mode=byPlaylist)
includeLyricbooleanfalseAttach a lyric excerpt to each song record (mode=bySongUrl)
minDurationSecinteger–Drop songs shorter than this
maxDurationSecinteger–Drop songs longer than this
containsKeywordstring–Keep only songs whose title contains this substring
singerKeywordstring–Keep only songs whose first singer contains this substring
maxItemsinteger30Hard 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.