📚 Douban Book Scraper 豆瓣读书: Top 250, Tags, New Releases, Changes

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

Know which books China rates highest, and which ones are climbing Collect Douban Books rankings with rating, rating count, publisher and price on every row: the Top 250, topic tag lists and new releases. Turn on change tracking to see rank movers and new entries on each scheduled run.

📚 Three kinds of lists Top 250, any topic tag list and new releases by category, or paste the books you want.

🎯 Filters that cut cleanup Keep only books that meet your rating, rating count, year, price, publisher, author or keyword limits.

🔎 Optional deep detail Add ISBN, page count, star split, reader counts and the full description for each book.

📈 Rank movers Change tracking shows new entries, places moved and rating shifts since your last run.

Point this Actor at 豆瓣读书, Douban's book community, and get its Top 250, topic tag lists and new releases as a clean dataset you can filter, sort and export to JSON, CSV or Excel. No login required.

🔍 What does Douban Book Scraper do?

This Actor reads Douban Books' public ranking pages and returns one tidy row per book. Choose the all-time Top 250, any topic tag list such as 小说, 科幻, 历史 or 经济学 (ordered by Douban default, rating or newest), the new releases page by category, or paste specific book links or IDs.

• Every row: rank, Douban book ID, title, subtitle, authors, publisher, publication date and year, listed price as text and as a number with currency, rating, rating count, summary, cover and link.
• Optional full details: ISBN, page count, binding, translators, original title, series, the 1 to 5 star rating split in percent, how many readers are reading, have read and want to read the book, and the full description.
• Optional extras: author biography and chapter list.
• Optional change tracking: previous rank, places moved, new on the list, rating change and rating count change since your last run. Books that dropped off a list are named in the run summary.

No Douban account is needed. This Actor does not collect user reviews or comments.

💡 Why use it

• I am a book publisher's acquisitions editor shortlisting Chinese titles by Douban score and rating count, so I only look at books that thousands of readers have actually rated.
• I am an online bookseller watching the new releases page by category and capping the listed price in yuan, so I can decide what to stock without opening every book page.
• I am a market researcher on Chinese reading trends running a topic tag like 科幻 every week, so I can see which books enter the list and which ones climb.
• I am a book blogger pulling every novel above 8.5 with at least 10,000 ratings from a tag, so my best-of list is built from data instead of guesses.

🚀 How it works

STEP 1 Pick your lists Choose Top 250, topic tags or new releases, or paste book links.

STEP 2 Set filters and extras Limit by rating, year, price, publisher or author, and add full details if you need them.

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

📥 Input

Field	Type	Required	Description
rankingLists	array of options	No	Which lists to read: Top 250, topic tag lists, new releases. Defaults to Top 250. Leave empty to collect only the books in bookUrls.
tags	array of strings	No	Douban topic tags to read when topic tag lists are selected, one per row, for example 小说 or 科幻. Chinese names work best.
latestCategories	array of options	No	Categories of the new releases page to read, such as literature, fiction, history, science or business. Defaults to all books.
bookUrls	array of strings	No	Specific books to collect with full detail, as Douban book links or plain ID numbers such as 1007305.
tagSort	enum	No	Order inside each topic tag list: Douban default, highest rated first, or newest first.
minRating	number	No	Keep only books rated at or above this score on the 0 to 10 scale. Use 0 to switch off.
minRatingCount	integer	No	Keep only books rated by at least this many people. Use 0 to switch off.
publishedFromYear	integer	No	Keep only books published in this year or later. Use 0 to switch off.
publishedToYear	integer	No	Keep only books published in this year or earlier. Use 0 to switch off.
maxListPrice	number	No	Keep only books listed at or below this price in Chinese yuan. Books priced in another currency or with no price are left out. Use 0 to switch off.
publisherContains	string	No	Keep only books whose publisher name contains this text, for example 人民文学出版社.
authorContains	string	No	Keep only books whose author or translator text contains this name, for example 村上春树.
keyword	string	No	Keep only books whose title, subtitle or summary line contains this text.
fetchDetails	boolean	No	Add ISBN, page count, binding, translators, series, original title, the star rating split, reader counts and the full description. Slower, because each book page is opened. Off by default.
includeAuthorBio	boolean	No	Add the author biography shown on each book page. Off by default.
includeTableOfContents	boolean	No	Add the chapter list shown on each book page, when Douban has one. Off by default.
trackChanges	boolean	No	Compare each list with your previous run and add rank change, new entry, rating change and rating count change. The first run only saves the starting point.
onlyChangedRows	boolean	No	With change tracking on, return only books that are new on the list, moved position or changed rating.
monitorScope	string	No	A name for this watch. Runs with the same name are compared with each other, so use a different name for each schedule.
maxItems	integer	No	Maximum matching books to collect from each list. Defaults to 25. The Top 250 never returns more than 250.
dedupeAcrossLists	boolean	No	Return a book only once even if it appears in several lists or in bookUrls. On by default.
proxyConfiguration	object	No	Connection settings for Douban's public pages. Leave the default unless your account needs a custom route.

The default input returns the first 25 books of the Top 250 in a few seconds.

📊 Data table

