# Douban Reviews Scraper 豆瓣影评 | Movie, Book & Music Reviews (`zen-studio/douban-reviews-scraper`) Actor

Scrape Douban (豆瓣) movie, TV, book and music reviews: full text, star rating, author, date and votes. Every listed review, a 1 to 5 star filter and keyword search. Reply threads included. Export JSON, CSV or Excel.

- **URL**: https://apify.com/zen-studio/douban-reviews-scraper.md
- **Developed by:** [Zen Studio](https://apify.com/zen-studio) (community)
- **Categories:** Social media, Automation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $3.99 / 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?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.
Actors are written with capital "A".

## 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.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

## Douban (豆瓣) Reviews Scraper | Movie, Book & Music Reviews with Star Filter (2026)

<a href="https://console.apify.com/actors/JYlmDTHNTQZt2F9pn/input"><img src="https://api.apify.com/v2/key-value-stores/pJ7iaZsTFhR3k9tjV/records/douban-reviews-readme-hero-v1.png" alt="Douban reviews scraper compared with a competing scraper: all 14,897 reviews of 肖申克的救赎, a 1-star filter and reviews from a keyword such as 三体" width="774" style="max-width:100%"></a>

From **Zen Studio**, creators of [RedNote Comments](https://apify.com/zen-studio/rednote-comments-scraper) and [Douyin Search](https://apify.com/zen-studio/douyin-search-scraper), with **95,000+ combined lifetime runs**.

### Why choose this actor?

- **Every review, not the first 1,000.** Douban lists 14,897 reviews for 肖申克的救赎 (The Shawshank Redemption), and the actor pages through all of them. The most-used competing Douban scraper stops at 1,000 per run.
- **Only the star ratings you want.** Pick 1 and 2 stars for a negative-review dataset: other reviews are skipped before they load, so you pay only for matches. That scraper has no star filter.
- **Start from a keyword.** Type 三体 and get the reviews of the best matching books, films and albums, where it needs title links. Every review has 60 fields, including full text as Markdown, author, dates, votes and replies.

<a href="https://console.apify.com/actors/JYlmDTHNTQZt2F9pn/input"><img src="https://api.apify.com/v2/key-value-stores/pJ7iaZsTFhR3k9tjV/records/douban-cta-start-v1.png" alt="Start with a Douban link" width="308"></a>

### Try the example: low-rated reviews of a classic

Open the actor's [input page](https://console.apify.com/actors/JYlmDTHNTQZt2F9pn/input), switch to JSON and paste this to collect 10 one-star and two-star reviews of The Shawshank Redemption. Then start the run.

```json
{
  "startUrls": ["https://movie.douban.com/subject/1292052/"],
  "stars": ["1", "2"],
  "maxReviews": 10
}
```

Leave `stars` empty to collect every review. You are charged per review received, see [pricing](#how-much-does-it-cost-to-scrape-douban-reviews).

 

<table>
<tr>
<td colspan="4" style="padding:10px 14px;background:#007711;border:none;border-radius:4px 4px 0 0">
<span style="color:#FAFAF9;font-size:14px;font-weight:700;letter-spacing:0.5px">Zen Studio Chinese Reviews Data</span>
<span style="color:#E8F5E9;font-size:13px">&nbsp;&nbsp;&bull;&nbsp;&nbsp;Reviews and ratings from China's biggest platforms</span>
</td>
</tr>
<tr>
<td style="padding:12px 16px;border:1px solid #E7E5E4;border-radius:0 0 0 4px;background:#D3EDD9;border-right:none;border-top:none;vertical-align:top;width:25%">
<span style="white-space:nowrap"><img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-bQs2vUPAj8qDbK7EV-bMB0MSMGRY-douban-scraper-logo.png" width="20" height="20" style="vertical-align:middle" alt="Douban reviews scraper icon">&nbsp;&nbsp;<a href="https://apify.com/zen-studio/douban-reviews-scraper" style="color:#007711;text-decoration:none;font-weight:700;font-size:13px">Douban Reviews</a></span><br>
<span style="color:#007711;font-size:12px;font-weight:600">&#10148; You are here</span>
</td>
<td style="padding:12px 16px;border:1px solid #E7E5E4;background:#E8F5E9;border-right:none;border-top:none;vertical-align:top;width:25%">
<span style="white-space:nowrap"><img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-bQs2vUPAj8qDbK7EV-bMB0MSMGRY-douban-scraper-logo.png" width="20" height="20" style="vertical-align:middle" alt="Douban scraper icon">&nbsp;&nbsp;<a href="https://apify.com/zen-studio/douban-scraper" style="color:#1C1917;text-decoration:none;font-weight:700;font-size:13px">Douban Scraper</a></span><br>
<span style="color:#78716C;font-size:12px">Comments, groups, titles</span>
</td>
<td style="padding:12px 16px;border:1px solid #E7E5E4;background:#E8F5E9;border-right:none;border-top:none;vertical-align:top;width:25%">
<span style="white-space:nowrap"><img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-BoK3MbIR9v2fIf6Kc-8getWsTFqJ-xiaohongshu-search-scraper-logo-square.png" width="20" height="20" style="vertical-align:middle" alt="RedNote product reviews scraper icon">&nbsp;&nbsp;<a href="https://apify.com/zen-studio/rednote-product-reviews-scraper" style="color:#1C1917;text-decoration:none;font-weight:700;font-size:13px">RedNote Reviews</a></span><br>
<span style="color:#78716C;font-size:12px">Product reviews and ratings</span>
</td>
<td style="padding:12px 16px;border:1px solid #E7E5E4;border-radius:0 0 4px 0;background:#E8F5E9;border-top:none;vertical-align:top;width:25%">
<span style="white-space:nowrap"><img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-qiJM8oaLCfBelBxkP-ad7SxvAETZ-1688-wholesale-scraper-logo.png" width="20" height="20" style="vertical-align:middle" alt="1688 reviews scraper icon">&nbsp;&nbsp;<a href="https://apify.com/zen-studio/1688-reviews-scraper" style="color:#1C1917;text-decoration:none;font-weight:700;font-size:13px">1688 Reviews</a></span><br>
<span style="color:#78716C;font-size:12px">Buyer ratings and feedback</span>
</td>
</tr>
</table>

#### Copy to your AI assistant

```
zen-studio/douban-reviews-scraper on Apify. Scrapes Douban (豆瓣) movie, TV, book and music reviews with full text, a star filter and keyword search. Call ApifyClient("TOKEN").actor("zen-studio/douban-reviews-scraper").call(run_input={...}), then client.dataset(run["defaultDatasetId"]).list_items().items. Needs startUrls (Douban title or review links) or searchQueries. Full spec: GET https://api.apify.com/v2/acts/zen-studio~douban-reviews-scraper/builds/default (Bearer TOKEN) → inputSchema, actorDefinition.storages.dataset, readme. Token: https://console.apify.com/account/integrations
```

 

### Douban reviews scraper features

<table>
<tr>
<td style="padding:12px 16px;border:1px solid #E7E5E4;background:#F0FDF4;vertical-align:top;width:50%;border-radius:4px 0 0 0">
<span style="color:#1C1917;font-weight:700;font-size:14px">&#128221;&nbsp;&nbsp;60 fields per review</span><br>
<span style="color:#57534E;font-size:13px">Full text as Markdown, rating, votes, author, dates</span>
</td>
<td style="padding:12px 16px;border:1px solid #E7E5E4;background:#F0FDF4;vertical-align:top;width:50%;border-left:none;border-radius:0 4px 0 0">
<span style="color:#1C1917;font-weight:700;font-size:14px">&#11088;&nbsp;&nbsp;Star rating filter</span><br>
<span style="color:#57534E;font-size:13px">1 to 5 stars or unrated, skipped reviews cost nothing</span>
</td>
</tr>
<tr>
<td style="padding:12px 16px;border:1px solid #E7E5E4;background:#E8F5E9;vertical-align:top;width:50%;border-top:none">
<span style="color:#1C1917;font-weight:700;font-size:14px">&#128218;&nbsp;&nbsp;Every listed review</span><br>
<span style="color:#57534E;font-size:13px">14,897 for The Shawshank Redemption</span>
</td>
<td style="padding:12px 16px;border:1px solid #E7E5E4;background:#E8F5E9;vertical-align:top;width:50%;border-top:none;border-left:none">
<span style="color:#1C1917;font-weight:700;font-size:14px">&#128269;&nbsp;&nbsp;Reviews by keyword</span><br>
<span style="color:#57534E;font-size:13px">Best matching films, books and albums per term</span>
</td>
</tr>
<tr>
<td style="padding:12px 16px;border:1px solid #E7E5E4;background:#F0FDF4;vertical-align:top;width:50%;border-top:none;border-radius:0 0 0 4px">
<span style="color:#1C1917;font-weight:700;font-size:14px">&#128172;&nbsp;&nbsp;Reply threads included</span><br>
<span style="color:#57534E;font-size:13px">Nested replies attached at no extra charge</span>
</td>
<td style="padding:12px 16px;border:1px solid #E7E5E4;background:#F0FDF4;vertical-align:top;width:50%;border-top:none;border-left:none;border-radius:0 0 4px 0">
<span style="color:#1C1917;font-weight:700;font-size:14px">&#128279;&nbsp;&nbsp;Any title link</span><br>
<span style="color:#57534E;font-size:13px">Movies, TV series, books, music, mobile links too</span>
</td>
</tr>
</table>

 

### How to scrape Douban reviews

1. Open [Douban Reviews Scraper](https://apify.com/zen-studio/douban-reviews-scraper) and click **Try for free**.
2. Paste Douban title links or type search terms in the **Input** tab.
3. Set **Max reviews per title** and, if you like, the star ratings to keep.
4. Click **Start**, then export the reviews as JSON, CSV or Excel.

Ready-made inputs for the most common jobs:

#### Movie reviews: every review of a film

```json
{
  "startUrls": ["https://movie.douban.com/subject/1292052/"],
  "maxReviews": 1000
}
```

Raise `maxReviews` to go deeper. The Shawshank Redemption lists 14,897 reviews on Douban.

#### Negative reviews: only 1-star and 2-star ratings

```json
{
  "startUrls": [
    "https://movie.douban.com/subject/1292052/",
    "https://movie.douban.com/subject/26647087/"
  ],
  "stars": ["1", "2"],
  "maxReviews": 200
}
```

Use `unrated` for reviews posted without a star rating.

#### Book reviews by keyword: the best matching books for 三体

```json
{
  "searchQueries": ["三体"],
  "searchCategory": "book",
  "titlesPerSearch": 3,
  "maxReviews": 100
}
```

Chinese titles find far more than English ones: search `三体` rather than `The Three-Body Problem`.

#### One review with its reply thread

```json
{
  "startUrls": ["https://movie.douban.com/review/1000369/"],
  "includeReplies": true,
  "maxReplies": 200
}
```

### Input parameters

Set these in the **Input** tab, or pass them as JSON through the Apify API.

| Parameter | Type | Default | Description |
|-----------|------|---------|-------------|
| `startUrls` | string\[] | none | Douban movie, TV, book or music pages and single review links. Desktop and mobile links. Up to 1,000 per run. |
| `searchQueries` | string\[] | none | Keywords to find titles, then collect their reviews. Up to 100 per run. |
| `searchCategory` | string | `all` | `all`, `movie` (movies and TV), `book` or `music`. With `all`, each category adds its own best matches. |
| `titlesPerSearch` | integer | `3` | How many of the best matching titles to use per search term and category, up to 50. |
| `maxReviews` | integer | `100` | Reviews per title. |
| `stars` | string\[] | all | Star ratings to keep: `5`, `4`, `3`, `2`, `1`, `unrated`. Empty keeps every review; single review links are always kept. |
| `includeReplies` | boolean | `false` | Attach each review's reply thread, with nested replies, at no extra charge. |
| `maxReplies` | integer | `100` | Replies per review when `includeReplies` is on. |

### What Douban review data can you extract?

Every review row carries 60 fields:

- **Text**: `title`, `content`, `contentMarkdown`, `contentHtml`, `abstract`, `spoiler`, `photos`, `videos`
- **Rating and engagement**: `rating` (1 to 5), `ratingLabel`, `usefulCount`, `uselessCount`, `likesCount`, `commentsCount`, `collectionsCount`, `readCount`, donations
- **Author**: `author` with name, profile link, avatar, location, join date and followers; `ipLocation`, `publishedAt`, `editedAt`
- **Reviewed title**: `subjectTitle`, `subjectType`, `subjectYear`, `subjectRating`, `subjectGenres`, `subjectUrl`, plus `replies` when turned on

#### Review example

```json
{
  "type": "review",
  "reviewId": "1000369",
  "url": "https://movie.douban.com/review/1000369/",
  "sharingUrl": "https://www.douban.com/doubanapp/dispatch/review/1000369",
  "title": "十年·肖申克的救赎",
  "content": "距离斯蒂芬·金（Stephen King）和德拉邦特（Frank Darabont）们缔造这部伟大的作品已经有十年了。我知道美好的东西想必大家都能感受，但是很抱歉，我的聒噪仍将一如既往。\n在我眼里，肖申克的救赎与信念、自由和友谊有关。\n［1］信 念\n瑞德（Red）说，希望是危险的…",
  "contentMarkdown": "距离斯蒂芬·金（Stephen King）和德拉邦特（Frank Darabont）们缔造这部伟大的作品已经有十年了。我知道美好的东西想必大家都能感受，但是很抱歉，我的聒噪仍将一如既往。\n\n在我眼里，肖申克的救赎与信念、自由和友谊有关。\n\n**［1］信 念**\n\n瑞德（Red）说…",
  "contentHtml": "<div id='content'><p>距离斯蒂芬·金（Stephen King）和德拉邦特（Frank Darabont）们缔造这部伟大的作品已经有十年了。我知道美好的东西想必大家都能感受，但是很抱歉，我的聒噪仍将一如既往。</p><p>在我眼里，肖申克的救赎与信念、自由和友…",
  "abstract": "距离斯蒂芬·金（Stephen King）和德拉邦特（Frank Darabont）们缔造这部伟大的作品已经有十年了。我知道美好的东西想必大家都能感受，但是很抱歉，我的聒噪仍将一如既往。\r\n在我眼里，肖申克的救赎与信念、自由和友谊有关。\r\n［1］信 念\r\n瑞德（Red）说，希望是…",
  "rating": 5,
  "ratingLabel": "力荐",
  "reviewCategory": "影评",
  "activity": "看过",
  "spoiler": false,
  "isOriginal": true,
  "isRecommended": false,
  "isBookJuryReview": false,
  "usefulCount": 18945,
  "uselessCount": 735,
  "likesCount": 18945,
  "commentsCount": 1082,
  "resharesCount": 2202,
  "timelineShareCount": 2202,
  "collectionsCount": 10744,
  "readCount": 1427145,
  "giftsCount": 0,
  "donationsEnabled": false,
  "donationsCount": 30,
  "donorsCount": 30,
  "donationsAmountCny": 571.88,
  "donationsNotice": "随喜，多谢",
  "recentDonors": [
    {
      "id": "151161967",
      "uid": "151161967",
      "name": "风雨兼程",
      "url": "https://www.douban.com/people/151161967/",
      "avatar": "https://img3.doubanio.com/icon/up151161967-7.jpg",
      "gender": null,
      "location": null,
      "registeredAt": "2016-09-15T11:00:31+08:00",
      "followersCount": null,
      "isClub": false,
      "isGroupManager": null,
      "isBanned": null,
      "isReadOnly": null,
      "isVerified": null,
      "verifyType": null,
      "verifyTitle": null,
      "badgeIcon": "https://img1.doubanio.com/img/files/file-1609326400.png",
      "medals": []
    },
    // ... 2 more
  ],
  "replyPermission": "A",
  "replyPermissionLabel": "anyone",
  "ipLocation": null,
  "updatedIpLocation": null,
  "publishedAt": "2005-05-12T20:44:13+08:00",
  "editedAt": null,
  "coverUrl": null,
  "photos": [
    "https://img2.doubanio.com/view/thing_review/l/public/p682261.jpg"
  ],
  "videos": [],
  "interestTags": [],
  "anthologies": [],
  "copyright": null,
  "censorInfo": null,
  "notices": [],
  "author": {
    "id": "1000152",
    "uid": "bighead",
    "name": "大头绿豆",
    "url": "https://www.douban.com/people/1000152/",
    "avatar": "https://img3.doubanio.com/icon/up1000152-23.jpg",
    "gender": null,
    "location": "深圳",
    "registeredAt": "2005-04-06T11:31:51+08:00",
    "followersCount": 16445,
    "isClub": false,
    "isGroupManager": null,
    "isBanned": false,
    "isReadOnly": null,
    "isVerified": false,
    "verifyType": 0,
    "verifyTitle": null,
    "badgeIcon": null,
    "medals": []
  },
  "authorReviewCount": 1,
  "subjectId": "1292052",
  "subjectTitle": "肖申克的救赎",
  "subjectType": "movie",
  "subjectUrl": "https://movie.douban.com/subject/1292052/",
  "subjectYear": "1994",
  "subjectRating": 9.7,
  "subjectRatingCount": 3340371,
  "subjectCardSubtitle": "1994 / 美国 / 剧情 犯罪 / 弗兰克·德拉邦特 / 蒂姆·罗宾斯 摩根·弗里曼",
  "subjectGenres": [
    "剧情",
    "犯罪"
  ],
  "subjectCoverUrl": "https://img3.doubanio.com/view/photo/m_ratio_poster/public/p2934829882.jpg",
  "scrapedAt": "2026-09-15T05:40:42+00:00",
  "replies": [
    {
      "replyId": "530",
      "content": "说得好.又看到了喜欢的电影，看到有人对它的评价，而且深合我心，不亦快哉？！在这个清晨，这些文字不但吸引了我的眼球，也吸引了我的心灵。\r\n说到自由，想起了《brave heart》里华莱士临刑前那振聋发馈的高呼：Freedom!两部电影的表现方式不同，但都唤起了我的自由意识。",
      "votes": 14,
      "reactionText": null,
      "ipLocation": null,
      "publishedAt": "2005-05-13T08:42:22+08:00",
      "author": {
        "id": "1000398",
        "uid": "tree",
        "name": "Summer",
        "url": "https://www.douban.com/people/1000398/",
        "avatar": "https://img9.doubanio.com/icon/up1000398-26.jpg",
        "gender": null,
        "location": "北京",
        "registeredAt": "2005-04-20T16:39:12+08:00",
        "followersCount": null,
        "isClub": false,
        "isGroupManager": null,
        "isBanned": null,
        "isReadOnly": null,
        "isVerified": null,
        "verifyType": null,
        "verifyTitle": null,
        "badgeIcon": null,
        "medals": []
      },
      "isFromAuthor": false,
      "parentReplyId": null,
      "quotedReplyId": null,
      "quotedContent": null,
      "quotedAuthor": null,
      "mentions": [],
      "photos": [],
      "isFolded": false,
      "isDeleted": false,
      "isDisabled": false,
      "totalReplies": 17,
      "replies": [
        {
          "replyId": "8527502",
          "content": "喜欢勇敢的心",
          "votes": 4,
          "reactionText": null,
          "ipLocation": null,
          "publishedAt": "2017-06-16T22:04:28+08:00",
          "author": {
            "id": "145579616",
            "uid": "145579616",
            "name": "张松涛",
            "url": "https://www.douban.com/people/145579616/",
            "avatar": "https://img2.doubanio.com/icon/up145579616-1.jpg",
            "gender": null,
            "location": "驻马店",
            "registeredAt": "2016-05-09T07:17:04+08:00",
            "followersCount": null,
            "isClub": false,
            "isGroupManager": null,
            "isBanned": null,
            "isReadOnly": null,
            "isVerified": null,
            "verifyType": null,
            "verifyTitle": null,
            "badgeIcon": null,
            "medals": []
          },
          "isFromAuthor": false,
          "parentReplyId": "530",
          "quotedReplyId": "530",
          "quotedContent": "说得好.又看到了喜欢的电影，看到有人对它的评价，而且深合我心，不亦快哉？！在这个清晨，这些文字不但吸引了我的眼球，也吸引了我的心灵。\r\n说到自由，想起了《brave heart》里华莱士临刑前那振聋发馈的高呼：Freedom!两部电影的表现方式不同，但都唤起了我的自由意识。",
          "quotedAuthor": "Summer",
          "mentions": [],
          "photos": [],
          "isFolded": false,
          "isDeleted": false,
          "isDisabled": false
        },
        // ... 16 more
      ]
    },
    // ... 2 more
  ]
}
```

### Advanced usage

Ready-made configurations for Chinese sentiment analysis datasets, LLM training corpora, book and film research, and music criticism.

#### Sentiment dataset: the best and worst reviews of several titles

```json
{
  "startUrls": [
    "https://movie.douban.com/subject/1292052/",
    "https://movie.douban.com/subject/26647087/",
    "https://book.douban.com/subject/2567698/"
  ],
  "stars": ["1", "2", "5"],
  "maxReviews": 300
}
```

Every review keeps its `rating`, ready to use as a label.

#### Chinese book reviews corpus: top books for several genres

```json
{
  "searchQueries": ["科幻", "悬疑", "历史"],
  "searchCategory": "book",
  "titlesPerSearch": 5,
  "maxReviews": 200
}
```

#### Music criticism: album reviews by artist

```json
{
  "searchQueries": ["周杰伦"],
  "searchCategory": "music",
  "titlesPerSearch": 5,
  "maxReviews": 100
}
```

### Schedule Douban review runs and connect your tools

Run the titles you track **weekly** to pick up new reviews, and keep only rows with a `reviewId` you have not stored yet.

Send each finished run to **Google Sheets**, **Make**, **Zapier** or **n8n**, trigger a **webhook** when it completes, or pull the dataset with the Apify API and the Python or JavaScript client.

How to run the scraper and put it on a schedule (official Apify videos):

https://www.youtube.com/watch?v=1OW8gOqlZbY

https://www.youtube.com/watch?v=1jI7WcVQmwM

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

**$4.99 per 1,000 reviews.** You pay for the reviews you receive; replies are included, and reviews skipped by the star filter are not charged.

| Reviews | Cost |
|---------|------|
| 100 | $0.50 |
| 1,000 | $4.99 |

Apify plans with Store discounts pay less, down to $3.99 per 1,000.

Set a maximum cost per run in the Apify Console; the run stops once it is reached.

### FAQ

**What is Douban (豆瓣)?**
Douban (豆瓣, literally "bean petal", at douban.com) is China's reviews and interest community, where readers and viewers post long-form reviews: film reviews (影评), book reviews (书评) and music reviews (乐评).

Its ratings are the reference scores for Chinese films and books. This actor collects those reviews for any movie, TV series, book or album.

**Is there an official Douban API for reviews?**
Not for new developers: Douban closed its public developer API years ago.

This actor returns the reviews as structured JSON you can download or pull with the Apify API.

**How many reviews can I collect for one title?**
Every review the title lists. The Shawshank Redemption shows 14,897.

Private or deleted reviews are skipped and not charged.

**How does the star filter work?**
Pick the ratings to keep in `stars`. Reviews with other ratings are skipped before they load, so they cost nothing.

`unrated` keeps reviews posted without a star rating. Rare ratings on titles with thousands of reviews take longer to find, because the whole list is checked.

**Do I get the full text of every review?**
Yes. Each review comes with its complete text as plain text, Markdown and the original HTML, together with the author, dates, rating and votes.

**Can I get the newest reviews first?**
No. Douban lists reviews publicly in its own order, most helpful first, and the actor follows that order.

To follow a title over time, schedule a weekly run and keep reviews whose `reviewId` is new.

**How does keyword search pick titles?**
It takes the best matches Douban returns for the term, per category, up to `titlesPerSearch`. With `searchCategory` set to `all`, films and TV, books and music each add their own matches.

**Can I also get short comments, group discussions or title details?**
Not in this actor. [Douban Scraper](https://apify.com/zen-studio/douban-scraper) collects short comments with star ratings, whole groups of discussions and full title details, from the same links.

**Can I paste links from the Douban mobile site?**
Yes. `m.douban.com` links for titles and reviews work like desktop links.

**Why is the text in Chinese?**
Douban is a Chinese-language platform, and the actor keeps the original text. Translate it afterwards with DeepL, Google Translate or an LLM if needed.

**Why don't Douban image links open in my browser?**
Douban only serves its images to visitors coming from Douban pages. Download them with the Referer header set to `https://www.douban.com/`.

**Why did a run return fewer reviews than expected?**
The title may list fewer reviews than `maxReviews`, or the star filter matched only some of them. Private or deleted links are skipped with a short warning.

Check that each link is a public Douban movie, TV, book or music page. If something still looks wrong, open an issue in the Issues tab.

**How do I export the data?**
Download JSON, CSV, Excel, XML or HTML from the run's Storage tab, or use the Apify API. JSON keeps nested fields such as `author` and `replies` intact.

**How fresh is the data?**
It is collected live when the run starts. Every row has a `scrapedAt` timestamp, so votes and reads reflect that moment.

**Is it legal to scrape Douban reviews?**
The actor collects publicly available reviews only. Author names, locations and profile links are personal data.

You are responsible for complying with Douban's terms and data protection laws, including GDPR, CCPA and China's PIPL.

### More Zen Studio scrapers for Chinese platforms

**🎬 Short-video & social**

- <img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-bQs2vUPAj8qDbK7EV-bMB0MSMGRY-douban-scraper-logo.png" width="16" height="16" alt="Douban 豆瓣 scraper icon" style="vertical-align:middle;border-radius:3px"> **Douban 豆瓣**
  - [Douban Scraper](https://apify.com/zen-studio/douban-scraper)
- <img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-wsZZkHvCzyyfZQdaJ-1H1H3xrBpO-weibo-scraper-logo.png" width="16" height="16" style="vertical-align:middle;border-radius:3px"> **Weibo 微博**
  - [Weibo Comments Scraper](https://apify.com/zen-studio/weibo-comments-scraper)
  - [Weibo Search Scraper](https://apify.com/zen-studio/weibo-search-scraper)
- <img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-YOq90GHMVnTe8qtHO-UAXIIQ87Oj-zhihu-scraper-logo.png" alt="Zhihu 知乎 scraper" width="16" height="16" style="vertical-align:middle;border-radius:3px"> **Zhihu 知乎**
  - [Zhihu Scraper](https://apify.com/zen-studio/zhihu-scraper)
- <img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-CYLXgIAUzINmhWnzw-Cov56uxElo-kuaishou-scraper-logo.jpg" width="16" height="16" alt="Kuaishou 快手 scraper icon" style="vertical-align:middle;border-radius:3px"> **Kuaishou 快手**
  - [Kuaishou Scraper](https://apify.com/zen-studio/kuaishou-scraper)
- <img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-3TJaaOJDU1AMiOoJM-Vu2eVr0P6N-douyin-profile-scraper-logo.png" width="16" height="16" style="vertical-align:middle;border-radius:3px"> **Douyin 抖音**
  - [Douyin Search Scraper](https://apify.com/zen-studio/douyin-search-scraper)
  - [Douyin Profile Scraper](https://apify.com/zen-studio/douyin-profile-scraper)
  - [Douyin Video Scraper](https://apify.com/zen-studio/douyin-video-scraper)
  - [Douyin Comments Scraper](https://apify.com/zen-studio/douyin-comments-scraper)
  - [Douyin Transcripts Scraper](https://apify.com/zen-studio/douyin-transcripts-scraper)
  - [Douyin Creator Rankings Scraper](https://apify.com/zen-studio/douyin-xingtu-rankings-scraper)
  - [Douyin Live Recorder](https://apify.com/zen-studio/douyin-live-recorder)
  - [Douyin Hot Search Scraper](https://apify.com/zen-studio/douyin-hot-search-scraper)
  - [Douyin Product Search Scraper](https://apify.com/zen-studio/douyin-product-search-scraper)
  - [Douyin User Search Scraper](https://apify.com/zen-studio/douyin-user-search-scraper)
- <img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-mHKEEgoDqr6btQQer-fUs5ZquIeN-xiaohongshu-search-scraper-logo-square.png" width="16" height="16" style="vertical-align:middle;border-radius:3px"> **RedNote 小红书**
  - [RedNote User Profile Scraper](https://apify.com/zen-studio/rednote-user-profile-scraper)
  - [RedNote Search Scraper](https://apify.com/zen-studio/rednote-search-scraper)
  - [RedNote Comments Scraper](https://apify.com/zen-studio/rednote-comments-scraper)
  - [RedNote Product Search Scraper](https://apify.com/zen-studio/rednote-product-search-scraper)
  - [RedNote Note Detail Scraper](https://apify.com/zen-studio/rednote-note-detail-scraper)
  - [RedNote Product Reviews Scraper](https://apify.com/zen-studio/rednote-product-reviews-scraper)
  - [RedNote Live Recorder](https://apify.com/zen-studio/rednote-live-recorder)
- <img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-dexCSKEZtKS8hg4fT-lD4weyiYga-shigua-____-scraper-logo.jpg" width="16" height="16" style="vertical-align:middle;border-radius:3px"> **Xigua 西瓜视频**
  - [Xigua Video Search Scraper](https://apify.com/zen-studio/xigua-video-search-scraper)
  - [Xigua Video Detail Scraper](https://apify.com/zen-studio/xigua-video-detail-scraper)
- <img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-oSxuPDE1h3HAsHZSu-x3uV98mgTe-bilibili-scraper-logo.png" width="16" height="16" style="vertical-align:middle;border-radius:3px"> **Bilibili 哔哩哔哩**
  - [Bilibili Video Scraper](https://apify.com/zen-studio/bilibili-video-scraper)
  - [Bilibili Danmaku Scraper](https://apify.com/zen-studio/bilibili-danmaku-scraper)

**🛒 E-commerce**

- <img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-LwARSYSMWLBZfXfdr-FrDaNbQarB-shopee-scraper-logo.png" width="16" height="16" style="vertical-align:middle;border-radius:3px"> **Shopee**
  - [Shopee Product Detail Scraper](https://apify.com/zen-studio/shopee-product-detail-scraper)
  - [Shopee Product Reviews Scraper](https://apify.com/zen-studio/shopee-product-reviews-scraper)
  - [Shopee Product Scraper](https://apify.com/zen-studio/shopee-product-scraper)
- <img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-PsAKYWM55HG4AHXjK-ItywU7Bp0s-taobao-search-scraper-logo.png" width="16" height="16" style="vertical-align:middle;border-radius:3px"> **Taobao 淘宝**
  - [Taobao Search Scraper](https://apify.com/zen-studio/taobao-search-scraper)
  - [Taobao Product Detail Scraper](https://apify.com/zen-studio/taobao-detail-scraper)
  - [Taobao Seller Products Scraper](https://apify.com/zen-studio/taobao-seller-products-scraper)
- <img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-uZy6tbKLKnSVtT4BN-emXnT123uR-jd-com-scraper-logo-square.png" width="16" height="16" style="vertical-align:middle;border-radius:3px"> **JD.com 京东**
  - [JD.com Search Scraper](https://apify.com/zen-studio/jd-com-search-scraper)
- <img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-ghXSMZcW3GxsCrkiR-5hnvsKv4Yt-1688-wholesale-scraper-logo.png" width="16" height="16" style="vertical-align:middle;border-radius:3px"> **1688 阿里巴巴**
  - [1688 Wholesale Scraper](https://apify.com/zen-studio/1688-wholesale-scraper)
  - [Alibaba Scraper](https://apify.com/zen-studio/alibaba-scraper)
  - [1688 Reviews Scraper](https://apify.com/zen-studio/1688-reviews-scraper)
- <img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-eab843E8WtuH7V3oz-a9TgvZnNOZ-weidian-scraper-icon.png" width="16" height="16" alt="Weidian 微店 scraper icon" style="vertical-align:middle;border-radius:3px"> **Weidian 微店**
  - [Weidian Scraper](https://apify.com/zen-studio/weidian-scraper)
- <img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-5QcLc4BHaLMBUKYs3-f3CWQ60Row-goofish-search-scraper-logo.png" width="16" height="16" style="vertical-align:middle;border-radius:3px"> **Goofish 闲鱼**
  - [Goofish (Xianyu) Search Scraper](https://apify.com/zen-studio/goofish-xianyu-search-scraper)
  - [Goofish (Xianyu) Seller Scraper](https://apify.com/zen-studio/goofish-xianyu-seller-scraper)
  - [Goofish (Xianyu) Item Detail Scraper](https://apify.com/zen-studio/goofish-xianyu-item-detail-scraper)
  - [Goofish (Xianyu) Item Comments & Q\&A Scraper](https://apify.com/zen-studio/goofish-xianyu-item-comments-scraper)
  - [Goofish (Xianyu) Reverse Image Search Scraper](https://apify.com/zen-studio/goofish-xianyu-visual-search-scraper)
- <img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-0hS9yNh3RU8DC6puG-LozxRJkdHN-coupang-review-scraper-logo.png" width="16" height="16" style="vertical-align:middle;border-radius:3px"> **Coupang 쿠팡**
  - [Coupang Review Scraper](https://apify.com/zen-studio/coupang-review-scraper)
  - [Coupang Search Scraper](https://apify.com/zen-studio/coupang-search-scraper)
  - [Coupang Product Detail Scraper](https://apify.com/zen-studio/coupang-detail-scraper)

**🏠 Real estate & autos**

- <img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-1tAzNSf8Kz0v7Q2Lr-AINJ7FsZVU-anjuke-scraper-logo.jpg" width="16" height="16" style="vertical-align:middle;border-radius:3px"> **Anjuke 安居客**
  - [Anjuke For-Sale Listings Scraper](https://apify.com/zen-studio/anjuke-real-estate-scraper)
  - [Anjuke New-Home Scraper](https://apify.com/zen-studio/anjuke-new-home-scraper)
  - [Anjuke Rental Listings Scraper](https://apify.com/zen-studio/anjuke-rent-scraper)
  - [Anjuke Listing Detail Scraper](https://apify.com/zen-studio/anjuke-sale-detail-scraper)
- <img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-32OkWqsiUywoq2ci3-7JhFlW1qg3-58__-real-estate-scraper-logo.jpg" width="16" height="16" style="vertical-align:middle;border-radius:3px"> **58.com 58同城**
  - [58.com Real Estate Scraper](https://apify.com/zen-studio/58-real-estate-scraper)
- <img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-ytaE4YpSmjXDmibPv-L1UMPHa2bO-che168-autohome-scraper-logo.png" width="16" height="16" style="vertical-align:middle;border-radius:3px"> **Autohome 汽车之家**
  - [Autohome (Che168) Used-Car Scraper](https://apify.com/zen-studio/che168-car-scraper)

### Support

- **Bugs**: Issues tab
- **Features**: Issues tab

### Legal Compliance

Extracts publicly available data. Users must comply with Douban terms and data protection regulations (GDPR, CCPA, PIPL).

***

*Douban movie, book and music reviews with star filter and keyword search, as structured JSON.*

# Actor input Schema

## `startUrls` (type: `array`):

Add any mix of Douban links:<br>• <b>Movie, TV, book or music page</b>: <code>https://movie.douban.com/subject/1292052/</code><br>• <b>Single review</b>: <code>https://movie.douban.com/review/1000369/</code><br><br>Mobile links (<code>m.douban.com</code>) work too. Up to 1,000 links per run.

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

Enter keywords to find titles, then collect the reviews of the best matches.<br><br>Tip: Chinese titles find far more, e.g. <code>三体</code> instead of <code>The Three-Body Problem</code>.<br><br>Up to 100 search terms per run.

## `searchCategory` (type: `string`):

Choose where to look for titles. With <b>Everything</b>, each category adds its own best matches.

## `titlesPerSearch` (type: `integer`):

Set how many of the best matching titles to collect reviews from, per search term and category.

## `maxReviews` (type: `integer`):

Set how many reviews to collect from each title. Every review Douban lists is available: 14,897 for <i>The Shawshank Redemption</i>.<br><br>Keep it low for a quick first run.

## `stars` (type: `array`):

Pick star ratings to keep only matching reviews, for example 1 and 2 stars for negative reviews. Leave empty to collect every review. Single review links are always kept.<br><br>You pay only for the reviews you receive.

## `includeReplies` (type: `boolean`):

Turn on to attach the reply thread to every review. Replies are included at no extra charge.

## `maxReplies` (type: `integer`):

Set how many replies to attach to each review. Only used when <b>Include replies</b> is on.

## Actor input object example

```json
{
  "startUrls": [
    "https://movie.douban.com/subject/1292052/"
  ],
  "searchCategory": "all",
  "titlesPerSearch": 3,
  "maxReviews": 20,
  "includeReplies": false,
  "maxReplies": 100
}
```

# 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 = {
    "startUrls": [
        "https://movie.douban.com/subject/1292052/"
    ],
    "maxReviews": 20
};

// Run the Actor and wait for it to finish
const run = await client.actor("zen-studio/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 = {
    "startUrls": ["https://movie.douban.com/subject/1292052/"],
    "maxReviews": 20,
}

# Run the Actor and wait for it to finish
run = client.actor("zen-studio/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 '{
  "startUrls": [
    "https://movie.douban.com/subject/1292052/"
  ],
  "maxReviews": 20
}' |
apify call zen-studio/douban-reviews-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,zen-studio/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/JYlmDTHNTQZt2F9pn/builds/alEzAVvSfuWSXo5Xj/openapi.json