Douban Movie, Book & Music Top List Scraper

Scrape the three canonical Douban ranked lists in a single run:

• Movie Top 250 (movie.douban.com/top250) — all 10 pages × 25 films = 250 results
• Book Top 250 (book.douban.com/top250) — all 10 pages × 25 books = 250 results
• Music New Albums Chart (music.douban.com/chart 豆瓣新碟榜) — 10 chart entries

Each result includes rank position, title, rating, and type-specific fields (directors/cast for movies, authors/publisher for books, artist for music). Movies include an IMDb ID cross-reference where available.

What you get

Field	Movies	Books	Music
list_type	✓	✓	✓
rank_position	✓	✓	✓
title	✓	✓	✓
rating_value	✓	✓	—
rating_count	✓	✓	—
year	✓	✓	—
directors	✓	—	—
cast	✓	—	—
country	✓	—	—
genres	✓	—	—
imdb_id	✓	—	—
authors	—	✓	—
publisher	—	✓	—
artist	—	—	✓
cover_url	✓	✓	—
douban_subject_url	✓	✓	✓
quote	✓	✓	—
snapshotted_at	✓	✓	✓

Usage

Input

Parameter	Type	Default	Description
maxItems	integer	750	Maximum records to return. The full 3-list run produces ~510 records (250 movies + 250 books + 10 music). Set higher to ensure all lists complete, or lower for faster spot-checks.

Quick start

Set maxItems to 750 (or leave at default) for a complete scrape of all three lists. The actor issues 21 requests total (10 movie pages + 10 book pages + 1 music chart page) and completes in under 30 seconds.

Example output (movie)

{
  "list_type": "movie_top250",
  "list_url": "https://movie.douban.com/top250?start=0",
  "rank_position": 1,
  "item_id": "1292052",
  "title": "肖申克的救赎",
  "title_alt": "The Shawshank Redemption",
  "cover_url": "https://img1.doubanio.com/view/photo/s_ratio_poster/public/p480747492.jpg",
  "rating_value": 9.7,
  "rating_count": 2987311,
  "year": 1994,
  "directors": "弗兰克·德拉邦特",
  "cast": "蒂姆·罗宾斯, 摩根·弗里曼, 鲍勃·冈顿",
  "country": "美国",
  "genres": "犯罪, 剧情",
  "imdb_id": "tt0111161",
  "douban_subject_url": "https://movie.douban.com/subject/1292052/",
  "quote": "希望让人自由。",
  "snapshotted_at": "2026-05-31T15:14:12.000Z"
}

Example output (book)

{
  "list_type": "book_top250",
  "list_url": "https://book.douban.com/top250?start=0",
  "rank_position": 1,
  "item_id": "1007305",
  "title": "红楼梦",
  "cover_url": "https://img1.doubanio.com/view/subject/s/public/s1070959.jpg",
  "rating_value": 9.7,
  "rating_count": 439082,
  "year": 1996,
  "authors": "[清] 曹雪芹 著",
  "publisher": "人民文学出版社",
  "douban_subject_url": "https://book.douban.com/subject/1007305/",
  "quote": "都云作者痴，谁解其中味？",
  "snapshotted_at": "2026-05-31T15:14:18.000Z"
}

Notes

• Rate limiting: The actor sends 2 concurrent requests with automatic back-off on 429/503 responses. Douban list pages have no strict rate enforcement at this concurrency level.
• Music chart: Returns entries from the "豆瓣新碟榜" (New Albums) section, which tracks recently charted albums. Unlike the movie/book lists, the music section does not expose ratings on the list page.
• Data freshness: Douban's Top 250 lists update weekly. The music chart updates daily. Set snapshotted_at to compare snapshots over time.
• IMDb cross-reference: Available for most Western films in the movie list. Not guaranteed for all entries (Chinese films often lack IMDb IDs on Douban's list page).

---

Further reading: Streaming Charts and Box Office Data: Spotify, Netflix, Maoyan & More