Just One API Docs

简体中文

English

简体中文

English

Appearance

豆瓣 API - 近期热门电影 (V1) ​

prod-global
GET
/api/douban/get-recent-hot-movie/v1

检索平台上当前热门的电影。

典型用例：

  • 发现近期流行的电影。
  • 跟踪当前电影趋势，用于内容分析或推荐。

请求参数 ​

参数名位置类型必填说明
tokenquerystring是此 API 服务的访问令牌。
pagequeryinteger否用于分页的页码。

代码示例 ​

💡 环境说明

默认示例使用 https://api.justoneapi.com (prod-global)。中国大陆地区建议替换为 http://47.117.133.51:30015 (prod-cn) 以获得更好的访问体验。详见 环境选择。

bash
# 提示: 中国大陆地区建议将 https://api.justoneapi.com 替换为 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
我想使用 Just One API 提供的“近期热门电影 (V1)”接口。
接口地址: https://api.justoneapi.com/api/douban/get-recent-hot-movie/v1
HTTP 方法: GET
身份验证: 在 URL 后添加查询参数“?token=您的API密钥”。
OpenAPI 定义: https://docs.justoneapi.com/openapi/douban-apis/recent-hot-movie-v1-zh.json

请求参数说明:
- token (query): 此 API 服务的访问令牌。 (必填)
- page (query): 用于分页的页码。

返回格式: JSON

响应处理与错误码：
1. 需通过返回体中的 "code" 字段判断业务结果（code 为 0 表示成功）。
2. 超时建议：建议将请求超时时间设置为至少 60 秒。
3. 业务码说明：
   - 0: 成功
   - 100: Token 无效或已失效
   - 301: 采集失败，请重试
   - 302: 超出速率限制
   - 303: 超出每日配额
   - 400: 参数错误
   - 500: 内部服务器错误
   - 600: 权限不足
   - 601: 余额不足

请帮我用我擅长的编程语言写一个脚本来调用这个接口，并处理返回结果。
python
# 提示: 中国大陆地区建议将 https://api.justoneapi.com 替换为 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
// 提示: 中国大陆地区建议将 https://api.justoneapi.com 替换为 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
// 提示: 中国大陆地区建议将 https://api.justoneapi.com 替换为 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
// 提示: 中国大陆地区建议将 https://api.justoneapi.com 替换为 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
// 提示: 中国大陆地区建议将 https://api.justoneapi.com 替换为 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;

响应结果 ​

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": "全部"
  }
}

💡 提示：为简化展示，列表类数据样例仅保留 1-2 条记录，实际返回条数以接口响应为准。