🎵 Douban Music Scraper 豆瓣音乐: Top 250, Weekly Charts and Tag Lists

Douban rates albums, books and films. This suite reads all three. Run the album charts here, then pull the book and film rankings with the same filters and change tracking.
DOUBAN RANKINGS SUITE   •  Books, films and albums from Douban's public charts
Douban Books Top 250, tags, new releases	Douban Movies 10 charts and 28 genre charts	Douban Music ➤ You are here

Douban's album charts and tag lists, ready to rank and compare Collect the Top 250 albums, the weekly new albums and musician singles charts, and genre or artist tag lists, with rating and rating count on every row. Turn on change tracking to watch rankings move from run to run.

🏆 Charts and tag lists Top 250 albums, two weekly charts, and any genre, artist, region or era tag.

🎯 Filters that narrow fast Keep albums by rating, rating count, release year, genre, artist, release type or format.

🎼 Full album detail Optionally add track lists, star split, label, barcode, listener counts and related albums.

📈 Rank movement Change tracking shows new entries, rank change and rating movement since your last run.

Point this Actor at 豆瓣音乐, Douban's music community, and get its album rankings as a clean dataset you can filter, sort and export to JSON, CSV or Excel. No login required.

🔍 What does Douban Music Scraper do?

This Actor reads Douban Music's public ranking pages and returns one tidy row per album or single. Choose the Top 250 albums, the weekly new albums chart, the weekly musician singles chart, or any Douban tag list, or paste specific album links or IDs.

• Ranking sources: the Top 250 albums, the weekly new albums chart, the weekly musician singles chart, plus any Douban tag list (a genre like 摇滚, an artist like 周杰伦, a region or an era).
• Every row: rank, title, alternate title, artist, release date and year, album type, medium, genre, rating, rating count, cover and album link.
• Optional full album details: track list with disc numbers, album summary, the 1 to 5 star rating split, label, barcode, ISRC, disc count, how many listeners heard it, are listening or want to hear it, other editions, and related albums with their ratings.
• Optional change tracking: rank change, new entries, rating movement and new ratings since your previous run.

No Douban account is needed. This Actor focuses on rankings and album data and does not collect listener reviews or comments.

💡 Why use it

• I am an A&R scout looking at which albums in a genre like 民谣 score highest on Douban with enough ratings to trust, so I can spot artists that Chinese listeners rate highly.
• I am a playlist curator building a list from a Douban tag sorted by rating, while skipping albums that only have a handful of votes.
• I am a record label analyst running the weekly new albums chart on a schedule, so I can see what enters and what climbs without opening the page.
• I am a music researcher pulling every album under an artist tag such as 周杰伦 with release year and type, so I can compare how listeners rate each era.

🚀 How it works

STEP 1 Pick a list Choose a ranking list, add tags, or paste album links.

STEP 2 Set filters and details Limit by rating, year, genre, artist or format, and add full album details if you need them.

STEP 3 Export or watch weekly Download JSON, CSV or Excel, or schedule runs with change tracking on.

📥 Input

