# Douban Scraper 豆瓣 | Movie & Book Reviews, Comments, Groups (`zen-studio/douban-scraper`) Actor

Scrape Douban (豆瓣) movie, TV, book and music reviews with full text, short comments with star ratings, and group discussions with replies. Get title details: rating, votes, genres, cast, synopsis. Paste links or search by keyword. Export JSON, CSV or Excel.

- **URL**: https://apify.com/zen-studio/douban-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 (豆瓣) Scraper | Reviews, Short Comments, Group Discussions & Ratings (2026)

<a href="https://console.apify.com/actors/bQs2vUPAj8qDbK7EV/input"><img src="https://api.apify.com/v2/key-value-stores/pJ7iaZsTFhR3k9tjV/records/douban-readme-hero-v1.png" alt="Douban scraper compared with a competing scraper: 542 short comments for 肖申克的救赎, whole Douban groups, and 299 search results for 三体" 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?

- **Movie and TV comments with star ratings.** 542 short comments for 肖申克的救赎 (The Shawshank Redemption), with good, neutral and bad ratings. The most-used competing Douban scraper returns none for movies.
- **Whole groups and deeper search.** One group link collects discussions in every order and tag, with reply threads, where that scraper takes one thread per link. A search for 三体 returns 299 titles with full details, against its 23.
- **Reviews with author and date.** 60 fields per review, including publish and edit dates, useful votes, reads, IP location, the full text as Markdown and nested replies. Its movie reviews have 17 fields and no author or date.

<a href="https://console.apify.com/actors/bQs2vUPAj8qDbK7EV/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 movie

Open the actor's [input page](https://console.apify.com/actors/bQs2vUPAj8qDbK7EV/input), switch to JSON and paste this to collect 100 short comments for The Shawshank Redemption. Then start the run.

```json
{
  "startUrls": ["https://movie.douban.com/subject/1292052/"],
  "subjectContent": ["comments"],
  "maxResults": 100
}
```