Field	Type	Description
list	string	Source list: top250, tag, latest or direct (a book you asked for by URL).
tag	string	Topic tag the book was listed under.
category	string	New release category the book was listed under.
rank	integer	Position in the source list.
subjectId	string	Douban book identifier.
title	string	Book title.
subtitle	string	Subtitle.
originalTitle	string	Original-language title (book page only).
alternateTitle	string	Alternate title shown on the Top 250 list.
authors	string	Author and contributor text.
authorList	array	Authors as separate entries (book page only).
authorUrls	array	Douban author page links (book page only).
translators	array	Translators (book page only).
publisher	string	Publisher.
imprint	string	Imprint or producer (book page only).
published	string	Publication date as shown, for example 2012-8.
publishedYear	integer	Publication year.
listPrice	string	Listed cover price as shown.
priceAmount	number	Listed price as a number.
priceCurrency	string	Currency code when the listing names one, for example CNY.
onlinePaperPrice	string	Current online paper-edition price shown on new releases.
publicationInfo	string	Raw publication line from the list page.
binding	string	Binding such as paperback or hardcover.
pages	integer	Page count (book page only).
isbn	string	ISBN (book page only).
series	string	Book series name (book page only).
seriesUrl	string	Series page link (book page only).
rating	number	Douban average rating out of 10.
ratingCount	integer	Number of ratings.
ratingDistribution	object	Share of ratings per star level in percent: star5 to star1 (book page only).
readingCount	integer	Readers currently reading (book page only).
readCount	integer	Readers who have read it (book page only).
wantToReadCount	integer	Readers who want to read it (book page only).
summary	string	Short blurb from the list page.
quote	string	One-line quote on the Top 250 list.
description	string	Full book description (book page only).
authorIntro	string	Author biography (when requested).
tableOfContents	array	Chapter list (when requested).
coverUrl	string	Cover image link.
coverUrlLarge	string	Larger cover image link (book page only).
url	string	Douban book page.
isNewEntry	boolean	True when the book was not on the list in the previous run (change tracking).
changeType	string	new, moved_up, moved_down or unchanged since the previous run (change tracking).
previousRank	integer	Rank in the previous run (change tracking).
rankChange	integer	Places moved since the previous run, positive means moved up (change tracking).
previousRating	number	Rating in the previous run (change tracking).
ratingChange	number	Rating change since the previous run (change tracking).
ratingCountChange	integer	Change in number of ratings since the previous run (change tracking).
previousSeenAt	string	When the previous run was taken (change tracking).
sourceUrl	string	List 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": "1007305",
    "title": "红楼梦",
    "authors": "(清)曹雪芹",
    "publisher": "人民文学出版社",
    "published": "1982-3",
    "listPrice": "59.70元",
    "publicationInfo": "(清)曹雪芹 / 人民文学出版社 / 1982-3 / 59.70元",
    "rating": 9.7,
    "ratingCount": 469920,
    "summary": "都云作者痴，谁解其中味？",
    "quote": "都云作者痴，谁解其中味？",
    "coverUrl": "https://img3.doubanio.com/view/subject/s/public/s1070959.jpg",
    "url": "https://book.douban.com/subject/1007305/",
    "publishedYear": 1982,
    "priceAmount": 59.7,
    "priceCurrency": "CNY",
    "sourceUrl": "https://book.douban.com/top250?start=0",
    "retrievedAt": "2026-10-11T09:26:38.040Z"
}

💰 Pricing

Pricing is pay per result, with no subscriptions. You pay for each book delivered to your dataset. Extras such as full book details, the author biography or the chapter list are billed only for the books that actually include them. 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 Book Scraper?

⭐ ⭐ ⭐ ⭐ ⭐ One run turns Douban's book charts into a list you can sort, filter and shortlist. A 5-star rating takes 10 seconds and helps other publishers, booksellers and 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, then download the dataset as JSON, CSV or Excel from the Output tab. The default reads 25 books, so raise the maximum books per list to 250 to get the whole Top 250.

How do I get the books under one Douban tag such as 科幻?

Select topic tag lists, add the tag on its own row (Chinese names work best), and choose Douban default order, highest rated first or newest first. Add a minimum rating count to skip books with only a few votes.

How does change tracking work?

Turn on change tracking and keep the same monitor name on every scheduled run. The first run saves the starting point. Later runs add rank change, new entry and rating change to each book, and the run summary names the books that dropped off the list.

Does it need a Douban login, and does it collect reviews?

No login is needed. It reads public ranking and book pages and returns ratings and counts, but not user reviews or comments.

🔗 Other actors

• Douban Movie Top 250 Scraper 豆瓣电影: Hot Charts, Filters, Changes ↗ - Collects Douban's film and TV charts and genre charts with filters and change tracking.
• Douban Music Scraper 豆瓣音乐: Top 250, Weekly Charts and Tag Lists ↗ - Collects Douban's album Top 250, weekly charts and tag lists.
• Ximalaya Scraper 喜马拉雅: Podcasts & Comments ↗ - Collects podcasts and comments from Ximalaya, China's audio platform.
• Bilibili Trending Videos Scraper 哔哩哔哩: Rankings & Hot Searches ↗ - Collects Bilibili's video rankings and hot searches.