Douban Movie, Book & Music Top List Scraper
SOCIAL MEDIA
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 runs 21 HTTP requests total (10 movie pages + 10 book pages + 1 music chart page) and completes in under 30 seconds from Apify cloud.
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_atto 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).