Douban Movie Movie Reviews API (V1)
API health status
Healthy Available Limited Mostly unavailable No data
Loading health status...
Get Douban movie Reviews data, including review titles, ratings, and snippets, for audience sentiment analysis and review research.
Parameters
| Name | In | Type | Required | Default | Description |
|---|---|---|---|---|---|
token | query | string | Yes | - | Access token for this API service. |
subjectId | query | string | Yes | - | The unique ID for a movie or TV subject on Douban. |
sort | query | string | No | time | Sort order for the result set. Available Values: - time: Time- hotest: Hotest |
page | query | integer | No | 1 | Page number for pagination. |
Code Samples
bash
curl -X GET "https://api.justoneapi.com/api/douban/get-movie-reviews/v1?token=YOUR_API_KEY&subjectId=VALUE"text
I want to use the "Movie Reviews (V1)" API from Just One API.
API Endpoint: https://api.justoneapi.com/api/douban/get-movie-reviews/v1
HTTP Method: GET
Authentication: Append "?token=YOUR_API_KEY" to the URL.
OpenAPI Definition: https://docs.justoneapi.com/openapi/douban-movie/movie-reviews-v1-en.json
Parameters:
- token (query): Access token for this API service. (Required)
- subjectId (query): The unique ID for a movie or TV subject on Douban. (Required)
- sort (query): Sort order for the result set.
Available Values:
- `time`: Time
- `hotest`: Hotest
- page (query): Page number for pagination.
Return format: JSON
Response Handling & Error Codes:
1. Business results should be determined by the "code" field in the response body (code 0 means success).
2. Timeout Recommendation: Set request timeout to at least 60 seconds.
3. Business Code Reference:
- 0: Success
- 100: Invalid or Inactive Token
- 301: Collection Failed. Please Retry.
- 302: Rate Limit Exceeded
- 303: Daily Quota Exceeded
- 400: Invalid Parameters
- 500: Internal Server Error
- 600: Permission Denied
- 601: Insufficient Balance
Please help me write a script in my preferred programming language to call this API and handle the response.python
import requests
url = "https://api.justoneapi.com/api/douban/get-movie-reviews/v1?token=YOUR_API_KEY&subjectId=VALUE"
response = requests.get(url)
print(response.json())js
const response = await fetch("https://api.justoneapi.com/api/douban/get-movie-reviews/v1?token=YOUR_API_KEY&subjectId=VALUE", {
method: "GET"
});
const data = await response.json();
console.log(data);java
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
public class Main {
public static void main(String[] args) throws Exception {
HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://api.justoneapi.com/api/douban/get-movie-reviews/v1?token=YOUR_API_KEY&subjectId=VALUE"))
.method("GET", HttpRequest.BodyPublishers.noBody())
.build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
}
}go
package main
import (
"fmt"
"io"
"net/http"
)
func main() {
client := &http.Client{}
url := "https://api.justoneapi.com/api/douban/get-movie-reviews/v1?token=YOUR_API_KEY&subjectId=VALUE"
req, _ := http.NewRequest("GET", url, nil)
resp, _ := client.Do(req)
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))
}php
<?php
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://api.justoneapi.com/api/douban/get-movie-reviews/v1?token=YOUR_API_KEY&subjectId=VALUE");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "GET");
$response = curl_exec($ch);
curl_close($ch);
echo $response;Responses
json
{
"code": 0,
"data": {
"reviews": [
{
"cid": "17496552",
"review_url": "https://movie.douban.com/review/17496552/",
"avatar": "https://img2.doubanio.com/icon/u260939059-1.jpg",
"username": "信平雀",
"time": "2026-03-09 20:46:23",
"title": "之前看完随手写的",
"rating": "力荐",
"description": "已经二刷《镖人》，这两天陆陆续续翻了很多评论，有人觉得它是近十五年来最好的武侠电影，有人觉得它太大爹男凝，有人觉得剧情伏脉千里，有人说打得很爽但没有剧情。在市场不断细分的当下，传统武侠渐渐变成了一个冷门分支。有一批观众错过了武侠的最好的那段时光，几乎不曾真...",
"upvote_count": 0,
"downvote_count": 0,
"reply_count": 0
},
{
"cid": "17496444",
"review_url": "https://movie.douban.com/review/17496444/",
"avatar": "https://img3.doubanio.com/icon/u209961051-2.jpg",
"username": "Robin",
"time": "2026-03-09 19:36:49",
"title": "江湖在，江湖人在天涯",
"rating": "",
"description": "看过金庸、古龙小说的人，勉强能看温瑞安的四大名捕，只是铁手之后再无铁花，看过霍元甲、黄飞鸿电影的人，现在却只能看东拼西凑的射雕，还不如去看东成西就的东邪西毒。现在流行短剧、短视频，恨不得一分钟解释百年孤独，而且颓败个人主义盛行，人不犯我我不犯人，人若犯我我...",
"upvote_count": 1,
"downvote_count": 0,
"reply_count": 0
},
{
"cid": "17496398",
"review_url": "https://movie.douban.com/review/17496398/",
"avatar": "https://img3.doubanio.com/icon/u260864552-2.jpg",
"username": "崔桑",
"time": "2026-03-09 18:53:34",
"title": "真的是人类拍的电影吗？",
"rating": "很差",
"description": "如果你是武打迷，特喜欢老港片的武打氛围，不追求剧情、人物等，那这部片子一定有五分，一直打打打，ab故事不应该串着来吗…为什么那么突兀的加一个“游戏时间”。电影中途才打完，所有人开始包饺子，包完饺子继续打，没有人觉得很突兀吗？！ 孙艺洲的角色，妖娆女孩的角色不突...",
"upvote_count": 0,
"downvote_count": 0,
"reply_count": 0
},
{
"cid": "17496318",
"review_url": "https://movie.douban.com/review/17496318/",
"avatar": "https://img3.doubanio.com/icon/u277241837-3.jpg",
"username": "一颗大蛋",
"time": "2026-03-09 17:38:54",
"title": "看完《镖人》，才发现我是大沙暴",
"rating": "很差",
"description": "《镖人 风起大漠》纯纯就是今年院线里最臭不可闻的一坨工业垃圾，连给正经烂片提鞋都不配，也别说我看不惯武打片，它这武打不仅拍得烂到发臭，还全是侮辱观众智商的bug，打戏里的龙套小兵跟被点了定身穴的死人一样，自家老大都被人捅穿了还搁那杵着当背景板，连个动一下的意思...",
"upvote_count": 0,
"downvote_count": 0,
"reply_count": 0
},
{
"cid": "17496300",
"review_url": "https://movie.douban.com/review/17496300/",
"avatar": "https://img2.doubanio.com/icon/u283290214-1.jpg",
"username": "豆友VmlkxmZqI4",
"time": "2026-03-09 17:28:30",
"title": "值得一瞥",
"rating": "",
"description": "看了漫画来的，电影和漫画相辅相成，没有漫画的补充，故事也许会有些单薄，让人摸不着头脑。 看了漫画，电影中的人物更加鲜活起来了。孙艺洲的知世郎有大义，不是小丑，刀马爱小七，爱妹妹，不惜判出左晓骑卫（剧中也有细节体现），阿育娅是大漠的女王（大沙暴，哈哈） 那场雪...",
"upvote_count": 0,
"downvote_count": 0,
"reply_count": 0
},
{
"cid": "17496204",
"review_url": "https://movie.douban.com/review/17496204/",
"avatar": "https://img1.doubanio.com/icon/u1171420-8.jpg",
"username": "秋意浓",
"time": "2026-03-09 16:21:06",
"title": "期待第二部",
"rating": "力荐",
"description": "这篇影评可能有剧透（有少量剧透） 给本片打五颗星，四颗星是因为片中的人物都有其可（you）爱（zhi）之处，虽然都不明白对方的底细，是来干什么的，但走着走着就形成了一个小团体，还是有团魂的那种。所以，很愿意看着这么几个人物接下来去长安的路上会遭遇什么，又会有什么好笑的事情发生。这种...",
"upvote_count": 1,
"downvote_count": 0,
"reply_count": 0
},
{
"cid": "17496005",
"review_url": "https://movie.douban.com/review/17496005/",
"avatar": "https://img3.doubanio.com/icon/u278085399-2.jpg",
"username": "顿号✔",
"time": "2026-03-09 13:44:10",
"title": "一眼便被燕子娘惊艳",
"rating": "",
"description": "打戏很精彩,我很喜欢燕子娘,虽然身处乱世之中,她沉着冷静,察言观色,江湖纵然是更多的身不由己,但是燕子娘有一双透彻清澈的眼睛,也有一颗透彻的心,,即使被镣铐铐住了双手与双脚,她亦能行走自如,她看似无时无刻不想逃离这是非之地,却被这趟江湖的义气侠气所吸引,即使到了获得自由...",
"upvote_count": 0,
"downvote_count": 0,
"reply_count": 0
},
{
"cid": "17495897",
"review_url": "https://movie.douban.com/review/17495897/",
"avatar": "https://img3.doubanio.com/icon/u281834057-2.jpg",
"username": "momo",
"time": "2026-03-09 12:05:14",
"title": "镖人，中式美学佳作",
"rating": "力荐",
"description": "这篇影评可能有剧透初一看的《镖人》，第一次感受到动作片纯粹的美。刀光剑影，拳下生风，年长的年轻的，每一个演员的精气神和身手都很有说服力，让人相信武侠世界真的存在，就是这么潇洒又凌厉。 不敢说这是中国武侠片动作美学巅峰，但个人观感，不比《卧虎藏龙》和《一代宗师》的动作设计差（艺...",
"upvote_count": 0,
"downvote_count": 0,
"reply_count": 0
},
{
"cid": "17495830",
"review_url": "https://movie.douban.com/review/17495830/",
"avatar": "https://img3.doubanio.com/icon/u147398338-12.jpg",
"username": "决战青蒜之癫",
"time": "2026-03-09 11:26:53",
"title": "个人向对镖人剧情吐槽",
"rating": "推荐",
"description": "这篇影评可能有剧透三星半 本片最大优点打戏不必多说，一搜好评夸的比我专业。畅快的打戏使观影中的感受还不错，但是一想起这个剧情又刺挠的很( 正常来说，这个故事的核心、护送的“镖” 知世郎本身的塑造决定了整个故事的主旨，什么东西是不吝钱财不惜性命也要守护的？ 很遗憾，看完电影啥也不知...",
"upvote_count": 0,
"downvote_count": 0,
"reply_count": 0
},
{
"cid": "17495809",
"review_url": "https://movie.douban.com/review/17495809/",
"avatar": "https://img1.doubanio.com/icon/user_normal.jpg",
"username": "木屐不哭",
"time": "2026-03-09 11:12:51",
"title": "近十年最好的武侠片了",
"rating": "力荐",
"description": "作为看着武侠片长大的80后我，已经很久没有在电影院看到打的这么酣畅淋漓的武侠了！剧情也不错！演员个性鲜明，个别演员台词功底不够！具体是谁已经想不起来了！很遗憾没有看到惠英红的打戏！！说什么老中青！我不怎么认同这个观点，个人觉得只有老中，没有青，青年的没有几个...",
"upvote_count": 1,
"downvote_count": 0,
"reply_count": 0
},
{
"cid": "17495711",
"review_url": "https://movie.douban.com/review/17495711/",
"avatar": "https://img2.doubanio.com/icon/u151746145-1.jpg",
"username": "Bee",
"time": "2026-03-09 09:58:12",
"title": "矮子里拔高个，武侠死没死？",
"rating": "还行",
"description": "这篇影评可能有剧透作为一个资深武侠迷+文字工作者，过年档的《镖人》我一直在纠结到底要不要去看。其实当看到海报和路透的时候，我就有一种这片要砸的预感，目前看来确实赚回本都有点困难。但最终我还是进了电影院，心中抱着的想法是“就算是烂片也要为武侠情怀买单”，并决定再难看都要写一篇观...",
"upvote_count": 1,
"downvote_count": 0,
"reply_count": 0
},
{
"cid": "17495599",
"review_url": "https://movie.douban.com/review/17495599/",
"avatar": "https://img1.doubanio.com/icon/u44102952-8.jpg",
"username": "南羡",
"time": "2026-03-09 07:14:53",
"title": "剪成电视剧评分能拉到8以上吧",
"rating": "推荐",
"description": "中规中矩吧，主要是剧情塞得太满，情绪的铺垫就少了很多，情感这块有点硬伤。你想讲破碎就不能只看破碎，你得铺垫一些美好的东西，再看美好的东西破碎。女主跟父亲老莫之前的过往，父亲为她赤足走遍沙漠这段这么重的回忆，女主居然需要男主提醒才能想起来，让人很跳戏。竖这个...",
"upvote_count": 0,
"downvote_count": 0,
"reply_count": 0
},
{
"cid": "17495435",
"review_url": "https://movie.douban.com/review/17495435/",
"avatar": "https://img3.doubanio.com/icon/u126998195-3.jpg",
"username": "DrChef",
"time": "2026-03-09 00:44:59",
"title": "写意江湖中的快意恩仇是独属于中式的浪漫",
"rating": "还行",
"description": "首先致敬中国武侠电影！这个春节档最让我有兴趣走进电影院看的电影，因为太久没有关注过中式古装武侠电影了，上一部印象深刻的还是绣春刀，也考虑到打戏和古风的震撼画面、摄影色彩需要大屏幕呈现更有感染力。总的来说，是个“爽剧”，确实让人爽到了，后劲十足，但是剧情过于...",
"upvote_count": 1,
"downvote_count": 0,
"reply_count": 0
},
{
"cid": "17495324",
"review_url": "https://movie.douban.com/review/17495324/",
"avatar": "https://img3.doubanio.com/icon/u161780670-2.jpg",
"username": "人間夜嫿",
"time": "2026-03-08 23:52:12",
"title": "优缺点都很明显",
"rating": "还行",
"description": "这篇影评可能有剧透打得很不错啊，作为武侠电影来说，打戏是重中之重，看得很过瘾~ 有几个人物塑造也不错，重利也有仁心的刀马，天真但不屈的阿育娅，同时有父亲和族长形象的莫族长，狡黠泼辣的燕子娘。 不过这里面也有很多不太好的地方。 一个是摊子铺的太开，背景太复杂，人太多，不知道是不是...",
"upvote_count": 0,
"downvote_count": 0,
"reply_count": 0
},
{
"cid": "17495220",
"review_url": "https://movie.douban.com/review/17495220/",
"avatar": "https://img3.doubanio.com/icon/u179129914-3.jpg",
"username": "Roger",
"time": "2026-03-08 23:03:29",
"title": "《镖人》动作戏观后感：打得挺热闹，但“江湖户口”丢了",
"rating": "还行",
"description": "【前言】本篇不聊剧情改编，不谈后期制作，单单仅聊作为动作大片核心的——武侠动作戏份。 作为一名看李连杰、成龙电影长大的90后，我对《镖人》的期待值拉到了满格。宣发时的“硬派武侠”、“动作巨制”字眼让我以为国产动作片终于要回血了。可看完后，内心却有一种华丽的失落...",
"upvote_count": 2,
"downvote_count": 0,
"reply_count": 0
},
{
"cid": "17495208",
"review_url": "https://movie.douban.com/review/17495208/",
"avatar": "https://img2.doubanio.com/icon/u206829215-1.jpg",
"username": "耶喽弗莱瑞的",
"time": "2026-03-08 22:58:07",
"title": "无题",
"rating": "",
"description": "优点是动作场面充足，大漠外景很酷炫，服化道也不错。对于一部偏传统的武侠片来说不能要求更多了。 最大的槽点我觉得不是他们说的原音糟糕台词幼稚，这些只是国产片的通病。而是那个核心线索人物大花脸。你既然是第一号要犯怎么能顶着一副十里开外就能认出来的造型只身前往对立...",
"upvote_count": 1,
"downvote_count": 0,
"reply_count": 0
},
{
"cid": "17495191",
"review_url": "https://movie.douban.com/review/17495191/",
"avatar": "https://img3.doubanio.com/icon/u50655618-2.jpg",
"username": "B_Rabit",
"time": "2026-03-08 22:52:05",
"title": "各种角度都夸不起来",
"rating": "",
"description": "上映前一口气看了原著，倒不是非要和电影贴脸，主要还是想看一下原著到底有多牛逼，看完确实很牛。 看之前做了心理建设，把电影当作一部独立原创电影看，但人物和剧情交待的都不清晰，甚至要不是看过原著，有些角色刚搞明白就下线了。甚至主角也没有很好的塑造。 台词太现代，...",
"upvote_count": 0,
"downvote_count": 0,
"reply_count": 0
},
{
"cid": "17495160",
"review_url": "https://movie.douban.com/review/17495160/",
"avatar": "https://img3.doubanio.com/icon/u45783618-2.jpg",
"username": "霄霄霄霄霄霄",
"time": "2026-03-08 22:40:29",
"title": "大漠藏侠气，侠影唤初心——《镖人：风起大漠》9分",
"rating": "力荐",
"description": "这篇影评可能有剧透评分：9/10（有剧透） 以纯粹武侠风为国产电影注入活力。摒弃玄幻等元素，展现质朴江湖与家国情怀。虽制作波折，但袁和平导演功力出色，武打戏精彩且武器多样。不过，影片也有不足，演员台词功底待提升，剧情节奏把控欠佳，核心人物塑造有偏差。期待它能如《大圣归来》般，唤起...",
"upvote_count": 0,
"downvote_count": 0,
"reply_count": 0
},
{
"cid": "17495151",
"review_url": "https://movie.douban.com/review/17495151/",
"avatar": "https://img2.doubanio.com/icon/u250787737-1.jpg",
"username": "朝上流又王",
"time": "2026-03-08 22:37:59",
"title": "“我就是大沙暴”",
"rating": "较差",
"description": "文戏一坨，人物角色很扁平，剧情和台词像是ai跑出来的，演员的台词也很糟糕，天南海北口音大杂烩，吴京公式化演技，此沙演技约等于零，可能真的是精神病吧，看不懂他在电影里的表演，女主表演浮于表面，刘耀文这个角色删了也不会有任何影响吧……其他不是特别差的就不说了，都...",
"upvote_count": 0,
"downvote_count": 0,
"reply_count": 0
},
{
"cid": "17495132",
"review_url": "https://movie.douban.com/review/17495132/",
"avatar": "https://img9.doubanio.com/icon/u180429274-4.jpg",
"username": "Nicholas",
"time": "2026-03-08 22:30:17",
"title": "命运，侠义，觉醒，自由！",
"rating": "",
"description": "致敬武侠的一部电影，那是我们的青春和梦想！ 命运，侠义，觉醒，自由！ 带上刀，骑上马，想去哪里就去哪， 让我们痛痛快快闹一场 大局之下 天下谁人不是棋子， 极致宠爱 极致愤怒 极致执着 极致力量 极致守护 极致抗争 极致自由 家国情怀，侠之大者， 天下苍生皆过客 风猎猎 ...",
"upvote_count": 0,
"downvote_count": 0,
"reply_count": 0
}
]
}
}💡 Note: For list data, the example shows only 1-2 items for simplicity. The actual count depends on the API response.