Douban APIs - Recent Hot Movie (V1)
Retrieves the latest hot movies currently trending on the platform.
Typical use cases:
- Discovering recently popular movies.
- Tracking current movie trends for content analysis or recommendation.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
token | query | string | Yes | Access token for this API service. |
page | query | integer | No | Page number for pagination. |
Code Samples
💡 Environment Note
Default samples use https://api.justoneapi.com (prod-global). For users in Mainland China, it is recommended to replace it with http://47.117.133.51:30015 (prod-cn) for better performance. See Environment Guide.
bash
# Tip: For Mainland China, replace https://api.justoneapi.com with http://47.117.133.51:30015
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-apis/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
# Tip: For Mainland China, replace https://api.justoneapi.com with http://47.117.133.51:30015
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
// Tip: For Mainland China, replace https://api.justoneapi.com with http://47.117.133.51:30015
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
// Tip: For Mainland China, replace https://api.justoneapi.com with http://47.117.133.51:30015
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
// Tip: For Mainland China, replace https://api.justoneapi.com with http://47.117.133.51:30015
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
// Tip: For Mainland China, replace https://api.justoneapi.com with http://47.117.133.51:30015
<?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.