Douban Scraper: movies, TV shows, books, ratings and reviews (豆瓣)

Get structured data from Douban (豆瓣), China's biggest rating site for movies, TV shows, books and music. Search by keyword, pull whole charts like the Douban Top 250, and add short comments (短评) and full reviews (影评/书评) for each title. The scraper needs no login or cookie, and you can export to JSON, CSV or Excel.

Use it to:

• Research the Chinese audience for a film, series, book or album.
• Track scores and comment counts of new releases over time.
• Collect Chinese reviews for sentiment analysis or LLM datasets.
• Build catalogues with cast, genres, release dates and synopsis.

It reads Douban's own mobile-site JSON API with plain HTTP requests, no browser. That makes it fast and cheap.

What you can scrape

Input	What you get
Search keywords	Movies & TV, books or music matching the keyword, with full details
Charts (榜单)	Top 250 (movies and books), in cinemas, coming soon, real-time hot movies and TV, hot Chinese/US/Korean/Japanese dramas, anime, variety shows, bestsellers, music charts
Subject URLs or IDs	Full details of specific movies, TV shows, books or albums
Short comments	The most helpful short comments of each title, with star rating and votes
Reviews	The most helpful long reviews, with the complete text, rating, useful votes and read count

Why this scraper

• About 40% cheaper than the most-used Douban scraper on the Store (see Pricing).
• Full details by default: genres, directors, cast, countries, languages, running time, release dates, synopsis, Douban score and rating count. Books include authors, translators, publisher, pages and price.
• Complete review text, not just the 100-character abstract.
• Times in UTC (Douban shows Beijing time), and IDs are always strings.
• Privacy-friendly: commenters' gender, location, IP location and registration date are left out. Only their public ID, name and profile link are kept.
• Pay only for results. There's no rental fee, and the run stops cleanly at your spending limit.

Good to know: guest limits

Douban shows logged-out visitors:

• up to about 150 short comments per title, most helpful first;
• the first two pages of reviews (about 40 per title), most helpful first.

Comments sorted by newest need a logged-in account, so they are not available. Search, charts and subject details have no such limit.

How to use it

1. Add search keywords, chart IDs or subject URLs.
2. Pick what to add: full details, short comments, reviews.
3. Click Start, then download the results from the Output tab in any format.

Input example

{
    "charts": ["movie_top250"],
    "searchQueries": ["流浪地球"],
    "searchCategory": "movie",
    "subjectUrls": ["https://book.douban.com/subject/2567698/"],
    "maxResults": 50,
    "fetchDetails": true,
    "includeComments": true,
    "maxCommentsPerSubject": 20,
    "includeReviews": true,
    "maxReviewsPerSubject": 5,
    "fullReviewText": true
}

Chart IDs: movie_top250, movie_showing, movie_real_time_hotest, movie_hot_gaia, movie_soon, movie_weekly_best, tv_hot, tv_real_time_hotest, tv_domestic, tv_american, tv_korean, tv_japanese, tv_animation, show_hot, book_top250, book_bestseller, book_fiction, book_nonfiction, music_single, music_chinese. Any other m.douban.com/subject_collection/... URL works too.

Output

Every record has a type field: subject, comment or review. The Output tab has a separate table view for each.

Subject (movie, TV show, book or album)

