Douban Movie Recent Hot Movie API (V1)
API health status
Healthy Available Limited Mostly unavailable No data
Loading health status...
Get Douban recent Hot Movie data, including ratings, posters, and subject metadata, for movie discovery and trend monitoring.
Parameters
| Name | In | Type | Required | Default | Description |
|---|---|---|---|---|---|
token | query | string | Yes | - | Access token for this API service. |
page | query | integer | No | 1 | Page number for pagination. |
Code Samples
bash
curl -X GET "https://api.justoneapi.com/api/douban/get-recent-hot-movie/v1?token=YOUR_API_KEY"text
I want to use the "Recent Hot Movie (V1)" API from Just One API.
API Endpoint: https://api.justoneapi.com/api/douban/get-recent-hot-movie/v1
HTTP Method: GET
Authentication: Append "?token=YOUR_API_KEY" to the URL.
OpenAPI Definition: https://docs.justoneapi.com/openapi/douban-movie/recent-hot-movie-v1-en.json
Parameters:
- token (query): Access token for this API service. (Required)
- 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-recent-hot-movie/v1?token=YOUR_API_KEY"
response = requests.get(url)
print(response.json())js
const response = await fetch("https://api.justoneapi.com/api/douban/get-recent-hot-movie/v1?token=YOUR_API_KEY", {
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-recent-hot-movie/v1?token=YOUR_API_KEY"))
.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-recent-hot-movie/v1?token=YOUR_API_KEY"
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-recent-hot-movie/v1?token=YOUR_API_KEY");
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": {
"category": "最新",
"tags": [
{
"category": "热门",
"selected": false,
"types": [
{
"selected": false,
"type": "全部",
"title": "全部"
},
{
"selected": false,
"type": "华语",
"title": "华语"
},
{
"selected": false,
"type": "欧美",
"title": "欧美"
},
{
"selected": false,
"type": "韩国",
"title": "韩国"
},
{
"selected": false,
"type": "日本",
"title": "日本"
}
],
"title": "热门电影"
},
{
"category": "最新",
"selected": true,
"types": [
{
"selected": true,
"type": "全部",
"title": "全部"
},
{
"selected": false,
"type": "华语",
"title": "华语"
},
{
"selected": false,
"type": "欧美",
"title": "欧美"
},
{
"selected": false,
"type": "韩国",
"title": "韩国"
},
{
"selected": false,
"type": "日本",
"title": "日本"
}
],
"title": "最新电影"
},
{
"category": "豆瓣高分",
"selected": false,
"types": [
{
"selected": false,
"type": "全部",
"title": "全部"
},
{
"selected": false,
"type": "华语",
"title": "华语"
},
{
"selected": false,
"type": "欧美",
"title": "欧美"
},
{
"selected": false,
"type": "韩国",
"title": "韩国"
},
{
"selected": false,
"type": "日本",
"title": "日本"
}
],
"title": "豆瓣高分"
},
{
"category": "冷门佳片",
"selected": false,
"types": [
{
"selected": false,
"type": "全部",
"title": "全部"
},
{
"selected": false,
"type": "华语",
"title": "华语"
},
{
"selected": false,
"type": "欧美",
"title": "欧美"
},
{
"selected": false,
"type": "韩国",
"title": "韩国"
},
{
"selected": false,
"type": "日本",
"title": "日本"
}
],
"title": "冷门佳片"
}
],
"items": [
{
"rating": {
"count": 3063,
"max": 10,
"star_count": 3,
"value": 6.4
},
"title": "侵略机器",
"pic": {
"large": "https://img3.doubanio.com/view/photo/m_ratio_poster/public/p2929615413.jpg",
"normal": "https://img3.doubanio.com/view/photo/s_ratio_poster/public/p2929615413.jpg"
},
"is_new": true,
"uri": "douban://douban.com/movie/35900174",
"episodes_info": "",
"card_subtitle": "2026 / 英国 澳大利亚 新西兰 美国 / 动作 科幻 惊悚 / 帕特里克·休斯 / 约书亚·迪亚兹 阿兰·里奇森",
"type": "movie",
"id": "35900174"
},
{
"rating": {
"count": 285,
"max": 10,
"star_count": 3.5,
"value": 6.8
},
"title": "再见德国坦克",
"pic": {
"large": "https://img1.doubanio.com/view/photo/m_ratio_poster/public/p2909420449.jpg",
"normal": "https://img1.doubanio.com/view/photo/s_ratio_poster/public/p2909420449.jpg"
},
"is_new": true,
"uri": "douban://douban.com/movie/36906550",
"episodes_info": "",
"card_subtitle": "2024 / 德国 / 剧情 喜剧 / 雅尼斯·亚历山大·基弗 / 罗兰·邦茹 梅克·德罗斯特",
"type": "movie",
"id": "36906550"
},
{
"rating": {
"count": 1821,
"max": 10,
"star_count": 3,
"value": 5.5
},
"title": "索命哨",
"pic": {
"large": "https://img1.doubanio.com/view/photo/m_ratio_poster/public/p2925513480.jpg",
"normal": "https://img1.doubanio.com/view/photo/s_ratio_poster/public/p2925513480.jpg"
},
"is_new": true,
"uri": "douban://douban.com/movie/36614680",
"episodes_info": "",
"card_subtitle": "2025 / 加拿大 爱尔兰 / 恐怖 / 科林·哈迪 / 达芙妮·基恩 苏菲·奈丽丝",
"type": "movie",
"id": "36614680"
},
{
"rating": {
"count": 871,
"max": 10,
"star_count": 3.5,
"value": 6.9
},
"title": "孔雀舞曲",
"pic": {
"large": "https://img9.doubanio.com/view/photo/m_ratio_poster/public/p2929694596.jpg",
"normal": "https://img9.doubanio.com/view/photo/s_ratio_poster/public/p2929694596.jpg"
},
"is_new": true,
"uri": "douban://douban.com/movie/26335563",
"episodes_info": "",
"card_subtitle": "2026 / 韩国 / 剧情 / 李忠弼 / 高我星 文相敏",
"type": "movie",
"id": "26335563"
},
{
"rating": {
"count": 3895,
"max": 10,
"star_count": 3,
"value": 5.9
},
"title": "东北恋哥3：冬天里的一把火",
"pic": {
"large": "https://img9.doubanio.com/view/photo/m_ratio_poster/public/p2929800004.jpg",
"normal": "https://img9.doubanio.com/view/photo/s_ratio_poster/public/p2929800004.jpg"
},
"is_new": false,
"uri": "douban://douban.com/movie/37113995",
"episodes_info": "",
"card_subtitle": "2026 / 中国大陆 / 喜剧 爱情 / 秦小珍 / 包贝尔 张梦露",
"type": "movie",
"id": "37113995"
},
{
"rating": {
"count": 724,
"max": 10,
"star_count": 3.5,
"value": 7.3
},
"title": "遇见世界",
"pic": {
"large": "https://img9.doubanio.com/view/photo/m_ratio_poster/public/p2923972376.jpg",
"normal": "https://img9.doubanio.com/view/photo/s_ratio_poster/public/p2923972376.jpg"
},
"is_new": true,
"uri": "douban://douban.com/movie/36689647",
"episodes_info": "",
"card_subtitle": "2025 / 日本 / 剧情 / 松居大悟 / 杉咲花 南琴奈",
"type": "movie",
"id": "36689647"
},
{
"rating": {
"count": 617,
"max": 10,
"star_count": 3.5,
"value": 6.7
},
"title": "这就是我",
"pic": {
"large": "https://img9.doubanio.com/view/photo/m_ratio_poster/public/p2929035956.jpg",
"normal": "https://img9.doubanio.com/view/photo/s_ratio_poster/public/p2929035956.jpg"
},
"is_new": false,
"uri": "douban://douban.com/movie/37806619",
"episodes_info": "",
"card_subtitle": "2026 / 日本 / 剧情 音乐 传记 / 松本优作 / 望月春希 木村多江",
"type": "movie",
"id": "37806619"
},
{
"rating": {
"count": 12754,
"max": 10,
"star_count": 3,
"value": 6
},
"title": "庇护之地",
"pic": {
"large": "https://img1.doubanio.com/view/photo/m_ratio_poster/public/p2929018970.jpg",
"normal": "https://img1.doubanio.com/view/photo/s_ratio_poster/public/p2929018970.jpg"
},
"is_new": false,
"uri": "douban://douban.com/movie/36892468",
"episodes_info": "",
"card_subtitle": "2026 / 英国 美国 加拿大 / 动作 惊悚 / 里克·罗曼·沃夫 / 杰森·斯坦森 博德希·蕾·布里纳希",
"type": "movie",
"id": "36892468"
},
{
"rating": {
"count": 4045,
"max": 10,
"star_count": 3,
"value": 5.8
},
"title": "特工迷阵",
"pic": {
"large": "https://img1.doubanio.com/view/photo/m_ratio_poster/public/p2928835359.jpg",
"normal": "https://img1.doubanio.com/view/photo/s_ratio_poster/public/p2928835359.jpg"
},
"is_new": false,
"uri": "douban://douban.com/movie/37032137",
"episodes_info": "",
"card_subtitle": "2026 / 新西兰 美国 / 喜剧 动作 / 安杰尔·曼纽尔·索托 / 杰森·莫玛 戴夫·巴蒂斯塔",
"type": "movie",
"id": "37032137"
},
{
"rating": {
"count": 488,
"max": 10,
"star_count": 3.5,
"value": 6.5
},
"title": "伪术奇才",
"pic": {
"large": "https://img1.doubanio.com/view/photo/m_ratio_poster/public/p2929251008.jpg",
"normal": "https://img1.doubanio.com/view/photo/s_ratio_poster/public/p2929251008.jpg"
},
"is_new": false,
"uri": "douban://douban.com/movie/37246591",
"episodes_info": "",
"card_subtitle": "2026 / 意大利 / 剧情 历史 / 斯特凡诺·洛维奇 / 彼得洛·卡斯特里图 朱莉娅·米切利尼",
"type": "movie",
"id": "37246591"
},
{
"rating": {
"count": 41359,
"max": 10,
"star_count": 3,
"value": 6
},
"title": "爆水管",
"pic": {
"large": "https://img3.doubanio.com/view/photo/m_ratio_poster/public/p2928838563.jpg",
"normal": "https://img3.doubanio.com/view/photo/s_ratio_poster/public/p2928838563.jpg"
},
"is_new": false,
"uri": "douban://douban.com/movie/37134618",
"episodes_info": "",
"card_subtitle": "2026 / 中国大陆 / 喜剧 犯罪 / 周涤啡 / 彭于晏 艾伦",
"type": "movie",
"id": "37134618"
},
{
"rating": {
"count": 18901,
"max": 10,
"star_count": 4,
"value": 8.3
},
"title": "超时空辉夜姬！",
"pic": {
"large": "https://img9.doubanio.com/view/photo/m_ratio_poster/public/p2928772586.jpg",
"normal": "https://img9.doubanio.com/view/photo/s_ratio_poster/public/p2928772586.jpg"
},
"is_new": false,
"uri": "douban://douban.com/movie/37825206",
"episodes_info": "",
"card_subtitle": "2026 / 日本 / 剧情 科幻 动画 音乐 奇幻 / 山下清悟 / 夏吉优子 永濑安奈",
"type": "movie",
"id": "37825206"
},
{
"rating": {
"count": 77801,
"max": 10,
"star_count": 3.5,
"value": 7.3
},
"title": "极限审判",
"pic": {
"large": "https://img1.doubanio.com/view/photo/m_ratio_poster/public/p2929006010.jpg",
"normal": "https://img1.doubanio.com/view/photo/s_ratio_poster/public/p2929006010.jpg"
},
"is_new": false,
"uri": "douban://douban.com/movie/36749573",
"episodes_info": "",
"card_subtitle": "2026 / 美国 / 动作 科幻 悬疑 / 提莫·贝克曼贝托夫 / 克里斯·帕拉特 丽贝卡·弗格森",
"type": "movie",
"id": "36749573"
},
{
"rating": {
"count": 14032,
"max": 10,
"star_count": 3.5,
"value": 6.6
},
"title": "全信没收",
"pic": {
"large": "https://img9.doubanio.com/view/photo/m_ratio_poster/public/p2925091095.jpg",
"normal": "https://img9.doubanio.com/view/photo/s_ratio_poster/public/p2925091095.jpg"
},
"is_new": false,
"uri": "douban://douban.com/movie/36932394",
"episodes_info": "",
"card_subtitle": "2026 / 美国 / 剧情 动作 悬疑 惊悚 犯罪 / 乔·卡纳汉 / 马特·达蒙 本·阿弗莱克",
"type": "movie",
"id": "36932394"
},
{
"rating": {
"count": 8509,
"max": 10,
"star_count": 3.5,
"value": 6.6
},
"title": "惊变28年2：白骨圣殿",
"pic": {
"large": "https://img3.doubanio.com/view/photo/m_ratio_poster/public/p2927456643.jpg",
"normal": "https://img3.doubanio.com/view/photo/s_ratio_poster/public/p2927456643.jpg"
},
"is_new": false,
"uri": "douban://douban.com/movie/36850893",
"episodes_info": "",
"card_subtitle": "2026 / 英国 美国 加拿大 / 科幻 惊悚 恐怖 / 尼娅·达科斯塔 / 拉尔夫·费因斯 杰克·奥康奈尔",
"type": "movie",
"id": "36850893"
},
{
"rating": {
"count": 8694,
"max": 10,
"star_count": 3,
"value": 6
},
"title": "不过是上班",
"pic": {
"large": "https://img1.doubanio.com/view/photo/m_ratio_poster/public/p2928696109.jpg",
"normal": "https://img1.doubanio.com/view/photo/s_ratio_poster/public/p2928696109.jpg"
},
"is_new": false,
"uri": "douban://douban.com/movie/37193378",
"episodes_info": "",
"card_subtitle": "2026 / 中国大陆 / 喜剧 / 王梓骏 / 吴俊霆 李孝谦",
"type": "movie",
"id": "37193378"
},
{
"rating": {
"count": 2976,
"max": 10,
"star_count": 3.5,
"value": 6.5
},
"title": "盛夏假期遇见爱",
"pic": {
"large": "https://img9.doubanio.com/view/photo/m_ratio_poster/public/p2925091594.jpg",
"normal": "https://img9.doubanio.com/view/photo/s_ratio_poster/public/p2925091594.jpg"
},
"is_new": false,
"uri": "douban://douban.com/movie/36340236",
"episodes_info": "",
"card_subtitle": "2026 / 美国 / 爱情 / 布雷特·海利 / 艾米丽·巴德 汤姆·布莱斯",
"type": "movie",
"id": "36340236"
},
{
"rating": {
"count": 4118,
"max": 10,
"star_count": 3.5,
"value": 6.6
},
"title": "手遮天",
"pic": {
"large": "https://img1.doubanio.com/view/photo/m_ratio_poster/public/p2928726979.jpg",
"normal": "https://img1.doubanio.com/view/photo/s_ratio_poster/public/p2928726979.jpg"
},
"is_new": false,
"uri": "douban://douban.com/movie/37480812",
"episodes_info": "",
"card_subtitle": "2026 / 中国大陆 / 动作 犯罪 古装 / 刘文普 / 刘峰超 袁福福",
"type": "movie",
"id": "37480812"
},
{
"rating": {
"count": 26220,
"max": 10,
"star_count": 3.5,
"value": 6.6
},
"title": "过家家",
"pic": {
"large": "https://img9.doubanio.com/view/photo/m_ratio_poster/public/p2928389426.jpg",
"normal": "https://img9.doubanio.com/view/photo/s_ratio_poster/public/p2928389426.jpg"
},
"is_new": false,
"uri": "douban://douban.com/movie/36790513",
"episodes_info": "",
"card_subtitle": "2026 / 中国大陆 / 剧情 / 李太言 / 成龙 彭昱畅",
"type": "movie",
"id": "36790513"
},
{
"rating": {
"count": 1657,
"max": 10,
"star_count": 3.5,
"value": 7.3
},
"title": "后来的我们",
"pic": {
"large": "https://img9.doubanio.com/view/photo/m_ratio_poster/public/p2927580106.jpg",
"normal": "https://img9.doubanio.com/view/photo/s_ratio_poster/public/p2927580106.jpg"
},
"is_new": true,
"uri": "douban://douban.com/movie/35930441",
"episodes_info": "",
"card_subtitle": "2025 / 韩国 / 剧情 爱情 / 金度英 / 具教焕 文佳煐",
"type": "movie",
"id": "35930441"
}
],
"recommend_tags": [
{
"category": "热门",
"selected": false,
"type": "全部",
"title": "热门"
},
{
"category": "最新",
"selected": true,
"type": "全部",
"title": "最新"
},
{
"category": "豆瓣高分",
"selected": false,
"type": "全部",
"title": "豆瓣高分"
},
{
"category": "冷门佳片",
"selected": false,
"type": "全部",
"title": "冷门佳片"
},
{
"category": "热门",
"selected": false,
"type": "华语",
"title": "华语"
},
{
"category": "热门",
"selected": false,
"type": "欧美",
"title": "欧美"
},
{
"category": "热门",
"selected": false,
"type": "韩国",
"title": "韩国"
},
{
"category": "热门",
"selected": false,
"type": "日本",
"title": "日本"
}
],
"total": 498,
"type": "全部"
}
}💡 Note: For list data, the example shows only 1-2 items for simplicity. The actual count depends on the API response.