# Douban Reviews Scraper - Movies, Books, TV & Groups (`tenfoldfleet/douban-reviews-scraper`) Actor

Get Douban reviews for any movie, TV show, book or album with the full review text, star rating, useful votes, author and date, plus short comments (短评), group topics and search results. No login. $25 per 1,000 reviews, $4 per 1,000 comments; title details and errors are free.

- **URL**: https://apify.com/tenfoldfleet/douban-reviews-scraper.md
- **Developed by:** [Tenfold Fleet](https://apify.com/tenfoldfleet) (community)
- **Categories:** Social media, Agents, MCP servers
- **Features:** Limited permissions
- **Stats:** 1 total users, 0 monthly users, 0.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $12.00 / 1,000 reviews

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

*Not affiliated with Douban (豆瓣). This is an independent tool that reads public pages without logging in.*

### What does Douban Reviews Scraper do?

**Douban Reviews Scraper** pulls **Douban reviews** (影评, 书评, 乐评) for any **movie, TV series, book or album**, with the **full review text**, not the short preview Douban shows in lists. It also collects **short comments (短评)** with star ratings, **Douban group topics (小组)** with their replies, **title details** and **Douban search results**. Think of it as a **Douban reviews API** you call with a list of links: no account, no cookies, no browser.

Give it Douban links or ids and get back clean JSON rows: review title, full text, star rating, useful and useless votes, read count, author, IP location and date. Title details (rating, rating count, cast, genres, synopsis) are added for free.

### Why use it?

- **Chinese audience research**: see how Chinese viewers and readers judge a film, show, book or album before a release, a localisation or a marketing push.
- **Sentiment analysis and NLP**: long-form Chinese reviews with star labels make a good labelled dataset.
- **Competitor and brand monitoring**: follow what Douban groups say about a product, a show or a celebrity.
- **Box office and publishing analytics**: compare Douban ratings, rating counts and review volume across titles.
- **AI agents**: one call returns structured review data an agent can summarise or score.

### What data can it extract?

![Sample output of Douban Reviews Scraper, rows from a real run: Type, Movie / book, Title, Stars, Review text, Useful](https://api.apify.com/v2/key-value-stores/4TBgG7fopkYMNWnX2/records/douban-reviews-scraper-output.png)

| Row type | Fields |
|---|---|
| `review` | reviewId, title, **content (full text)**, contentHtml, abstract, rating (1-5 stars), usefulCount, uselessCount, likersCount, commentsCount, resharesCount, readCount, isSpoiler, ipLocation, createdAt, author (id, name, url, followers, location), subjectId, subjectTitle, url |
| `comment` | commentId, text, rating, voteCount, status (watched / want to), ipLocation, createdAt, author, subjectId, subjectTitle |
| `groupTopic` | topicId, title, content (full text), commentsCount, likeCount, resharesCount, isElite, tags, photos, author, groupName, groupMemberCount, createdAt, url |
| `topicReply` | replyId, text, voteCount, quotedReplyId, ipLocation, createdAt, author, topicId |
| `subject` (free) | title, originalTitle, year, rating, ratingCount, genres, countries, directors, actors, authors, press, releaseDates, durations, episodesCount, tags, intro, reviewCount, commentCount, coverUrl |
| `searchResult` | query, rank, subjectId, subjectType, title, year, rating, ratingCount, url |

### How to scrape Douban reviews

1. Open the Actor and paste one or more Douban links into **Douban URLs or ids**: a movie or TV page (`movie.douban.com/subject/1292052`), a book (`book.douban.com/subject/1007305`), an album, a single review, a group topic or a whole group.
2. Set **Max reviews per title** and, if you want them, **Max short comments per title**.
3. Optional: add **Search queries** to find titles by name, and **Scrape reviews of top search results** to get their reviews in the same run.
4. Click **Start**. Rows appear in the dataset as they arrive.
5. Download the results as JSON, CSV, Excel or HTML, or read them through the [Apify API](https://docs.apify.com/api/v2).

### How much does it cost to scrape Douban?

You pay per result, nothing for compute:

| Result | Price |
|---|---|
| Review with full text | **$25 per 1,000** ($0.025 each) |
| Short comment or group reply | $4 per 1,000 |
| Group topic with full text | $20 per 1,000 |
| Search result | $4 per 1,000 |
| Title details | free (up to 20 per run if you ask for no reviews or comments) |
| Errors, deleted or unavailable items | free |

A review is charged only after its full text has been fetched. On the free Apify plan a run returns up to 50 paid results; paid plans have no cap. Set a maximum cost per run in the run options and the Actor stops there.

### Input

```json
{
    "urls": [
        "movie.douban.com/subject/1292052",
        "book.douban.com/subject/1007305",
        "www.douban.com/group/topic/504878256"
    ],
    "maxReviewsPerSubject": 20,
    "maxCommentsPerSubject": 50,
    "commentStatuses": ["done"],
    "searchQueries": ["盗梦空间"],
    "maxSearchResults": 5,
    "scrapeTopSearchResults": 1
}
```

### Output

```json
{
    "type": "review",
    "reviewId": "1000369",
    "title": "十年·肖申克的救赎",
    "content": "距离斯蒂芬·金（Stephen King）和德拉邦特（Frank Darabont）们缔造这部伟大的作品已经有十年了……",
    "rating": 5,
    "usefulCount": 18958,
    "uselessCount": 735,
    "readCount": 1429865,
    "createdAt": "2005-05-12 20:44:13",
    "author": { "id": "1000152", "name": "大头绿豆", "location": null },
    "subjectId": "1292052",
    "subjectType": "movie",
    "subjectTitle": "肖申克的救赎",
    "scrapedAt": "2026-11-07T04:01:56.633Z"
}
```

Every row also carries a `url` field with its Douban page. You can download the dataset as JSON, CSV, Excel, XML or HTML.

### Tips and limits

- **Review order is "most helpful" (hot) only.** Douban shows the newest-first order only to logged-in users, and this Actor never logs in.
- **About 40 reviews and about 120 short comments per title** are visible without an account. Ask for more and you get what Douban shows; the log says how many were available.
- Comments come in three pools: watched or read (看过), want to (想看) and in progress (在看). Pick more than one in **Comment status** to get up to about 120 from each.
- Short comments that are only a star rating with no text are skipped and not charged. Duplicate links and search queries are removed before the run starts.
- TV series use the same links as movies (`movie.douban.com/subject/<id>/`).
- The Actor sends at most one request every 1-2 seconds per proxy session and switches IP when Douban pushes back. Keep **Parallel sessions** at 3 unless you need more speed.

### FAQ

#### Do I need a Douban account or cookies?

No. Everything comes from public data that Douban shows to visitors.

#### Why do I get fewer reviews than the title has?

Douban limits what visitors without an account can page through, to about 40 reviews per title. The Actor reports how many it could reach.

#### Can I get the newest reviews first?

No. Newest-first needs a login, so only the most helpful order is offered.

#### Is the review text complete?

Yes. Each review is fetched on its own, so you get the full article (often thousands of characters), plus the HTML version with paragraphs and images.

#### Can I use it from an AI agent or MCP client?

Yes. Call it through the [Apify MCP server](https://apify.com/apify/actors-mcp-server) or the API with a list of Douban links.

### Disclaimer

This Actor collects publicly visible data only. Reviews and comments are written by Douban users and may contain personal data; make sure your use complies with GDPR, China's PIPL and other laws that apply to you. Douban is a trademark of its owner, which does not endorse this tool.

### More tools from Tenfold Fleet

| Actor | Output |
|---|---|
| [AliExpress Reviews Scraper: Product Feedback & Photos Monitor](https://apify.com/tenfoldfleet/aliexpress-reviews-scraper) | review |
| [Amazon Reviews Summary - AI Insights & Star Breakdown](https://apify.com/tenfoldfleet/amazon-reviews-summary) | product review insights |
| [BBB Scraper: Business Leads, Ratings & New Reviews](https://apify.com/tenfoldfleet/bbb-scraper-leads-reviews) | business |
| [Booking Reviews Scraper - New Guest Reviews Monitor by Hotel](https://apify.com/tenfoldfleet/booking-reviews-scraper-new-reviews-monitor) | review |
| [Trustpilot Reviews Scraper - New Reviews Monitor & TrustScore](https://apify.com/tenfoldfleet/trustpilot-reviews-scraper-new-reviews-monitor) | review |
| [Bilibili Scraper - Videos, Comments, Danmaku & Search](https://apify.com/tenfoldfleet/bilibili-scraper) | video or comment |
| [Brand Mentions Monitor - Bluesky, Hacker News & Mastodon](https://apify.com/tenfoldfleet/brand-mentions-monitor) | mention |
| [Facebook Ads Library Scraper for Marketers](https://apify.com/tenfoldfleet/facebook-ads-library-scraper) | ad |
| [Facebook Ads Transcript - Spoken Hook, CTA, Offer & Angle](https://apify.com/tenfoldfleet/facebook-ads-transcript) | video ad transcript |
| [Facebook Reels Scraper: Views & Captions Monitor for Any Page](https://apify.com/tenfoldfleet/facebook-reels-scraper) | reel |
| [Facebook Reels Transcript - Facebook Video to Text, No Login](https://apify.com/tenfoldfleet/facebook-reels-transcript) | reel transcript |
| [Instagram Post Details Scraper - Carousel, Likes, Caption](https://apify.com/tenfoldfleet/instagram-post-details) | post |

All 122 tools: [apify.com/tenfoldfleet](https://apify.com/tenfoldfleet). If this Actor saves you time, save it (the bookmark on its Store page) and leave a review: both help other people find it. Found a bug or need another field? Tell us on the Issues tab of this page.

# Changelog

This Actor's version history is a separate document: https://apify.com/tenfoldfleet/douban-reviews-scraper/changelog.md

# Actor input Schema

## `urls` (type: `array`):

Movie, TV, book or music pages (movie.douban.com/subject/1292052, book.douban.com/subject/1007305), single reviews (movie.douban.com/review/1000369), group topics (www.douban.com/group/topic/...) or whole groups (www.douban.com/group/248952). Mobile m.douban.com links and bare numeric ids also work. Free Apify plan: up to 50 paid results per run.

## `maxReviewsPerSubject` (type: `integer`):

Long reviews (影评/书评) to fetch per movie, show, book or album, most helpful first, each with its full text. Douban shows about 40 reviews per title to visitors without an account; that is the practical ceiling. 0 = skip reviews.

## `maxCommentsPerSubject` (type: `integer`):

Short comments (短评) with star ratings to fetch per title, most popular first. Douban shows about 120 per status without an account. 0 = skip comments.

## `commentStatuses` (type: `array`):

Which short comments to fetch: done = watched/read/listened (看过), mark = want to (想看), doing = in progress (在看). Each status has its own pool of about 120.

## `includeSubjectDetails` (type: `boolean`):

Add one free row per title with its Douban rating, rating count, genres, directors, cast or authors, release dates and synopsis. If you ask for no reviews and no comments, at most 20 titles are processed per run.

## `searchQueries` (type: `array`):

Optional. Search Douban by name (Chinese or English), e.g. 肖申克的救赎 or Inception. Each result is one row.

## `searchType` (type: `string`):

What to search. Movies includes TV shows.

## `maxSearchResults` (type: `integer`):

How many search results to return per query.

## `scrapeTopSearchResults` (type: `integer`):

Also fetch reviews and comments for the first N results of each search, as if their URLs were in the list above. 0 = search results only.

## `maxTopicsPerGroup` (type: `integer`):

For group URLs: how many recent topics to fetch, each with its full text.

## `maxRepliesPerTopic` (type: `integer`):

Replies to fetch under each group topic. 0 = topic text only.

## `defaultSubjectType` (type: `string`):

What a bare numeric id in the URL list is. TV ids work as movie ids.

## `maxConcurrency` (type: `integer`):

Proxy sessions working in parallel. Each sends at most one request every 1-2 seconds to stay polite.

## `proxyConfiguration` (type: `object`):

Default: Apify datacenter proxy with a fresh IP per session, residential only as a last retry. Free Apify plan: up to 50 paid results per run.

## Actor input object example

```json
{
  "urls": [
    "https://movie.douban.com/subject/1292052/"
  ],
  "maxReviewsPerSubject": 10,
  "maxCommentsPerSubject": 20,
  "commentStatuses": [
    "done"
  ],
  "includeSubjectDetails": true,
  "searchType": "movie",
  "maxSearchResults": 20,
  "scrapeTopSearchResults": 0,
  "maxTopicsPerGroup": 20,
  "maxRepliesPerTopic": 0,
  "defaultSubjectType": "movie",
  "maxConcurrency": 3,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# Actor output Schema

## `results` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "urls": [
        "https://movie.douban.com/subject/1292052/"
    ],
    "maxReviewsPerSubject": 10,
    "maxCommentsPerSubject": 20
};

// Run the Actor and wait for it to finish
const run = await client.actor("tenfoldfleet/douban-reviews-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "urls": ["https://movie.douban.com/subject/1292052/"],
    "maxReviewsPerSubject": 10,
    "maxCommentsPerSubject": 20,
}

# Run the Actor and wait for it to finish
run = client.actor("tenfoldfleet/douban-reviews-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "urls": [
    "https://movie.douban.com/subject/1292052/"
  ],
  "maxReviewsPerSubject": 10,
  "maxCommentsPerSubject": 20
}' |
apify call tenfoldfleet/douban-reviews-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,tenfoldfleet/douban-reviews-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/chKFXs1S4gZfPoTpz/builds/V0msm6AzaSPTwZPvJ/openapi.json