{
    "type": "subject",
    "id": "1292052",
    "subjectType": "movie",
    "title": "肖申克的救赎",
    "originalTitle": "The Shawshank Redemption",
    "aka": ["月黑高飞(港)", "刺激1995(台)"],
    "url": "https://movie.douban.com/subject/1292052/",
    "year": "1994",
    "rating": 9.7,
    "ratingCount": 3347231,
    "cardSubtitle": "1994 / 美国 / 剧情 犯罪 / 弗兰克·德拉邦特 / 蒂姆·罗宾斯 摩根·弗里曼",
    "genres": ["剧情", "犯罪"],
    "countries": ["美国"],
    "languages": ["英语"],
    "directors": ["弗兰克·德拉邦特"],
    "actors": ["蒂姆·罗宾斯", "摩根·弗里曼", "鲍勃·冈顿", "威廉·赛德勒"],
    "durations": ["142分钟"],
    "intro": "一场谋杀案使银行家安迪（蒂姆·罗宾斯 Tim Robbins 饰）蒙冤入狱…",
    "tags": ["犯罪", "越狱", "励志", "信念"],
    "honors": ["豆瓣电影Top250 #1"],
    "commentCount": 667496,
    "reviewCount": 14956,
    "coverUrl": "https://img3.doubanio.com/view/photo/m_ratio_poster/public/p2934829882.jpg",
    "detailed": true,
    "source": "chart",
    "chart": "movie_top250",
    "chartTitle": "豆瓣电影 Top250",
    "position": 1,
    "scrapedAt": "2026-10-04T02:58:50Z"
}

Books also carry authors, translators, press, pages and price. Albums carry singers, and TV shows carry episodesCount.

Short comment

{
    "type": "comment",
    "commentId": "32514679",
    "subjectId": "1292052",
    "subjectType": "movie",
    "text": "恐惧让你沦为囚犯，希望让你重获自由。——《肖申克的救赎》",
    "userRating": 5.0,
    "votes": 26487,
    "status": "done",
    "createdAt": "2008-02-27T13:43:23Z",
    "authorId": "1289463",
    "authorName": "如小果",
    "authorUrl": "https://www.douban.com/people/1289463/",
    "position": 1,
    "scrapedAt": "2026-10-04T02:58:52Z"
}

Review

{
    "type": "review",
    "reviewId": "1000369",
    "subjectId": "1292052",
    "subjectType": "movie",
    "subjectTitle": "肖申克的救赎",
    "title": "十年·肖申克的救赎",
    "url": "https://movie.douban.com/review/1000369/",
    "text": "距离斯蒂芬·金（Stephen King）和德拉邦特（Frank Darabont）们缔造这部伟大的作品已经有十年了…",
    "textTruncated": false,
    "userRating": 5.0,
    "spoiler": false,
    "usefulCount": 18953,
    "uselessCount": 735,
    "commentsCount": 1082,
    "resharesCount": 2202,
    "readCount": 1428255,
    "createdAt": "2005-05-12T12:44:13Z",
    "authorId": "1000152",
    "authorName": "大头绿豆",
    "authorUrl": "https://www.douban.com/people/1000152/",
    "position": 1,
    "scrapedAt": "2026-10-04T02:58:54Z"
}

Pricing

Pay per result, no subscription. You are only charged for records that land in your dataset.

Record	Event	Price
Movie, TV show, book or album	subject	$3.00 per 1,000
Short comment	comment	$3.00 per 1,000
Review (full text)	review	$18.00 per 1,000

The exact current prices are always shown on the Pricing tab. Set Maximum cost per run in the run options and the scraper stops cleanly when it is reached. The whole Douban Top 250 with full details costs $0.75.

FAQ

Why do I get at most about 150 short comments per title? Douban shows logged-out visitors only the most helpful ~150 short comments and ~40 reviews per title. Everything the site shows a guest is collected.

Can I track scores over time? Yes. Save a task with the charts or titles you care about and schedule it, for example daily. Each run is a timestamped snapshot of scores, rating counts and comment counts.

Do I need a proxy? No. The scraper paces itself, and on the Apify platform it switches to Apify Proxy on its own if Douban blocks its IP. If Douban still blocks it for more than 5 minutes, the run stops early and keeps everything it already scraped.

Is scraping Douban legal? This Actor collects only publicly visible data, through the API Douban's own mobile website uses, and leaves out personal details such as gender, location and IP location. You are responsible for how you use the data. Check Douban's terms and the data protection laws that apply to you (GDPR, PIPL...).

Feedback

Found a bug or need another field? Open an issue on the Issues tab. Issues are usually fixed within a few days.