观潮海报网API文档

提供静态图片和GIF图片的查询接口,支持GET/POST请求、分页、搜索和分类筛选等功能。

GET/POST
海报API调用:当前域名/api/api.php/请求参数等

获取图片数据列表,支持多种查询参数。

GET/POST
API调用:当前域名/douban/?url=剧名/动漫名

获取豆瓣热门影视数据

GET 分类API接口:当前域名/douban/db.php?url=分类名称&limit=数量

获取豆瓣热门影视数据,并自动搜索本地海报。

热门分类API

v1.0
功能说明: 该接口会自动调用豆瓣热门影视数据和相关海报返回。

分类列表

热门电影 最新电影 冷门佳片 热门电视剧 热门国产剧 热门欧美剧 热门韩剧 热门日剧 热门动漫 热门综艺 热门纪录片

API参数

参数名 必填 类型 说明 默认值 示例
url string 分类名称 - 热门电影
limit integer 返回数据数量 50 20

调用示例

基本调用

获取热门电影数据(默认50条)

GET /douban/db.php?url=热门电影

带参数调用

获取最新电影,只返回20条数据

GET /douban/db.php?url=最新电影&limit=20

返回格式说明


{
    "success": true,           // 请求总体成功标志,true表示豆瓣API调用成功
    "code": 0,                 // 状态码,0通常表示操作成功,其他数值表示错误
    "data": [                  // 主要数据容器,数组格式,包含多个影视项目
        {
            // ============ 豆瓣API原始数据部分 ============
            "rating": {        // 评分信息对象
                "count": 67293,     // 参与评分的人数总计
                "max": 10,          // 评分系统的最高分值(豆瓣使用10分制)
                "star_count": 3,    // 星级评价数量(3表示3星,对应6分左右)
                "value": 6.2        // 实际平均评分值(范围0-10)
            },
            "title": "枭起青壤",    // 影视作品的完整标题
            "pic": {                // 豆瓣提供的海报图片信息
                "large": "https://img9.doubanio.com/view/photo/m_ratio_poster/public/p2927326974.jpg",  // 大尺寸海报URL,适合详细查看
                "normal": "https://img9.doubanio.com/view/photo/s_ratio_poster/public/p2927326974.jpg"   // 常规尺寸海报URL,适合列表展示
            },
            "is_new": false,        // 新上映/新播出标志,false表示不是最新上映的
            "uri": "douban://douban.com/tv/35489172",  // 豆瓣应用内部使用的深度链接,点击可跳转豆瓣App详情页
            "episodes_info": "32集全", // 剧集总数量信息,"32集全"表示已完结共32集
            "card_subtitle": "2025 / 中国大陆 / 剧情 爱情 悬疑 / 田里 何坦 / 迪丽热巴 陈星旭",  // 卡片副标题,包含:年份/地区/类型/导演/主演
            "type": "tv",           // 作品类型:"tv"表示电视剧,"movie"表示电影
            "id": "35489172",       // 豆瓣系统中的唯一标识符ID
            
            // ============ 海报数据 ============
            "posters": [            // 相关海报数组
                {
                    "id": 33661,     // 海报记录的唯一ID
                    "name": "枭起青壤",  // 海报名称
                    "url": "https://tv.puui.qpic.cn/tv/0/mz_tv_image_frontend_42f1e-14_607841207_1764935996142898_pic_1920x800/0",  // 海报图片的实际访问地址
                    "description": "",  // 海报描述信息
                    "source": "电视剧",  // 海报来源分类
                    "created_at": "2025-12-05 21:30:15"  // 海报创建时间
                },
                {
                    "id": 28349,     // 第二个海报记录的ID
                    "name": "枭起青壤",  // 同一部作品的不同版本海报
                    "url": "https://tv.puui.qpic.cn/tv/0/mz_tv_image_frontend_42f1e-14_97714142_1764149328815941_pic_1920x800/0",  // 不同尺寸或来源的海报
                    "description": "",  // 海报描述信息
                    "source": "电视剧",  // 海报来源分类
                    "created_at": "2025-11-26 18:30:19"  // 海报创建时间
                },
                

注意: 海报返回的数据会额外增加 posters 字段,包含相关海报数据。

海报API请求参数

参数名 必填 类型 说明 默认值 可选值
type string 图片类型 static static(普通图片)/gif(动图)
page integer 页码 1 ≥1的整数
limit integer 每页数量 10 1-100的整数
search string 搜索关键词 任意字符串
sort string 排序方式 created_at DESC created_at ASC/DESC, id ASC/DESC
all boolean 获取所有数据(忽略分页) false true/false
source string 数据来源 source(分类)

调用示例

基本调用

获取静态图片第一页数据(默认10条)

GET /api/api.php

获取所有GIF图片

忽略分页,获取所有GIF图片数据

GET /api/api.php?type=gif&all=true

分类调用

获取"电视剧"分类的静态图片

GET /api/api.php?source=电视剧

搜索调用

搜索名称包含"大梦归离"的静态图片

GET /api/api.php?search=大梦归离

在线测试

海报GET
海报POST
豆瓣分类API

响应结果

请填写参数后点击"发送请求"