Set `maxResults` to 600 to get all 542. For a whole group, paste a group link such as `https://www.douban.com/group/740472/` and keep **From groups** on **All discussions**. Each comment and discussion is charged, see [pricing](#how-much-does-it-cost-to-scrape-douban).

 

<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 Social Data</span>
<span style="color:#E8F5E9;font-size:13px">&nbsp;&nbsp;&bull;&nbsp;&nbsp;Reviews, posts and discussions 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"><a href="https://apify.com/zen-studio/douban-scraper" style="color:#007711;text-decoration:none;font-weight:700;font-size:13px">Douban Scraper</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 reviews scraper icon">&nbsp;&nbsp;<a href="https://apify.com/zen-studio/douban-reviews-scraper" style="color:#1C1917;text-decoration:none;font-weight:700;font-size:13px">Douban Reviews</a></span><br>
<span style="color:#78716C;font-size:12px">Every review, star filter</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-hO5NqsA6aC1bz3jra-MjB05eVFEt-xiaohongshu-search-scraper-logo-square.png" width="20" height="20" style="vertical-align:middle">&nbsp;&nbsp;<a href="https://apify.com/zen-studio/rednote-search-scraper" style="color:#1C1917;text-decoration:none;font-weight:700;font-size:13px">RedNote Search</a></span><br>
<span style="color:#78716C;font-size:12px">Notes with media and stats</span>
</td>
<td style="padding:12px 16px;border:1px solid #E7E5E4;background:#E8F5E9;border-radius:0 0 4px 0;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-wsZZkHvCzyyfZQdaJ-1H1H3xrBpO-weibo-scraper-logo.png" width="20" height="20" style="vertical-align:middle">&nbsp;&nbsp;<a href="https://apify.com/zen-studio/weibo-search-scraper" style="color:#1C1917;text-decoration:none;font-weight:700;font-size:13px">Weibo Search</a></span><br>
<span style="color:#78716C;font-size:12px">Posts with engagement</span>
</td>
</tr>
</table>

#### Copy to your AI assistant

```
zen-studio/douban-scraper on Apify. Scrapes Douban (豆瓣) reviews, short comments, group discussions with replies, and movie, TV, book and music details. Call ApifyClient("TOKEN").actor("zen-studio/douban-scraper").call(run_input={...}), then client.dataset(run["defaultDatasetId"]).list_items().items. Needs startUrls (Douban links) or searchQueries; rows differ by type. Full spec: GET https://api.apify.com/v2/acts/zen-studio~douban-scraper/builds/default (Bearer TOKEN) → inputSchema, actorDefinition.storages.dataset, readme. Token: https://console.apify.com/account/integrations
```

 

### Douban 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</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">&#128172;&nbsp;&nbsp;Short comments with star ratings</span><br>
<span style="color:#57534E;font-size:13px">Up to 542 per movie, good, neutral and bad</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">&#128101;&nbsp;&nbsp;Group discussions</span><br>
<span style="color:#57534E;font-size:13px">Whole groups, every order and tag, with replies</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">&#127916;&nbsp;&nbsp;Full title details</span><br>
<span style="color:#57534E;font-size:13px">Rating, genres, cast or authors, synopsis, trailers</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">&#128269;&nbsp;&nbsp;Search that keeps paging</span><br>
<span style="color:#57534E;font-size:13px">Movies and TV, books, music, full details per hit</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 Douban link</span><br>
<span style="color:#57534E;font-size:13px">Titles, reviews, groups, discussions, mobile too</span>
</td>
</tr>
</table>

 

### How to scrape Douban reviews, comments and groups

1. Open [Douban Scraper](https://apify.com/zen-studio/douban-scraper) and click **Try for free**.
2. Paste Douban links or type search terms in the **Input** tab.
3. Choose what to collect and set **Max results**.
4. Click **Start**, then export the Douban data as JSON, CSV or Excel.

Ready-made inputs for the most common jobs:

#### Reviews: every long-form review of a movie

```json
{
  "startUrls": ["https://movie.douban.com/subject/1292052/"],
  "subjectContent": ["reviews"],
  "maxResults": 100
}
```

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

#### Short comments: star ratings for a book and a TV series

```json
{
  "startUrls": [
    "https://book.douban.com/subject/2567698/",
    "https://movie.douban.com/subject/26647087/"
  ],
  "subjectContent": ["comments"],
  "maxResults": 300
}
```

Each comment carries `rating` (1 to 5), `ratingLabel` and `status`: `done` (watched or read), `wish` (wants to) or `doing` (watching or reading).

For movies and TV, a higher `maxResults` also collects Douban's good, neutral and bad rating tabs: 542 comments for The Shawshank Redemption.

#### Groups: discussions with their reply threads

```json
{
  "startUrls": ["https://www.douban.com/group/740472/"],
  "groupSort": "all",
  "includeReplies": true,
  "maxReplies": 50,
  "maxResults": 50
}
```

#### Search: books by keyword, each with full details

```json
{
  "searchQueries": ["三体", "刘慈欣"],
  "searchCategory": "book",
  "maxResults": 20
}
```

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

### 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 links: movie, TV, book or music pages, reviews, groups and group discussions. Desktop and mobile links. Up to 1,000 per run. |
| `searchQueries` | string\[] | none | Keywords to find movies and TV, books or music. Up to 100 per run. |
| `searchCategory` | string | `all` | `all`, `movie` (movies and TV), `book` or `music`. With `all`, each category returns up to `maxResults`. |
| `maxResults` | integer | `100` | Items per link, search term and type of content. A title with reviews and comments selected returns up to this many of each. |
| `subjectContent` | string\[] | `["details", "reviews"]` | What title links return: `details`, `reviews`, `comments`. |
| `groupSort` | string | `all` | Which discussions group links return: `all` (every order and tag, newest first), `new`, `hot` (popular) or `elite` (featured). |
| `includeReplies` | boolean | `false` | Attach the reply thread to every review and group discussion. |
| `maxReplies` | integer | `100` | Replies per review or discussion when `includeReplies` is on. |

### What Douban data can you extract?

Every run returns up to four kinds of rows, told apart by `type`:

- **`review`** (60 fields): full text as plain text, Markdown and HTML, rating and label, useful and useless votes, reads, likes, reshares, donations, author profile, the reviewed title, optional replies with their full nested threads.
- **`comment`** (20 fields): short text, star rating, reader status, votes, location and date, author profile, the rated title.
- **`topic`** (65 fields): discussion title, full text as plain text, Markdown and HTML, tags, elite and lock flags, likes, reshares, author, group name, description, rules, category and owner, optional replies.
- **`subject`** (61 fields for a movie): rating and vote count, genres, countries, languages, directors, actors, aliases, synopsis, release dates, awards, trailers, streaming platforms. Books add authors, press, pages, price and catalog; music adds singers, tracks and media.

Text stays in the original Chinese. Timestamps are ISO 8601 in Beijing time (UTC+8).

The examples below are real rows. Long text is shortened with `…`, and lists show their first items with a `// ... N more` marker; every field is shown.

#### 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
  ]
}
```

#### Short comment example

```json
{
  "type": "comment",
  "commentId": "477351",
  "url": "https://www.douban.com/doubanapp/dispatch?uri=/movie/1292052/interest/477351",
  "content": "当年的奥斯卡颁奖礼上，被如日中天的《阿甘正传》掩盖了它的光彩，而随着时间的推移，这部电影在越来越多的人们心中的地位已超越了《阿甘》。每当现实令我疲惫得产生无力感，翻出这张碟，就重获力量。毫无疑问，本片位列男人必看的电影前三名！回顾那一段经典台词：“有的人的羽翼是如此光辉，即使世界…",
  "rating": 5,
  "ratingLabel": "力荐",
  "status": "done",
  "statusLabel": null,
  "votes": 23502,
  "recommendReason": null,
  "postedBeforeRelease": false,
  "ipLocation": null,
  "platforms": [],
  "publishedAt": "2005-10-28T00:28:07+08:00",
  "author": {
    "id": "1041052",
    "uid": "whiterhinoceros",
    "name": "犀牛",
    "url": "https://www.douban.com/people/1041052/",
    "avatar": "https://img9.doubanio.com/icon/up1041052-14.jpg",
    "gender": null,
    "location": "天津",
    "registeredAt": "2005-10-28T00:08:03+08:00",
    "followersCount": null,
    "isClub": false,
    "isGroupManager": null,
    "isBanned": null,
    "isReadOnly": null,
    "isVerified": null,
    "verifyType": null,
    "verifyTitle": null,
    "badgeIcon": null,
    "medals": []
  },
  "subjectId": "1292052",
  "subjectTitle": "肖申克的救赎",
  "subjectType": "movie",
  "subjectUrl": "https://movie.douban.com/subject/1292052/",
  "scrapedAt": "2026-09-15T05:39:19+00:00"
}
```

#### Group discussion example

```json
{
  "type": "topic",
  "topicId": "344321540",
  "url": "https://www.douban.com/group/topic/344321540/",
  "sharingUrl": "https://www.douban.com/doubanapp/dispatch?uri=%2Fgroup%2Ftopic%2F344321540%3F_spm_id%3DMjU2NDA1OTk0&_i=89450853",
  "title": "分享各种职业性格测试🔗帮助妳探索适合自己的职业",
  "content": "我适合什么工作？我最大的特点是什么？如何在工作中运用我的这些特点？\n\n毕业之后，面对就业我陷入了迷茫，因为我意识到我对自己的了解太少。\n\n从来没有人告诉过我自身有什么特长，我也看不见自己有何特长，于是我搜集了很多职业性格测试，增进对自己的了解，在职业发展中扬长避短。即使不能找到百…",
  "contentMarkdown": "我适合什么工作？我最大的特点是什么？如何在工作中运用我的这些特点？\n\n毕业之后，面对就业我陷入了迷茫，因为我意识到我对自己的了解太少。\n\n从来没有人告诉过我自身有什么特长，我也看不见自己有何特长，于是我搜集了很多职业性格测试，增进对自己的了解，在职业发展中扬长避短。即使不能找到百…",
  "contentHtml": "<div id='content'><p data-align=\"left\">我适合什么工作？我最大的特点是什么？如何在工作中运用我的这些特点？\n\n毕业之后，面对就业我陷入了迷茫，因为我意识到我对自己的了解太少。\n\n从来没有人告诉过我自身有什么特长，我也看不见自己有何特长，于是我…",
  "abstract": "我适合什么工作？我最大的特点是什么？如何在工作中运用我的这些特点？\r...",
  "label": null,
  "tags": [
    "经验分享"
  ],
  "subTags": [],
  "isElite": true,
  "eliteLabel": "精",
  "isLocked": false,
  "isAdminLocked": false,
  "isOriginal": true,
  "isPrivate": false,
  "isAd": false,
  "isEvent": false,
  "isAgentThread": false,
  "hasPoll": true,
  "commentsCount": 928,
  "likesCount": 418,
  "reactionsCount": 418,
  "resharesCount": 81,
  "collectionsCount": 1071,
  "readCount": 0,
  "giftsCount": 0,
  "replyPermission": "A",
  "replyPermissionLabel": "anyone",
  "ipLocation": "广东",
  "publishedAt": "2025-12-05T23:21:36+08:00",
  "updatedAt": "2026-09-14T17:22:47+08:00",
  "editedAt": "2026-01-23T10:32:53+08:00",
  "coverUrl": "https://img1.doubanio.com/view/group_topic/sqxs/public/p710720260.jpg",
  "photos": [
    "https://img1.doubanio.com/view/group_topic/l/public/p710720260.jpg",
    "https://img9.doubanio.com/view/group_topic/l/public/p710719535.jpg",
    // ... 1 more
  ],
  "video": null,
  "galleryTopic": null,
  "interestTags": [
    {
      "activityLabel": null,
      "cardSubtitle": "1万+篇内容 · 844万次浏览",
      "id": "9938",
      "isPublic": true,
      "name": "女性成长",
      "readCount": 8511984,
      "sharingUrl": "https://www.douban.com/search?q=%23%E5%A5%B3%E6%80%A7%E6%88%90%E9%95%BF%23",
      "title": "女性成长",
      "type": "search_term",
      "url": "https://www.douban.com/search?q=%23%E5%A5%B3%E6%80%A7%E6%88%90%E9%95%BF%23"
    },
    // ... 5 more
  ],
  "anthologies": [],
  "relatedSearchKeyword": null,
  "recommendedSearchKeyword": null,
  "author": {
    "id": "256405994",
    "uid": "256405994",
    "name": "∞的自行车",
    "url": "https://www.douban.com/people/256405994/",
    "avatar": "https://img9.doubanio.com/icon/up256405994-4.jpg",
    "gender": "female",
    "location": "Andorra",
    "registeredAt": "2022-04-29T09:19:45+08:00",
    "followersCount": null,
    "isClub": false,
    "isGroupManager": false,
    "isBanned": false,
    "isReadOnly": false,
    "isVerified": null,
    "verifyType": null,
    "verifyTitle": null,
    "badgeIcon": null,
    "medals": []
  },
  "authorTopicCount": 0,
  "groupId": "740472",
  "groupName": "平凡女性生存手册",
  "groupUrl": "https://www.douban.com/group/740472/",
  "groupMembers": 52590,
  "groupMemberTitle": "大女人",
  "groupTopicCount": 10675,
  "groupEliteCount": 262,
  "groupCategory": "生活",
  "groupDescription": "我们是平凡女性（含低收入群体），我们也是互帮互助的姐妹会。希望本组能够帮助在生活中遇到困难的女性脱离贫困和信息茧房。本组将作为一个纯女性生存互助的交流平台。\n\n\n进组要求-新版：账号6月以上，无其他组拒绝违禁记录（如果有可以私信管理员告知原因），主页管理员能看到的有动态，动态无辱…",
  "groupRules": "1 本组发言禁止非常见的缩写，首字母 2 本组禁止推广自媒体，课程，广告和交友群 3 本组不欢迎【不平凡】的言论 4 通常意义下违规贴/回复都算违规行为 5 请勿发布《社区指导原则》不允许的内容",
  "groupSlogan": "姐姐妹妹站起来",
  "groupSubtitle": "最近更新: 上班族的自制预制饭",
  "groupCreatedAt": "2023-10-16T12:26:30+08:00",
  "groupAvatar": "https://img1.doubanio.com/view/group/medium/public/12aad4c193f3869.jpg",
  "groupOwner": {
    "id": "192510900",
    "uid": "192510900",
    "name": "撸啦撸啦",
    "url": "https://www.douban.com/people/192510900/",
    "avatar": "https://img9.doubanio.com/icon/up192510900-4.jpg",
    "gender": "female",
    "location": "武汉",
    "registeredAt": "2019-02-27T16:44:39+08:00",
    "followersCount": null,
    "isClub": false,
    "isGroupManager": null,
    "isBanned": false,
    "isReadOnly": false,
    "isVerified": null,
    "verifyType": null,
    "verifyTitle": null,
    "badgeIcon": null,
    "medals": []
  },
  "groupJoinType": "R",
  "groupJoinPolicy": "join request needs approval",
  "groupIsOfficial": false,
  "scrapedAt": "2026-09-15T05:40:55+00:00",
  "replies": [
    {
      "replyId": "6281176662",
      "content": "收到 感谢🥹",
      "votes": 1,
      "reactionText": null,
      "ipLocation": "陕西",
      "publishedAt": "2025-12-05T23:23:04+08:00",
      "author": {
        "id": "176486044",
        "uid": "luenchanted",
        "name": "玻璃晴朗🎐",
        "url": "https://www.douban.com/people/luenchanted/",
        "avatar": "https://img9.doubanio.com/icon/up176486044-5.jpg",
        "gender": "female",
        "location": "Ulan Bator",
        "registeredAt": "2018-04-05T14:30:25+08:00",
        "followersCount": null,
        "isClub": false,
        "isGroupManager": false,
        "isBanned": false,
        "isReadOnly": false,
        "isVerified": false,
        "verifyType": 0,
        "verifyTitle": null,
        "badgeIcon": null,
        "medals": []
      },
      "isFromAuthor": null,
      "parentReplyId": null,
      "quotedReplyId": null,
      "quotedContent": null,
      "quotedAuthor": null,
      "mentions": [],
      "photos": [],
      "isFolded": false,
      "isDeleted": false,
      "isDisabled": false
    },
    // ... 149 more
  ]
}
```

#### Movie details example

```json
{
  "type": "subject",
  "subjectId": "1292052",
  "subjectTitle": "肖申克的救赎",
  "subjectType": "movie",
  "subjectUrl": "https://movie.douban.com/subject/1292052/",
  "hasFullDetails": true,
  "ratingValue": 9.7,
  "ratingCount": 3340361,
  "ratingMax": 10,
  "ratingStarCount": 5.0,
  "actors": [
    {
      "name": "蒂姆·罗宾斯"
    },
    // ... 24 more
  ],
  "aka": [
    "月黑高飞(港)",
    "刺激1995(台)",
    // ... 3 more
  ],
  "cardSubtitle": "1994 / 美国 / 剧情 犯罪 / 弗兰克·德拉邦特 / 蒂姆·罗宾斯 摩根·弗里曼",
  "commentCount": 665169,
  "controversyReason": "",
  "countries": [
    "美国"
  ],
  "cover": {
    "author": {
      "avatar": "https://img3.doubanio.com/icon/up221011676-2.jpg",
      "id": "221011676",
      "isClub": false,
      "kind": "user",
      "loc": {
        "id": "108288",
        "name": "北京",
        "uid": "beijing"
      },
      "name": "雨落下",
      "regTime": "2020-08-11 16:22:48",
      "type": "user",
      "uid": "221011676",
      "url": "https://www.douban.com/people/221011676/"
    },
    "createTime": "2026-08-10 11:22:01",
    "description": "",
    "id": "2934829882",
    "image": {
      "isAnimated": false,
      "isLive": false,
      "large": {
        "height": 1600,
        "size": 0,
        "url": "https://img3.doubanio.com/view/photo/l/public/p2934829882.jpg",
        "width": 1142
      },
      "normal": {
        "height": 600,
        "size": 0,
        "url": "https://img3.doubanio.com/view/photo/m/public/p2934829882.jpg",
        "width": 428
      },
      "primaryColor": "",
      "raw": null,
      "small": {
        "height": 600,
        "size": 0,
        "url": "https://img3.doubanio.com/view/photo/s/public/p2934829882.jpg",
        "width": 428
      }
    },
    "ownerUri": "douban://douban.com/movie/1292052",
    "position": 2,
    "sharingUrl": "https://www.douban.com/doubanapp/dispatch?uri=/photo/2934829882/",
    "type": "photo",
    "url": "https://movie.douban.com/photos/photo/2934829882/"
  },
  "coverUrl": "https://img3.doubanio.com/view/photo/m_ratio_poster/public/p2934829882.jpg",
  "directors": [
    {
      "name": "弗兰克·德拉邦特"
    }
  ],
  "durations": [
    "142分钟"
  ],
  "episodesCount": 0,
  "episodesInfo": "",
  "forumInfo": null,
  "forumTopicCount": 3767,
  "galleryTopicCount": 0,
  "genres": [
    "剧情",
    "犯罪"
  ],
  "hasLinewatch": false,
  "honorInfos": [
    {
      "kind": "movie",
      "rank": 1,
      "title": "豆瓣电影Top250"
    }
  ],
  "infoUrl": "https://www.douban.com/doubanapp//h5/movie/1292052/desc",
  "intro": "一场谋杀案使银行家安迪（蒂姆·罗宾斯 Tim Robbins 饰）蒙冤入狱，谋杀妻子及其情人的指控将囚禁他终生。在肖申克监狱的首次现身就让监狱“大哥”瑞德（摩根·弗里曼 Morgan Freeman 饰）对他另眼相看。瑞德帮助他搞到一把石锤和一幅女明星海报，两人渐成患难 之交。很…",
  "isDoubanIntro": true,
  "isReleased": true,
  "isRestrictive": false,
  "isShow": false,
  "isTv": false,
  "languages": [
    "英语"
  ],
  "lastEpisodeNumber": null,
  "linewatches": [],
  "nullRatingReason": "",
  "originalTitle": "The Shawshank Redemption",
  "pic": {
    "large": "https://img3.doubanio.com/view/photo/m_ratio_poster/public/p2934829882.jpg",
    "normal": "https://img3.doubanio.com/view/photo/s_ratio_poster/public/p2934829882.jpg"
  },
  "prePlayableDate": null,
  "preReleaseDesc": "",
  "pubdate": [
    "2026-08-28(中国大陆)"
  ],
  "rateInfo": "",
  "realtimeHotHonorInfos": [],
  "releaseDate": null,
  "reviewCount": 14897,
  "sharingUrl": "https://www.douban.com/doubanapp/dispatch/movie/1292052",
  "subjectCollections": [
    {
      "id": "film_genre_46",
      "isFollow": false,
      "title": "高分经典犯罪片榜"
    },
    // ... 2 more
  ],
  "tags": [
    "犯罪",
    "越狱",
    // ... 2 more
  ],
  "trailers": [
    {
      "coverUrl": "https://img3.doubanio.com/img/trailer/medium/2935310952.jpg",
      "createTime": "2026-08-28",
      "desc": "",
      "fileSize": 32791297,
      "id": "325959",
      "nComments": 1,
      "runtime": "01:30",
      "sharingUrl": "https://www.douban.com/doubanapp/dispatch?uri=/movie/1292052/trailer%3Ftrailer_id%3D325959%26trailer_type%3DA",
      "termNum": 0,
      "title": "中国大陆预告片 (中文字幕)",
      "type": "A",
      "typeName": "预告片",
      "videoUrl": "https://vt1.doubanio.com/202609151323/a14bce66231fff199e3a48db3600252e/view/movie/M/703250959.mp4"
    }
  ],
  "vendorCount": 0,
  "vendorDesc": "",
  "vendorIcons": [],
  "vendors": [],
  "video": null,
  "webisode": null,
  "webisodeCount": 0,
  "year": "1994",
  "scrapedAt": "2026-09-15T05:23:30+00:00"
}
```

### Advanced usage

Ready-made configurations for Chinese sentiment analysis datasets, LLM training corpora, film and book market research, and community monitoring.

#### Sentiment dataset: reviews and rated comments for several titles

```json
{
  "startUrls": [
    "https://movie.douban.com/subject/1292052/",
    "https://movie.douban.com/subject/26647087/",
    "https://book.douban.com/subject/2567698/"
  ],
  "subjectContent": ["reviews", "comments"],
  "maxResults": 500
}
```

Every review and comment has a 1 to 5 `rating`, ready to use as a label.

#### Community monitoring: the newest discussions in a group

```json
{
  "startUrls": ["https://www.douban.com/group/740472/"],
  "groupSort": "new",
  "maxResults": 30,
  "includeReplies": true,
  "maxReplies": 20
}
```

#### Catalog research: full details for every search result

```json
{
  "searchQueries": ["科幻", "悬疑"],
  "searchCategory": "all",
  "maxResults": 50
}
```

#### Discussion analysis: one review with its full reply thread

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

### Schedule Douban runs and connect your tools

Run the group example **daily** to follow new discussions, and the title examples **weekly** to pick up new reviews and comments on titles you track.

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?

**$4.99 per 1,000 reviews.** You pay for the rows you receive; replies inside a review or discussion are included.

| What you collect | Per 1,000 |
|------------------|-----------|
| Long-form reviews or group discussions | $4.99 |
| Short comments | $3.99 |
| Movie, TV, book or music titles | $3.99 |

Apify plans with Store discounts pay less, down to $3.99 and $2.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.

It covers Douban Movie (豆瓣电影), Douban Books (豆瓣读书), Douban Music (豆瓣音乐) and thousands of Douban Groups (豆瓣小组), and its ratings are the reference scores for Chinese films and books.

This scraper collects its reviews, short comments, group discussions and title details.

**Do I get the full text of long reviews?**
Yes. Every review comes with its complete text as plain text, Markdown and the original HTML, together with the author, date, rating, votes and the reviewed title.

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

This actor returns the same kind of data, reviews, ratings, comments and discussions, 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 many short comments can I collect?**
For a popular movie, up to about 540: the most popular comments for each reader status plus Douban's good, neutral and bad rating tabs. The Shawshank Redemption gave 542.

For books, about 300 across read, reading and want to read.

**Can I get the newest reviews or comments first?**
No. Douban lists reviews and comments publicly in its popularity order, and the scraper follows that order.

For fresh activity, schedule a group with `groupSort` set to `new`.

**How many discussions can I get from a group?**
With `groupSort` set to `all` (the default), most of the group: 9,706 of one group's 10,675 discussions in testing.

The newest order alone stops after about 300.

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

**Why is the text in Chinese?**
Douban is a Chinese-language platform, and the scraper 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/`.

