Douban Scraper – movies, TV, books, music, short comments and reviews (豆瓣)

Douban Scraper extracts public data from Douban (豆瓣), China's largest rating and review community: titles with ratings and the full 1–5 star distribution, short comments (短评) for movies, TV series, books and music, long reviews (影评 / 书评) with full text, search results and official Douban charts such as Movie Top 250. No login, no cookies, no browser.

Who is it for?

• Market & audience research – see how Chinese audiences rate a film, series, book or album before a launch or localisation.
• Sentiment analysis & NLP – thousands of real Chinese short comments with star ratings, ready for training or evaluating models.
• Media, publishers & distributors – track ratings, “want to watch” counts and chart positions (Top 250, now showing, hot TV).
• Data journalism & academia – reproducible datasets of Douban ratings and reviews.

What you get

Record	What is inside
subject	Title, original title, year, Douban rating (0–10), number of ratings, rating distribution in % for 5★…1★, genre ranks (“better than 99% of crime films”), genres, countries, languages, directors, cast, authors, publisher, pages, price, duration, episodes, tags, synopsis, cover, comment / review counts, “done / wish / doing” counts, chart rank
comment	Short comment text, star rating (1–5), status (watched / want / watching), helpful votes, date
review	Review title, abstract, full text (optional), star rating, helpful votes, replies, reshares, date, URL

Privacy by design: the actor never stores user names, user IDs, avatars or IP locations of commenters – only the content and the rating.

How to use it

1. Add one or more Douban subject URLs (e.g. https://movie.douban.com/subject/1292052/, https://book.douban.com/subject/2567698/), and/or search queries (Chinese or English), and/or pick Douban charts.
2. Choose whether you want short comments and/or long reviews and how many per title.
3. Click Start. Results appear in the Overview table and can be downloaded as JSON, CSV, Excel or HTML.

Input example

{
  "subjectUrls": ["https://book.douban.com/subject/2567698/"],
  "charts": ["movie_top250"],
  "maxChartItems": 10,
  "includeComments": true,
  "maxCommentsPerSubject": 30,
  "includeReviews": true,
  "maxReviewsPerSubject": 5,
  "fullReviewText": true
}

Output example (real data, shortened)

{
  "recordType": "subject",
  "subjectType": "book",
  "id": "2567698",
  "title": "三体",
  "url": "https://book.douban.com/subject/2567698/",
  "rating": 8.9,
  "ratingMax": 10,
  "ratingCount": 519002,
  "ratingDistributionPercent": { "5": 62.6, "4": 29.7, "3": 6.5, "2": 0.8, "1": 0.5 },
  "authors": ["刘慈欣"],
  "press": ["重庆出版社"],
  "publishDate": "2008-1",
  "pages": "302",
  "commentCount": 125084,
  "reviewCount": 4809,
  "doneCount": 648078,
  "wishCount": 176269
}

{
  "recordType": "comment",
  "subjectType": "book",
  "subjectId": "2567698",
  "subjectTitle": "三体",
  "commentId": "425448896",
  "text": "一直认为写作是件很耗费体力与脑力的事情，特别是从新构架一个新的世界，一个文明……",
  "rating": 5,
  "ratingMax": 5,
  "status": "done",
  "votes": 13055,
  "createdAt": "2011-08-14 14:27:05"
}

{
  "recordType": "review",
  "subjectId": "2567698",
  "reviewId": "1342728",
  "title": "《三体》：当代史的科幻书写",
  "fullText": "评论刘慈欣的《三体》是件困难的事情……",
  "rating": 4,
  "usefulCount": 1794,
  "commentsCount": 268,
  "createdAt": "2008-04-03 03:20:04",
  "url": "https://book.douban.com/review/1342728/"
}

Available charts

movie_top250, movie_showing (in cinemas), movie_real_time_hotest, movie_weekly_best, tv_hot, tv_real_time_hotest, tv_chinese_best_weekly, book_top250, book_bestseller, music_single.

Use it from code

from apify_client import ApifyClient
client = ApifyClient("<YOUR_API_TOKEN>")
run = client.actor("flarewow/douban-scraper").call(run_input={
    "subjectUrls": ["https://movie.douban.com/subject/1292052/"],
    "maxCommentsPerSubject": 50,
})
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item["recordType"], item.get("title") or item.get("text"))

import { ApifyClient } from 'apify-client';
const client = new ApifyClient({ token: '<YOUR_API_TOKEN>' });
const run = await client.actor('flarewow/douban-scraper').call({ searchQueries: ['流浪地球'], maxSearchResults: 3 });
const { items } = await client.dataset(run.defaultDatasetId).listItems();

Pricing (pay per result)

Event	Price
Subject (title with ratings & metadata)	$3 per 1,000
Short comment	$2 per 1,000
Long review (incl. full text)	$10 per 1,000

You only pay for records saved to the dataset. Use Max cost per run in the run options to cap spending.

Limitations & FAQ

• How many comments can I get? Douban shows up to about 150 most helpful short comments and about 50 long reviews per title to visitors without login. Newest-first order and deeper pages require a Douban account, which this actor does not use.
• Some titles fail with “restricted”. A small number of titles are hidden by Douban for visitors without login; they are listed in the ERRORS record of the run's key-value store.
• Search uses Douban's own search, which is fuzzy – a nonsense query may still return the closest titles.
• Empty runs fail on purpose. If no data can be returned (for example Douban blocks the requests), the run ends as FAILED with an explanation, so you are not charged for nothing. Try again later or switch the proxy to RESIDENTIAL.

Integrations

Works with the Apify API, webhooks, schedules and integrations such as n8n, Make, Zapier, Google Sheets and the Apify MCP server for AI agents.

Responsible use

The actor collects only publicly visible content and does not store personal data of commenters. Respect Douban's terms and local law (e.g. GDPR / PIPL) when you process or publish the data.

---

中文说明

豆瓣爬虫：抓取豆瓣电影、电视剧、图书、音乐的公开数据——评分、评分人数、1–5 星评分分布、类型排名、导演/演员/作者/出版社等信息，以及**短评（电影、电视剧、图书、音乐均支持）**和长评（影评/书评，可含全文）。支持按链接、关键词搜索和豆瓣榜单（电影 Top250、正在热映、热门剧集、图书畅销榜等）抓取。无需登录。

• 隐私保护：不保存评论者的昵称、用户 ID、头像和 IP 属地，只保存内容和评分。
• 限制：未登录状态下，每个条目最多约 150 条热门短评、约 50 篇长评；“最新”排序需要登录，暂不支持。
• 价格：条目 $3/千条，短评 $2/千条，长评 $10/千条，只按实际结果收费。