Just One API Docs

简体中文

English

简体中文

English

Appearance

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

prod-global
GET
/api/douban/get-recent-hot-tv/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-tv/v1?token=YOUR_API_KEY"
text
我想使用 Just One API 提供的“近期热门电视剧 (V1)”接口。
接口地址: https://api.justoneapi.com/api/douban/get-recent-hot-tv/v1
HTTP 方法: GET
身份验证: 在 URL 后添加查询参数“?token=您的API密钥”。
OpenAPI 定义: https://docs.justoneapi.com/openapi/douban-apis/recent-hot-tv-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-tv/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-tv/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-tv/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-tv/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-tv/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": "tv",
    "tags": [
      {
        "category": "tv",
        "selected": true,
        "types": [
          {
            "selected": true,
            "type": "tv",
            "title": "综合"
          },
          {
            "selected": false,
            "type": "tv_domestic",
            "title": "国产剧"
          },
          {
            "selected": false,
            "type": "tv_american",
            "title": "欧美剧"
          },
          {
            "selected": false,
            "type": "tv_japanese",
            "title": "日剧"
          },
          {
            "selected": false,
            "type": "tv_korean",
            "title": "韩剧"
          },
          {
            "selected": false,
            "type": "tv_animation",
            "title": "动画"
          },
          {
            "selected": false,
            "type": "tv_documentary",
            "title": "纪录片"
          }
        ],
        "title": "最近热门剧集"
      },
      {
        "category": "show",
        "selected": false,
        "types": [
          {
            "selected": false,
            "type": "show",
            "title": "综合"
          },
          {
            "selected": false,
            "type": "show_domestic",
            "title": "国内"
          },
          {
            "selected": false,
            "type": "show_foreign",
            "title": "国外"
          }
        ],
        "title": "最近热门综艺"
      }
    ],
    "items": [
      {
        "rating": {
          "count": 0,
          "max": 10,
          "star_count": 0,
          "value": 0
        },
        "title": "逐玉",
        "pic": {
          "large": "https://img3.doubanio.com/view/photo/m_ratio_poster/public/p2920718637.jpg",
          "normal": "https://img3.doubanio.com/view/photo/s_ratio_poster/public/p2920718637.jpg"
        },
        "is_new": true,
        "uri": "douban://douban.com/tv/36554061",
        "episodes_info": "更新至11集",
        "card_subtitle": "2026 / 中国大陆 / 剧情 爱情 古装 / 曾庆杰 / 田曦薇 张凌赫",
        "type": "tv",
        "id": "36554061"
      },
      {
        "rating": {
          "count": 36210,
          "max": 10,
          "star_count": 3.5,
          "value": 7.3
        },
        "title": "纯真年代的爱情",
        "pic": {
          "large": "https://img1.doubanio.com/view/photo/m_ratio_poster/public/p2930085518.jpg",
          "normal": "https://img1.doubanio.com/view/photo/s_ratio_poster/public/p2930085518.jpg"
        },
        "is_new": false,
        "uri": "douban://douban.com/tv/35943650",
        "episodes_info": "更新至25集",
        "card_subtitle": "2026 / 中国大陆 / 剧情 爱情 / 陈畅 / 陈飞宇 孙千",
        "type": "tv",
        "id": "35943650"
      },
      {
        "rating": {
          "count": 27676,
          "max": 10,
          "star_count": 3.5,
          "value": 7.4
        },
        "title": "除恶",
        "pic": {
          "large": "https://img1.doubanio.com/view/photo/m_ratio_poster/public/p2930022669.jpg",
          "normal": "https://img1.doubanio.com/view/photo/s_ratio_poster/public/p2930022669.jpg"
        },
        "is_new": false,
        "uri": "douban://douban.com/tv/36566053",
        "episodes_info": "16集全",
        "card_subtitle": "2026 / 中国大陆 / 剧情 悬疑 犯罪 / 滕华涛 / 任素汐 王骁",
        "type": "tv",
        "id": "36566053"
      },
      {
        "rating": {
          "count": 83405,
          "max": 10,
          "star_count": 3.5,
          "value": 7
        },
        "title": "唐宫奇案之青雾风鸣",
        "pic": {
          "large": "https://img1.doubanio.com/view/photo/m_ratio_poster/public/p2929534370.jpg",
          "normal": "https://img1.doubanio.com/view/photo/s_ratio_poster/public/p2929534370.jpg"
        },
        "is_new": false,
        "uri": "douban://douban.com/tv/36415590",
        "episodes_info": "34集全",
        "card_subtitle": "2026 / 中国大陆 / 悬疑 古装 / 尹涛 / 白鹿 王星越",
        "type": "tv",
        "id": "36415590"
      },
      {
        "rating": {
          "count": 121710,
          "max": 10,
          "star_count": 4,
          "value": 8.2
        },
        "title": "太平年",
        "pic": {
          "large": "https://img9.doubanio.com/view/photo/m_ratio_poster/public/p2926587194.jpg",
          "normal": "https://img9.doubanio.com/view/photo/s_ratio_poster/public/p2926587194.jpg"
        },
        "is_new": false,
        "uri": "douban://douban.com/tv/36317421",
        "episodes_info": "48集全",
        "card_subtitle": "2026 / 中国大陆 / 剧情 历史 古装 / 杨磊 陆贝珂 / 白宇 周雨彤",
        "type": "tv",
        "id": "36317421"
      },
      {
        "rating": {
          "count": 3420,
          "max": 10,
          "star_count": 4,
          "value": 7.5
        },
        "title": "订阅男友",
        "pic": {
          "large": "https://img3.doubanio.com/view/photo/m_ratio_poster/public/p2930226213.jpg",
          "normal": "https://img3.doubanio.com/view/photo/s_ratio_poster/public/p2930226213.jpg"
        },
        "is_new": true,
        "uri": "douban://douban.com/tv/37030864",
        "episodes_info": "",
        "card_subtitle": "2026 / 韩国 / 喜剧 爱情 / 金正植 / 金智秀 徐仁国",
        "type": "tv",
        "id": "37030864"
      },
      {
        "rating": {
          "count": 65393,
          "max": 10,
          "star_count": 3.5,
          "value": 7.2
        },
        "title": "成何体统",
        "pic": {
          "large": "https://img9.doubanio.com/view/photo/m_ratio_poster/public/p2929508444.jpg",
          "normal": "https://img9.doubanio.com/view/photo/s_ratio_poster/public/p2929508444.jpg"
        },
        "is_new": false,
        "uri": "douban://douban.com/tv/36514978",
        "episodes_info": "32集全",
        "card_subtitle": "2026 / 中国大陆 / 喜剧 爱情 古装 / 刘海波 王莉 / 王楚然 丞磊",
        "type": "tv",
        "id": "36514978"
      },
      {
        "rating": {
          "count": 298832,
          "max": 10,
          "star_count": 4,
          "value": 8.3
        },
        "title": "生命树",
        "pic": {
          "large": "https://img9.doubanio.com/view/photo/m_ratio_poster/public/p2929427616.jpg",
          "normal": "https://img9.doubanio.com/view/photo/s_ratio_poster/public/p2929427616.jpg"
        },
        "is_new": false,
        "uri": "douban://douban.com/tv/35424715",
        "episodes_info": "40集全",
        "card_subtitle": "2026 / 中国大陆 / 剧情 / 李雪 赵烁 / 杨紫 胡歌",
        "type": "tv",
        "id": "35424715"
      },
      {
        "rating": {
          "count": 0,
          "max": 10,
          "star_count": 0,
          "value": 0
        },
        "title": "我的山与海",
        "pic": {
          "large": "https://img3.doubanio.com/view/photo/m_ratio_poster/public/p2930376513.jpg",
          "normal": "https://img3.doubanio.com/view/photo/s_ratio_poster/public/p2930376513.jpg"
        },
        "is_new": true,
        "uri": "douban://douban.com/tv/35725771",
        "episodes_info": "更新至8集",
        "card_subtitle": "2026 / 中国大陆 新加坡 马来西亚 / 剧情 / 柏杉 / 谭松韵 董晴",
        "type": "tv",
        "id": "35725771"
      },
      {
        "rating": {
          "count": 24627,
          "max": 10,
          "star_count": 3,
          "value": 6.3
        },
        "title": "玫瑰丛生",
        "pic": {
          "large": "https://img3.doubanio.com/view/photo/m_ratio_poster/public/p2930046432.jpg",
          "normal": "https://img3.doubanio.com/view/photo/s_ratio_poster/public/p2930046432.jpg"
        },
        "is_new": false,
        "uri": "douban://douban.com/tv/35653016",
        "episodes_info": "26集全",
        "card_subtitle": "2026 / 中国大陆 / 剧情 爱情 / 杨磊 / 王子文 刘宇宁",
        "type": "tv",
        "id": "35653016"
      },
      {
        "rating": {
          "count": 9943,
          "max": 10,
          "star_count": 3,
          "value": 5.5
        },
        "title": "江湖夜雨十年灯",
        "pic": {
          "large": "https://img3.doubanio.com/view/photo/m_ratio_poster/public/p2914336837.jpg",
          "normal": "https://img3.doubanio.com/view/photo/s_ratio_poster/public/p2914336837.jpg"
        },
        "is_new": false,
        "uri": "douban://douban.com/tv/36449471",
        "episodes_info": "更新至31集",
        "card_subtitle": "2026 / 中国大陆 / 剧情 古装 / 侣皓吉吉 郭锋 / 周翊然 包上恩",
        "type": "tv",
        "id": "36449471"
      },
      {
        "rating": {
          "count": 26228,
          "max": 10,
          "star_count": 4,
          "value": 7.6
        },
        "title": "莎拉的真伪人生",
        "pic": {
          "large": "https://img9.doubanio.com/view/photo/m_ratio_poster/public/p2930147455.jpg",
          "normal": "https://img9.doubanio.com/view/photo/s_ratio_poster/public/p2930147455.jpg"
        },
        "is_new": false,
        "uri": "douban://douban.com/tv/37019235",
        "episodes_info": "",
        "card_subtitle": "2026 / 韩国 / 悬疑 犯罪 / 金镇民 / 申惠善 李浚赫",
        "type": "tv",
        "id": "37019235"
      },
      {
        "rating": {
          "count": 34201,
          "max": 10,
          "star_count": 4.5,
          "value": 8.9
        },
        "title": "七王国的骑士 第一季",
        "pic": {
          "large": "https://img1.doubanio.com/view/photo/m_ratio_poster/public/p2927626110.jpg",
          "normal": "https://img1.doubanio.com/view/photo/s_ratio_poster/public/p2927626110.jpg"
        },
        "is_new": false,
        "uri": "douban://douban.com/tv/35341071",
        "episodes_info": "",
        "card_subtitle": "2026 / 美国 / 剧情 动作 奇幻 冒险 / 欧文·哈里斯 萨拉·阿迪纳·史密斯 / 彼得·克拉菲 德克斯特·索尔·安塞尔",
        "type": "tv",
        "id": "35341071"
      },
      {
        "rating": {
          "count": 8917,
          "max": 10,
          "star_count": 3.5,
          "value": 6.5
        },
        "title": "岁月有情时",
        "pic": {
          "large": "https://img3.doubanio.com/view/photo/m_ratio_poster/public/p2929910712.jpg",
          "normal": "https://img3.doubanio.com/view/photo/s_ratio_poster/public/p2929910712.jpg"
        },
        "is_new": false,
        "uri": "douban://douban.com/tv/36782155",
        "episodes_info": "30集全",
        "card_subtitle": "2026 / 中国大陆 / 剧情 历史 / 黄伟 / 黄景瑜 关晓彤",
        "type": "tv",
        "id": "36782155"
      },
      {
        "rating": {
          "count": 102461,
          "max": 10,
          "star_count": 4,
          "value": 8.4
        },
        "title": "爱情怎么翻译？",
        "pic": {
          "large": "https://img3.doubanio.com/view/photo/m_ratio_poster/public/p2928736672.jpg",
          "normal": "https://img3.doubanio.com/view/photo/s_ratio_poster/public/p2928736672.jpg"
        },
        "is_new": false,
        "uri": "douban://douban.com/tv/36363991",
        "episodes_info": "",
        "card_subtitle": "2026 / 韩国 / 剧情 喜剧 爱情 / 刘英恩 / 金宣虎 高允贞",
        "type": "tv",
        "id": "36363991"
      },
      {
        "rating": {
          "count": 24522,
          "max": 10,
          "star_count": 4,
          "value": 7.5
        },
        "title": "夜色正浓",
        "pic": {
          "large": "https://img2.doubanio.com/view/photo/m_ratio_poster/public/p2929668751.jpg",
          "normal": "https://img2.doubanio.com/view/photo/s_ratio_poster/public/p2929668751.jpg"
        },
        "is_new": false,
        "uri": "douban://douban.com/tv/36722339",
        "episodes_info": "",
        "card_subtitle": "2026 / 中国大陆 / 剧情 / 李骏 荆丽鹏 / 江疏影 佟大为",
        "type": "tv",
        "id": "36722339"
      },
      {
        "rating": {
          "count": 5409,
          "max": 10,
          "star_count": 3.5,
          "value": 6.7
        },
        "title": "美丽毒素",
        "pic": {
          "large": "https://img1.doubanio.com/view/photo/m_ratio_poster/public/p2927650748.jpg",
          "normal": "https://img1.doubanio.com/view/photo/s_ratio_poster/public/p2927650748.jpg"
        },
        "is_new": false,
        "uri": "douban://douban.com/tv/37059654",
        "episodes_info": "",
        "card_subtitle": "2026 / 美国 / 剧情 科幻 悬疑 恐怖 / 瑞恩·墨菲 / 埃文·彼得斯 丽贝卡·豪尔",
        "type": "tv",
        "id": "37059654"
      },
      {
        "rating": {
          "count": 122060,
          "max": 10,
          "star_count": 3.5,
          "value": 7.4
        },
        "title": "骄阳似我",
        "pic": {
          "large": "https://img9.doubanio.com/view/photo/m_ratio_poster/public/p2928224516.jpg",
          "normal": "https://img9.doubanio.com/view/photo/s_ratio_poster/public/p2928224516.jpg"
        },
        "is_new": false,
        "uri": "douban://douban.com/tv/35559998",
        "episodes_info": "",
        "card_subtitle": "2025 / 中国大陆 / 剧情 爱情 / 陈宙飞 / 宋威龙 赵今麦",
        "type": "tv",
        "id": "35559998"
      },
      {
        "rating": {
          "count": 1371,
          "max": 10,
          "star_count": 3.5,
          "value": 6.8
        },
        "title": "青年夏洛克",
        "pic": {
          "large": "https://img3.doubanio.com/view/photo/m_ratio_poster/public/p2929220212.jpg",
          "normal": "https://img3.doubanio.com/view/photo/s_ratio_poster/public/p2929220212.jpg"
        },
        "is_new": true,
        "uri": "douban://douban.com/tv/36881771",
        "episodes_info": "",
        "card_subtitle": "2026 / 英国 / 动作 悬疑 冒险 / 盖·里奇 安德斯·恩斯特朗 翠西亚·布洛克 丹妮·戈登 / 赫洛·费因斯-提芬 多纳尔·芬恩",
        "type": "tv",
        "id": "36881771"
      },
      {
        "rating": {
          "count": 29898,
          "max": 10,
          "star_count": 3.5,
          "value": 6.9
        },
        "title": "年少有为",
        "pic": {
          "large": "https://img9.doubanio.com/view/photo/m_ratio_poster/public/p2926584025.jpg",
          "normal": "https://img9.doubanio.com/view/photo/s_ratio_poster/public/p2926584025.jpg"
        },
        "is_new": false,
        "uri": "douban://douban.com/tv/37060833",
        "episodes_info": "26集全",
        "card_subtitle": "2026 / 中国大陆 / 剧情 喜剧 / 刘闻洋 赵启辰 / 彭昱畅 林允",
        "type": "tv",
        "id": "37060833"
      }
    ],
    "recommend_tags": [
      {
        "category": "tv",
        "selected": true,
        "type": "tv",
        "title": "综合"
      },
      {
        "category": "tv",
        "selected": false,
        "type": "tv_domestic",
        "title": "国产剧"
      },
      {
        "category": "show",
        "selected": false,
        "type": "show",
        "title": "综艺"
      },
      {
        "category": "tv",
        "selected": false,
        "type": "tv_american",
        "title": "欧美剧"
      },
      {
        "category": "tv",
        "selected": false,
        "type": "tv_japanese",
        "title": "日剧"
      },
      {
        "category": "tv",
        "selected": false,
        "type": "tv_korean",
        "title": "韩剧"
      },
      {
        "category": "tv",
        "selected": false,
        "type": "tv_animation",
        "title": "动画"
      },
      {
        "category": "tv",
        "selected": false,
        "type": "tv_documentary",
        "title": "纪录片"
      }
    ],
    "total": 215,
    "type": "tv"
  }
}

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