Field	Type	Required	Description
rankingLists	array of options	No	Which rankings to collect: Top 250, the weekly new albums chart, the weekly musician singles chart. Defaults to Top 250. Leave empty to use only your tags and album links.
tags	array of strings	No	Douban tags to read as their own rankings, for example a genre such as 摇滚 or jazz, an artist such as 周杰伦, or a region. A tag page link also works.
tagSort	enum	No	Order inside each tag: hot, best rated, newest or most saved. Best rated works well with a minimum rating count.
subjectUrls	array of strings	No	Specific album pages to collect in full, as Douban links or plain ID numbers such as 3040149. These always include the detail fields, and your filters still apply.
minRating	number	No	Keep only albums rated at or above this value on the 0 to 10 scale. Use 0 to switch off.
minRatingCount	integer	No	Keep only albums rated by at least this many listeners, which skips high scores from a handful of votes. Use 0 to switch off.
releaseYearFrom	integer	No	Keep only albums released in this year or later. Use 0 for no lower limit.
releaseYearTo	integer	No	Keep only albums released in this year or earlier. Use 0 for no upper limit.
genres	array of strings	No	Keep albums whose genre contains any of these words, as Douban shows them, for example 摇滚, 流行 or 民谣.
artists	array of strings	No	Keep albums by artists whose name contains any of these words. Matches Chinese and Latin names, ignoring case.
albumTypes	array of strings	No	Keep albums of these release types as Douban labels them, for example 专辑, 单曲, EP or Soundtrack.
mediaTypes	array of strings	No	Keep albums released on these formats, for example CD, Vinyl or 数字.
titleKeywords	array of strings	No	Keep albums whose title or alternate title contains any of these words.
includeDetails	boolean	No	Add track list, summary, star rating split, label, barcode, listener counts, other editions and related albums. Each album page is opened, so runs take longer. Off by default.
trackChanges	boolean	No	Compare each list with your previous run and show rank change, new entries and rating movement. The first run only saves the starting point.
monitorScope	string	No	A name for this watch. Use different names to keep independent watches on the same list. Only used when change tracking is on.
onlyChanges	boolean	No	After the first run, return only albums that are new, moved up or down, or changed rating. Only used when change tracking is on.
maxItems	integer	No	Maximum albums to collect from each list, tag or chart. Defaults to 25. The weekly charts are shorter than this.
maxListPages	integer	No	Page limit per tag list, useful when filters skip many albums. Tag pages hold 20 albums and Douban shows at most 50 pages.
uniqueAlbums	boolean	No	Output an album only for the first list that shows it, instead of once per list. Off by default.
requestDelaySecs	number	No	Pause in seconds between page views. The default of 1 keeps runs polite and reliable.
proxyConfiguration	object	No	Connection settings for Douban's public pages. Leave the default unless your account needs a custom route.

The default input collects the first 25 albums of the Top 250 and finishes in well under a minute.

📊 Data table

Field	Type	Description
list	string	Which list the row came from: top250, newAlbumsChart, musicianSinglesChart, tag:
rank	integer	Position in that list.
subjectId	string	Douban music identifier.
title	string	Album or single title.
alternateTitle	string	Subtitle or second title shown beside the title.
artist	string	Artist or artists as one text.
artists	array	Artists as a list.
releaseDate	string	Release date as Douban shows it, full date or year only.
releaseYear	integer	Release year.
albumType	string	Release type such as album, single, EP or soundtrack.
media	string	Medium such as CD, vinyl or digital.
genre	string	Genre label.
publicationInfo	string	The full descriptive line shown on the ranking page.
rating	number	Douban average rating out of 10.
ratingCount	integer	Number of Douban ratings.
coverUrl	string	Cover image link.
url	string	Douban album page.
daysOnChart	integer	Days on the weekly chart (charts only).
playCount	integer	Weekly plays (musician singles chart only).
songId	string	Douban identifier of the single (musician singles chart only).
artistUrl	string	Musician page (musician singles chart only).
rankChange	integer	Places moved up (positive) or down (negative) since the previous chart or run.
previousRank	integer	Rank in the previous run (change tracking).
isNewEntry	boolean	True when the album was not in the previous run's list (change tracking).
previousRating	number	Rating in the previous run (change tracking).
ratingChange	number	Rating movement since the previous run (change tracking).
previousRatingCount	integer	Rating count in the previous run (change tracking).
ratingCountChange	integer	New ratings since the previous run (change tracking).
firstSeenAt	string	When this run history first saw the album in the list (change tracking).
aliases	array	Other titles for the album (detail).
performers	array	Performers listed on the album page (detail).
publisher	string	Label or publisher (detail).
discCount	integer	Number of discs (detail).
barcode	string	Barcode (detail).
isrc	string	ISRC code (detail).
summary	string	Album description (detail).
trackCount	integer	Number of tracks (detail).
tracks	array	Track list with disc, number and title (detail).
ratingDistribution	object	Share of ratings by star, star5 to star1, in percent (detail).
listenedCount	integer	Listeners who marked the album as heard (detail).
listeningCount	integer	Listeners currently listening (detail).
wishCount	integer	Listeners who want to hear it (detail).
coverUrlLarge	string	Larger cover image link (detail).
otherVersions	array	Other editions of the album (detail).
relatedAlbums	array	Albums that listeners of this one also like, with ratings (detail).
sourceUrl	string	Page that supplied the row.
retrievedAt	string	Time the row was collected.