**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 counts such as votes and reads reflect that moment.

**What happens with private or deleted links?**
The run logs a short warning, skips them and continues with the rest. Skipped items are not charged.

**How do I keep a run's cost under control?**
Set `maxResults` per link and a maximum cost per run in the Console. Short comments and title details cost less than long-form reviews.

**Is it legal to scrape Douban?**
The scraper collects publicly available data 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 Reviews Scraper](https://apify.com/zen-studio/douban-reviews-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 reviews, short comments, group discussions and title details 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>Review</b>: <code>https://movie.douban.com/review/1000369/</code><br>• <b>Group</b>: <code>https://www.douban.com/group/740472/</code><br>• <b>Group discussion</b>: <code>https://www.douban.com/group/topic/499747962/</code><br><br>Mobile links (<code>m.douban.com</code>) work too. Choose what title pages return under <b>📦 What to collect</b>.<br><br>Up to 1,000 links per run.

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

Enter keywords to find movies, TV shows, books or music. Every result includes full details: rating, genres, cast or authors, synopsis and more.<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 search. With <b>Everything</b>, each category returns up to <b>🔢 Max results</b>.

## `maxResults` (type: `integer`):

Set how many items to collect per link, search term and type of content.<br><br>Example: a movie page with reviews and short comments selected returns up to this many reviews <b>and</b> this many comments.<br><br>Keep it low for a quick first run.

## `subjectContent` (type: `array`):

Pick one or more:<br>• <b>Details</b>: rating, genres, cast or authors, synopsis and counts<br>• <b>Long-form reviews</b>: every review Douban lists for the title, with full text<br>• <b>Short comments</b>: star ratings with short text, including from people who want to watch or are watching. Up to about 540 for a popular movie, including Douban's good, neutral and bad rating tabs.

## `groupSort` (type: `string`):

Choose which discussions to collect from group links.<br><br><b>All discussions</b> combines every order and the group's tags, newest first, for the deepest coverage: 9,706 of a 10,675-discussion group in testing.<br><b>Newest</b> alone stops after about 300.

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

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

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

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

## Actor input object example

```json
{
  "startUrls": [
    "https://movie.douban.com/subject/1292052/"
  ],
  "searchCategory": "all",
  "maxResults": 10,
  "subjectContent": [
    "details",
    "reviews"
  ],
  "groupSort": "all",
  "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/"
    ],
    "maxResults": 10
};

// Run the Actor and wait for it to finish
const run = await client.actor("zen-studio/douban-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/"],
    "maxResults": 10,
}

# Run the Actor and wait for it to finish
run = client.actor("zen-studio/douban-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/"
  ],
  "maxResults": 10
}' |
apify call zen-studio/douban-scraper --silent --output-dataset

```

## MCP server setup

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