Douban API
Scrape Douban (豆瓣), the Chinese site often called China's IMDb: recent hot movie and TV lists with scores, short comments with ratings and likes, full subject details (cast, genres, release dates, IMDb ID) and full review text. No login or cookies needed. Export to JSON, CSV or Excel.
Douban API in one table
| Official public API for people outside China | No. This tool collects the publicly visible data instead. |
|---|---|
| What you send | A keyword, a link or an ID, depending on the request type |
| What you get back | JSON rows with English field names; 5 request types |
| Login, cookies, Chinese phone number | None needed |
| Output formats | JSON, CSV, Excel, or the Apify API |
| Price | $0.0046 per result on the Bronze tier, no subscription |
| Last verified with a real run | 2026-11-09 |
5 kinds of Douban request
Douban (豆瓣) is a Chinese website where people rate, comment on and review films, TV series, books and music. Its movie section, movie.douban.com, is often described as China's IMDb: every film or series has a score out of 10, short comments and long reviews written by users. This Actor covers the movie and TV part of Douban. It is an independent tool and is not affiliated with Douban.
A real run, 13 fields per record
Run on 2026-10-26 with input {"mode": "hot", "maxResults": 10}. Personal fields of ordinary users are masked here.
| title | rank | rating | ratingCount | kind | summary |
|---|---|---|---|---|---|
| 偷天父子兵 | 1 | 5.7 | 494 | movie | 2026 / 法国 意大利 / 喜剧 动作 惊悚 犯罪 / 托马斯·文森特 / 斯坦利·图齐 维克多·贝尔蒙多 |
| 火柴盒大电影 | 2 | 6.1 | 2435 | movie | 2026 / 美国 / 动作 冒险 / 山姆·哈格雷夫 / 约翰·塞纳 杰西卡·贝尔 |
All 13 fields in one record
typetitlekindmovierank1subjectId37660136urlhttps://movie.douban.com/subject/37660136/title偷天父子兵rating5.7ratingCount494summary2026 / 法国 意大利 / 喜剧 动作 惊悚 犯罪 / 托马斯·文森特 / 斯坦利·图齐 维克多·贝尔蒙多episodesInfoisNewposterUrlhttps://img9.doubanio.com/view/photo/s_ratio_poster/publi...posterLargeUrlhttps://img9.doubanio.com/view/photo/m_ratio_poster/publi...
Call the Douban API
Every run is one HTTP call: send the input as JSON, get the rows back. The same works from Make, Zapier or n8n.
Pay per result
Bronze tier prices from the tool's listing; higher Apify tiers pay less. Free Apify users get two trial runs with their own input.
Full price table and worked examples
The Actor uses pay-per-event pricing. You pay only for the events below, in USD:
| Event | When it is charged | Price |
|---|---|---|
| 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 |
| Result | Each hot title, short comment or review list item | $0.0046 |
| Subject | Each subject detail record | $0.025 |
| Review full text | Each review full text | $0.0276 |
Worked examples:
- 100 comments on one film cost $0.023 + 100 × $0.0046 = $0.483.
- 50 hot TV series cost $0.023 + 50 × $0.0046 = $0.253.
- 60 reviews in the list of one film cost $0.023 + 60 × $0.0046 = $0.299.
- Details for 10 subjects cost $0.023 + 10 × $0.025 = $0.273.
- Full text of 5 reviews cost $0.023 + 5 × $0.0276 = $0.161.
The run-start fee is charged when the first request succeeds, even if that request returns nothing. It is not charged when the run fails from the start or rejects the IDs, or when your spending limit cannot cover it. You are never charged for items that were not delivered, and you never pay for more than maxResults items. The run also stops by itself if your spending limit is reached.
On the free Apify plan you get 2 free trial runs of this Actor with your own input, up to 10 results each, and nothing is charged; after that, runs return a stored sample dataset (a real result of the prefilled input). Use any paid Apify plan for full runs.
Douban API questions
Do I need a Douban account, cookies or an API key?
No. You do not need a Douban account, API keys, proxies or cookies. You only need an Apify account to run the Actor.
Is it legal to scrape Douban?
The Actor returns only public data: what anyone sees on a Douban page, such as scores, comment text, display names and avatars. It returns no account data and no private data such as phone numbers or private messages. You are responsible for how you use the data and for following the laws and rules that apply to you.
How fresh is the data?
The data is collected when you run the Actor, so it reflects what Douban shows at that moment. The hot lists follow Douban's "latest" selection. Schedule runs if you want to track changes over time.
Why are some fields empty?
Douban does not show every field for every item. `time` is empty on comments, `location` is empty on many comments, episode fields are empty for films, and `writers`, `languages` or `aliases` can be empty for less known titles. See Tips and limits for the full list.
How many results can I get?
Up to 5,000 items per run, set with `maxResults`. The hot movie list holds about 500 titles and the TV list about 250.
Does it cover books or music?
No. This Actor covers Douban movies and TV series: the hot lists, short comments, subject details and long reviews.