Fields that Douban does not show are left out of the row, never filled with placeholders. You can download the dataset as JSON, CSV or Excel from the Output tab of any run.

📤 Sample output

{
    "list": "top250",
    "rank": 1,
    "subjectId": "2995812",
    "title": "We Sing. We Dance. We Steal Things.",
    "artist": "Jason Mraz",
    "artists": [
        "Jason Mraz"
    ],
    "releaseDate": "2008-05-13",
    "releaseYear": 2008,
    "albumType": "Import",
    "media": "Audio CD",
    "genre": "民谣",
    "publicationInfo": "Jason Mraz / 2008-05-13 / Import / Audio CD / 民谣",
    "rating": 9.1,
    "ratingCount": 117126,
    "coverUrl": "https://img3.doubanio.com/view/subject/s/public/s2967252.jpg",
    "url": "https://music.douban.com/subject/2995812/",
    "sourceUrl": "https://music.douban.com/top250?start=0",
    "retrievedAt": "2026-10-11T09:26:42.216Z"
}

💰 Pricing

Pricing is pay per result, with no subscriptions. You pay for each album delivered to your dataset. Full album details are billed separately, and only for the albums that actually come back with the extra data. Empty runs cost nothing. If you set a maximum charge per run in Apify, it is respected: the run stops cleanly when the limit is reached and keeps everything already delivered. Your Apify plan sets the rate, and higher plans pay less.

⭐ Enjoying Douban Music Scraper?

⭐ ⭐ ⭐ ⭐ ⭐ One run turns Douban's album charts into a table you can rank, filter and compare. A 5-star rating takes 10 seconds and helps other A&R scouts, curators and music researchers find this actor. Your feedback also tells us what to build next.

★  Rate this Actor on Apify

❓ FAQ

豆瓣音乐 Top 250 怎么导出？

Run the Actor with its default settings and download the dataset as JSON, CSV or Excel from the Output tab. The default reads 25 albums, so raise the maximum albums per list to 250 to get the whole Top 250.

豆瓣音乐 摇滚 专辑 评分 排行 怎么获取？

Add the tag 摇滚 (or jazz, or an artist such as 周杰伦), choose best rated order, and set a minimum rating count to skip albums with only a few votes. Each tag is returned as its own ranking.

How do I watch rankings over time?

Turn on change tracking and schedule the Actor weekly. The first run saves the starting point. Every later run adds rank change, new entry flags and rating movement, and can return only what changed.

Why do runs with full album details take longer?

Full details need one extra page visit per album, about three seconds each, so a run of 100 albums takes around five minutes. For large collections, split the work into several runs, for example one tag or list per run.

🔗 Other actors

• Douban Book Scraper 豆瓣读书: Top 250, Tags, New Releases, Changes ↗ - Collects Douban's book Top 250, topic tag lists and new releases.
• Douban Movie Top 250 Scraper 豆瓣电影: Hot Charts, Filters, Changes ↗ - Collects Douban's film and TV charts and genre charts with filters and change tracking.
• Migu Music Scraper: 咪咕音乐 ↗ - Collects public music catalogue and chart records from Migu Music.
• Kugou Music Scraper: 酷狗音乐 Catalog, Charts & Lyrics ↗ - Collects the Kugou Music catalogue, charts and lyrics.
• QQ Music Scraper: QQ音乐 Songs, Charts & Comments ↗ - Collects QQ Music songs, charts and comments.