Douban Subject details API
Subject details from Douban, returned as JSON rows you can save to CSV.
Douban movie and TV subject details (mode subject, type: "subject")
| Field | Description |
|---|---|
title |
Title of the film or series |
year |
Release year |
rating |
Douban score out of 10 |
ratingCount |
Number of ratings on Douban |
genres |
List of genres |
directors |
List of directors |
writers |
List of writers |
cast |
Main cast in billing order (Douban cuts long lists) |
regions |
Countries or regions |
languages |
Languages |
releaseDates |
Release dates with the festival or region in brackets |
duration |
Running time as Douban shows it, e.g. 142分钟 |
durationMinutes |
Running time in minutes |
episodes |
Number of episodes; empty for films |
aliases |
Other titles |
imdbId |
IMDb ID |
posterUrl |
Poster image URL |
subjectId |
Douban subject ID |
url |
Link to the subject page on douban.com |
The input that produced this run
Mode subject. Parameters as sent, with what each one does.
| Parameter | Value | What it does |
|---|---|---|
mode | "subject" | 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 | 1 | Maximum number of items to return in total for this run. You are charged per item returned. |
20 fields in every subject
From the first record of the run above. Identity fields of ordinary users are masked on this site.
| Field | Type | Example |
|---|---|---|
type | str | subject |
subjectId | str | 1291546 |
url | str | https://movie.douban.com/subject/1291546/ |
title | str | 霸王别姬 |
year | int | 1993 |
rating | float | 9.6 |
ratingCount | int | 2464664 |
genres | list | ["剧情", "爱情", "同性"] |
directors | list | ["陈凯歌"] |
writers | list | ["芦苇", "李碧华"] |
cast | list | ["张国荣", "张丰毅", "巩俐", "葛优", "英达", "蒋雯丽", "吴大维", "吕齐", "雷汉", " |
regions | list | ["中国大陆", "中国香港"] |
languages | list | ["汉语普通话"] |
releaseDates | list | ["1993-07-26(中国大陆)", "1993-01-01(中国香港)"] |
episodes | null | null |
duration | str | 171分钟/ 155分钟(美国剧场版) |
durationMinutes | int | 171 |
aliases | list | ["再见,我的妾", "Farewell My Concubine", "Adieu Ma Concubine"] |
imdbId | str | tt0106332 |
posterUrl | str | <masked> |
A real run, 20 fields per record
Run on 2026-11-09 with input {"mode": "subject", "subjects": ["1291546"], "maxResults": 1}. Personal fields of ordinary users are masked here.
| title | rating | ratingCount | year | duration | durationMinutes |
|---|---|---|---|---|---|
| 霸王别姬 | 9.6 | 2464664 | 1993 | 171分钟/ 155分钟(美国剧场版) | 171 |
All 20 fields in one record
typesubjectsubjectId1291546urlhttps://movie.douban.com/subject/1291546/title霸王别姬year1993rating9.6ratingCount2464664genresdirectorswriterscastregionslanguagesreleaseDatesepisodesduration171分钟/ 155分钟(美国剧场版)durationMinutes171aliasesimdbIdtt0106332posterUrl
Good to know before you run it
- Request sizes: a hot list, comment or review list request returns 20 items; subject details and review texts are one item per request.
What one subject 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.