Douban Scraper: Movie & Book Ratings, Reviews, Comments (豆瓣)

Get Douban (豆瓣) movie, TV and book data without a login. Search titles, get ratings and full details, export short comments (短评) and full-text reviews (影评/书评), and pull charts such as now in theaters, all as clean rows ready for Excel, Google Sheets, BI tools or your own code.

• Low per-row price: $3 per 1,000 rows list ($2.55/1k on Gold), and you only pay for rows you get.
• Movies, TV and books in one tool: 豆瓣电影 and 豆瓣读书 ratings, comments and reviews.
• Ready for analysis: star ratings next to review text, ideal for sentiment and recommendation datasets.
• Reliable: tested every day so scheduled runs keep working.

中文简介：豆瓣爬虫 / 豆瓣电影数据 / 豆瓣读书数据采集：豆瓣数据采集，无需登录。支持电影/电视剧/图书搜索、条目详情（评分、评分人数、导演演员/作者出版社、简介、标签）、短评（最多约 150–200 条热门）、影评/书评（最多 40 篇热门，可选全文）、豆瓣榜单（正在热映、实时热门、热门剧集、虚构类图书等）。每 1000 条 3 美元。搜索、短评、影评在条数上限不超过 50 时，每次运行前 20 条结果免费。

First 20 rows free on search, comments and reviews when that mode's limit is 50 or below. Chart and subject runs are billed from the first row. Open Try for free, run a small search, then keep going if the data fits — details under Pricing.

For AI agents

Call this actor through the Apify MCP server. maxChargeUsd is this actor's cap. MCP callOptions.maxTotalChargeUsd is a separate platform cap; set both before a paid call. Do not use mode: "selftest" — that is a maintenance check, not a data mode.

List prices (unchanged): run start $0.001, then $0.003 per row. The first 20 rows are free on search, comments, and reviews only when that mode's limit is 50 or below. On Apify, one free sample per user per 24 hours. A qualifying 5-row search costs the $0.001 run start only.

outputFormat: "compact" also writes key OUTPUT_COMPACT ({"format":"columnar-v1","columns":[...],"missing":"¤","rows":[[...]]}). A cell equal to missing was absent on that row. The dataset is the normal row fallback. Same rows, same price.

Search:

{ "mode": "search", "searchQueries": ["活着"], "searchType": "movie", "maxResults": 5, "maxChargeUsd": 1 }

Fields: type subject, detail search, subjectType, id, title, rating, ratingCount, year, url.

Subject (billed from row 1):

{ "mode": "subject", "subjectUrls": ["movie:1292052"], "maxChargeUsd": 1 }

Fields: detail full, intro, rating, ratingCount, plus directors/actors/genres or authors/publisher.

Short comments:

{ "mode": "comments", "subjectUrls": ["https://movie.douban.com/subject/1292052/"], "maxComments": 5, "maxChargeUsd": 1 }

Fields: type comment, text, stars, votes, authorName, createdAt.

Reviews:

{ "mode": "reviews", "subjectUrls": ["book:1007305"], "maxReviews": 5, "fullReviewText": true, "maxChargeUsd": 1 }

Fields: type review, title, abstract, content (full text), stars, usefulCount.

Chart (billed from row 1):

{ "mode": "chart", "charts": ["movie_showing"], "maxResults": 5, "maxChargeUsd": 1 }

Fields: detail chart, rank, title, rating, ratingCount, chart.

A Douban API alternative: Douban's public API was shut down years ago. Get Douban movie and book data — ratings, comments and reviews — as clean rows, with no login.

Try it in one click

The input form on this page is already prefilled with the example below — press Start and it runs as-is.

{ "mode": "search", "searchQueries": ["活着"], "maxResults": 10, "maxChargeUsd": 0.5 }

What you get:

• Up to 10 "活着" (To Live) search results with Douban rating, vote count and type (movie/TV/book).
• About 10 rows. Those 10 are inside the free sample, so the charge is the run-start fee ($0.001). Rows after the first 20 are $0.003 each at list price.
• Turn on fetchDetails for full details (cast, genres, intro, publisher) at the same per-row price.

Why Douban data matters

• What it is: Douban is China's best-known community for rating and reviewing films, TV series and books, often compared to IMDb plus Goodreads with a strong review culture. (Douban doesn't publish official user figures, so we don't quote any.)
• For studios, streamers and publishers: benchmark a title's score and rating count against competitors, and read what audiences praise or criticise before and after release.
• For market researchers: track charts such as "now in theaters" and trending series to understand Chinese entertainment demand.
• For AI / LLM teams: long, thoughtful Chinese reviews with star ratings, a natural labelled dataset for sentiment and recommendation models.

