Douban Review list of subjects API
The long reviews (影评) written about a film or series, newest first, 20 per request.
Douban review list (mode reviews, type: "reviewSummary")
The long reviews (影评) written about a film or series, newest first, 20 per request. The list gives the title, the rating and the opening excerpt of each review, not the full text; for the full text of a review pass its link or ID to mode review.
| Field | Description |
|---|---|
title |
Title of the review |
userName |
Public display name of the reviewer |
ratingText |
The reviewer's rating word: 力荐, 推荐, 还行, 较差 or 很差; empty when the reviewer gave no rating |
stars |
The rating as 1-5 stars; empty when the reviewer gave no rating |
excerpt |
Opening excerpt of the review as Douban lists it (cut short) |
time |
Time the review was written |
upvoteCount |
Upvotes of the review |
downvoteCount |
Downvotes of the review |
replyCount |
Replies to the review |
reviewId |
Review ID, usable as input of mode review |
url |
Link to the review page on douban.com |
subjectId |
Subject ID of the film or series |
avatarUrl |
Avatar URL of the reviewer |
The input that produced this run
Mode reviews. Parameters as sent, with what each one does.
| Parameter | Value | What it does |
|---|---|---|
mode | "reviews" | What to scrape: the recent-hot list, the short comments of subjects, the details of subjects, the full text of reviews, or the review list of subjects (title, rating and excerpt). |
subjects | ["1291546"] | Only for modes comments, subject and reviews: Douban links (https://movie.douban.com/subject//) or subject IDs of films and series (not review IDs). |
maxResults | 10 | Maximum number of items to return in total for this run. You are charged per item returned. |
14 fields in every reviewSummary
From the first record of the run above. Identity fields of ordinary users are masked on this site.
| Field | Type | Example |
|---|---|---|
type | str | reviewSummary |
reviewId | str | 17894034 |
subjectId | str | 1291546 |
url | str | https://movie.douban.com/review/17894034/ |
title | str | 霸王别姬 |
userName | str | <masked> |
avatarUrl | str | <masked> |
ratingText | str | 力荐 |
stars | int | 5 |
excerpt | str | “都是四人帮的错” “是。。。是啊” “现在好了” “嗯。。。好了,好了吧” 这不单单是一部作品,更是一段历史的写... |
time | str | 2026-11-09 00:27:29 |
upvoteCount | int | 1 |
downvoteCount | int | 0 |
replyCount | int | 0 |
A real run, 14 fields per record
Run on 2026-11-09 with input {"mode": "reviews", "subjects": ["1291546"], "maxResults": 10}. Personal fields of ordinary users are masked here.
| title | ratingText | stars | excerpt | time | upvoteCount |
|---|---|---|---|---|---|
| 霸王别姬 | 力荐 | 5 | “都是四人帮的错” “是。。。是啊” “现在好了” “嗯。。。好了,好了吧” 这不单单是一部作品,更是一段历史的写... | 2026-11-09 00:27:29 | 1 |
| 霸王别姬 | None | None | 《霸王别姬》影评 《霸王别姬》讲了程蝶衣和段小楼几十年的故事,戏里是霸王与虞姬,戏外是起起落落的人生。 程蝶衣把自... | 2026-11-09 00:19:38 | 0 |
| 霸王别姬 | None | None | 李碧华名作《霸王别姬》,我没看过原著,只看了电影。之前东鳞西爪地听人讲过这故事,略有了解。又在电视里瞥到几眼片段。... | 2026-11-07 20:41:07 | 0 |
| 台上虞姬,人间蝶衣 | None | None | 《霸王别姬》不愧是华语电影的巅峰之作。程蝶衣自小入戏,执念于“从一而终”,把自己活成了戏里的虞姬;而段小楼明白戏是... | 2026-11-07 20:06:24 | 0 |
| 霸王别姬 | None | None | 《霸王别姬》是一曲时代悲歌,程蝶衣人戏不分,一生困在“虞姬”的角色之中。半个世纪的风云变幻,戏台上的唱念做打,戏台... | 2026-11-07 19:49:57 | 0 |
| 洪流里的人,唱不完的别姬 | 力荐 | 5 | [霸王别姬] 《霸王别姬》最容易被看成一出两个人的戏:一个是真虞姬,一个是假霸王。可再看一遍,台上那出戏只是引子,... | 2026-11-06 21:38:03 | 0 |
All 14 fields in one record
typereviewSummaryreviewId17894034subjectId1291546urlhttps://movie.douban.com/review/17894034/title霸王别姬userNameavatarUrlratingText力荐stars5excerpt“都是四人帮的错” “是。。。是啊” “现在好了” “嗯。。。好了,好了吧” 这不单单是一部作品,更是一段历史的写...time2026-11-09 00:27:29upvoteCount1downvoteCount0replyCount0
What one reviewSummary costs
Run start · Once per run, charged when the first request succeeds, even if that request returns nothing. In comments and reviews modes each subject after the first adds one more start fee, because it needs its own requests; that fee is charged before the subject's first request and is kept even if that subject then fails or returns nothing · $0.023
Run this request yourself
The same input as above, three ways.