What Douban data you can get

Mode	Input	Rows
search	keywords, searchType movie (includes TV) or book	one row per title; fetchDetails adds full details
subject	Douban links or movie:<id> / tv:<id> / book:<id>	full details: rating and vote count, intro, directors, actors, genres, countries, release dates, durations, or authors, publisher, pages, price
comments	the same	short comments, most helpful first (up to about 150–200 per title)
reviews	the same	reviews, most helpful first (top 40 per title), fullReviewText for the whole review
chart	collection ids (movie_showing, movie_real_time_hotest, tv_hot, book_fiction…)	ranked titles

Pricing (pay per event)

List price (FREE plan):

Event	Price
Run start	$0.001
Row (title, comment or review)	$0.003 ($3 per 1,000)

Apify personal-plan discounts apply automatically on the Store for the row event: Bronze 5% ($2.85/1k), Silver 10% ($2.70/1k), Gold / Platinum / Diamond 15% ($2.55/1k). The Store headline shows your plan’s rate; the table above is the list rate so it always matches what FREE users pay.

Try without paying for rows: the first 20 result rows in a run are free. After that, list price applies ($3 per 1,000 on FREE; Gold shelf $2.55/1k). Run-start is $0.001. Works on Apify’s Free plan ($5/mo platform usage, no credit card to try).

The free sample applies to search, comments, and reviews when that mode’s limit is 50 or below (maxResults, maxComments, or maxReviews). chart and subject are billed from the first row, and so is any search, comments, or reviews run whose limit is above 50. On Apify, one free sample per user per 24 hours. If the platform does not provide a user id, the first 20 rows of each qualifying run are free; heavy use still pays.

Error rows are free. maxChargeUsd (default $5) stops the run cleanly before it goes over.

Works on Apify’s Free plan — $5/mo platform usage, no credit card required to try. List prices above (FREE $3/1k; Gold $2.55/1k after plan discount) are unchanged.

Input examples

{ "mode": "search", "searchQueries": ["三体", "活着"], "searchType": "book", "fetchDetails": true }

{ "mode": "reviews", "subjectUrls": ["https://movie.douban.com/subject/1292052/"], "maxReviews": 40, "fullReviewText": true }

{ "mode": "comments", "subjectUrls": ["https://movie.douban.com/subject/26647087/", "book:1007305"], "maxComments": 200 }

{ "mode": "chart", "charts": ["movie_showing", "tv_hot"], "maxResults": 50 }

Output examples (real rows, 2026-10-18, long text shortened)

Book (search + details):

{ "type": "subject", "detail": "full", "subjectType": "book", "id": "2567698", "title": "三体", "rating": 8.9, "ratingCount": 518798,
  "commentCount": 125038, "reviewCount": 4801, "intro": "文化大革命如火如荼进行的同时。军方探寻外星文明的绝秘计划“红岸工程”取得了突破性进展。…",
  "url": "https://book.douban.com/subject/2567698/", "subtitle": "刘慈欣 / 2008 / 重庆出版社", "authors": ["刘慈欣"], "publisher": "重庆出版社",
  "pubdate": "2008-1", "pages": "302", "price": "23.00", "bookSubtitle": "“地球往事”三部曲之一", "searchQuery": "三体", "position": 1 }

Short comment:

{ "type": "comment", "subjectType": "book", "subjectId": "1007305", "commentId": "532193706",
  "text": "盛衰之理，本为天命。然而人心就是如此。眼见得他起高楼，于是便不忍心见他楼塌了。…", "stars": 5, "votes": 11058, "status": "done",
  "createdAt": "2012-05-15T09:26:24+00:00", "authorName": "朱红尽颓", "authorId": "49117267" }

Review (with full text):

{ "type": "review", "subjectType": "movie", "subjectId": "1292052", "reviewId": "1000369", "title": "十年·肖申克的救赎",
  "stars": 5, "usefulCount": 18956, "uselessCount": 735, "commentsCount": 1082, "createdAt": "2005-05-12T12:44:13+00:00",
  "url": "https://movie.douban.com/review/1000369/", "authorName": "大头绿豆", "authorId": "1000152",
  "content": "距离斯蒂芬·金（Stephen King）和德拉邦特（Frank Darabont）们缔造这部伟大的作品已经有十年了。…", "spoiler": false }

Chart:

{ "type": "subject", "detail": "chart", "subjectType": "movie", "id": "37068446", "title": "生化危机：爆发夜", "year": "2026", "rating": 7.3,
  "ratingCount": 179182, "subtitle": "2026 / 德国 法国 美国 / 科幻 惊悚 恐怖 / 扎克·克雷格 / 奥斯汀·艾布拉姆斯 扎克·切利",
  "url": "https://movie.douban.com/subject/37068446/", "chart": "movie_showing", "rank": 1 }

Compact output for AI agents

Set Output format to compact and the run still pushes the same rows to the dataset at the same price — nothing about billing changes. It additionally writes OUTPUT_COMPACT to the run's key-value store: our token-optimized, lossless encoding of the same rows, built to be cheaper to hand to an LLM than the plain dataset JSON.

Measured on a real 150-row export of this actor's short-comment rows:

Tokenizer	Pretty JSON	Minified JSON	Compact	vs Pretty	vs Minified
cl100k_base (GPT-4/3.5)	30,258	24,324	19,560	35.4% smaller	19.6% smaller
o200k_base (GPT-4o)	26,632	20,696	16,091	39.6% smaller	22.3% smaller

Need regular row objects in your own code? The normal dataset is always there, unchanged, alongside the compact copy.

Good to know

• No-login limits: about the top 150–200 short comments and the top 40 reviews per title, sorted by helpfulness. "Latest first" ordering needs login.
• TV series links on movie.douban.com work; the actor detects TV automatically.
• Times are converted from Beijing time to UTC.
• Privacy: comment and review rows include only the author's public nickname and id. This actor does not collect avatars, locations or registration dates.

Reliability

A self-test runs every day against live Douban. If Douban blocks every request, the run fails instead of ending green with 0 rows.

Run it on a schedule

Suggested frequency: daily for the now-showing and trending charts, weekly for tracking ratings and new comments on titles you follow.

To set it up: save your input as a Task in Apify Console, then add a Schedule. Send results where you work with Apify integrations: Google Sheets, Slack or email notifications, webhooks, Make / Zapier / n8n, or straight into an AI agent through the Apify MCP server. A run that can't get data is marked failed, so your alerts fire.

FAQ

Is there an official Douban API? Not for new developers. Douban closed its public API. This actor returns the same public movie, TV and book data any visitor can see — ratings, short comments (短评), full reviews (影评/书评) and charts — with no login.

Can I get Douban movie ratings and reviews in bulk? Yes. Search by keyword or pass subject links/IDs. You get rating, vote count, cast/crew or authors, genres, short comments and optional full review text. Export JSON, CSV or Excel.

Does it cover books (豆瓣读书) as well as movies? Yes. Set search type to books for authors, publisher, pages, price and book ratings. Movie search also returns TV series.

Do I need a Douban account or cookie? No. No login, account or cookie.

Is there a free sample? Yes. The first 20 result rows in a qualifying search, comments or reviews run are free (mode limit ≤50). After that, list price applies. Run-start is $0.001. Chart and subject modes bill from the first row. On Apify, one free sample per user per 24 hours.

How often should I schedule it? Daily for now-showing / trending charts; weekly for ratings and new comments on titles you follow. Save input as a Task, add a Schedule, and send results to Sheets, Slack, webhooks, Make/Zapier/n8n or an AI agent via Apify MCP.

Can I use it with AI agents / MCP? Yes, through the Apify MCP server. Turn on compact output to write a token-optimized copy of the same rows for LLMs (same billing).

What can I use Douban data for? Chinese box-office and audience research, content licensing, recommendation datasets, and sentiment analysis on short comments and reviews.

Feedback

If the data helped, a short rating on the Reviews tab helps others find this actor. Something broke or missing a field? Open an issue on the Issues tab — we aim to reply within 24 hours.

Related actors

• Weibo Scraper — posts, comments and hot search from China's biggest microblog.
• Bilibili Scraper — videos, comments and danmaku from China's biggest video community.
• WeChat Articles Scraper — WeChat Official Account articles with full text.
• AliExpress Scraper — AliExpress products, prices and variants.
• YouTube Scraper — YouTube videos and comments, for comparing audiences outside China.
• Guide: Douban (豆瓣) Reviews Data in 2026 — a live run on real titles: ratings, how many 短评 and 影评 you get, sample rows and costs.

关键词： 豆瓣爬虫, 豆瓣电影数据, 豆瓣读书, 豆瓣评分, 豆瓣短评采集, 豆瓣影评, Douban scraper, Douban API, Douban movie ratings, Douban book reviews.