观潮海报 · API 文档

海报查询 · 分页 · 搜索 · 分类筛选

GET / POST /api/api.php?参数

海报数据列表 — 支持 type, page, limit, search, sort, source, all 参数

海报 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
source	否	string	分类	空	电视剧 / 电影 / 动漫 …
all	否	boolean	获取全部 (忽略分页)	false	true / false

调用示例

基本

GET /api/api.php

所有 GIF

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

分类

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

搜索

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

返回格式说明

成功响应包含豆瓣原始数据及额外的 posters 海报数组。

响应结构

字段	类型	说明
success	boolean	请求总体成功标志，true表示豆瓣API调用成功
code	integer	状态码，0表示成功，其他数值表示错误
data	array	主要数据容器，包含多个影视项目对象

data 数组中的项目对象

字段	类型	说明
rating	object	评分信息 (count, max, star_count, value)
title	string	影视作品完整标题
pic	object	豆瓣海报图片 (large, normal)
is_new	boolean	是否新上映/新播出
uri	string	豆瓣应用内部深度链接
episodes_info	string	剧集信息，如"32集全"
card_subtitle	string	卡片副标题 (年份/地区/类型/导演/主演)
type	string	作品类型 (tv / movie)
id	string	豆瓣唯一标识ID
posters ⭐	array	海报数据数组 (本接口额外增加字段)

️ posters 数组中的海报对象

字段	类型	说明
id	integer	海报记录唯一ID
name	string	海报名称 (通常与作品标题一致)
url	string	海报图片实际访问地址
description	string	海报描述信息
source	string	海报来源分类 (如"电视剧")
created_at	string	海报创建时间 (YYYY-MM-DD HH:mm:ss)

响应示例 (完整结构)

{
    "success": true,
    "code": 0,
    "data": [
        {
            "rating": {
                "count": 67293,
                "max": 10,
                "star_count": 3,
                "value": 6.2
            },
            "title": "枭起青壤",
            "pic": {
                "large": "https://img9.doubanio.com/view/photo/m_ratio_poster/public/p2927326974.jpg",
                "normal": "https://img9.doubanio.com/view/photo/s_ratio_poster/public/p2927326974.jpg"
            },
            "is_new": false,
            "uri": "douban://douban.com/tv/35489172",
            "episodes_info": "32集全",
            "card_subtitle": "2025 / 中国大陆 / 剧情 爱情 悬疑 / 田里 何坦 / 迪丽热巴 陈星旭",
            "type": "tv",
            "id": "35489172",
            "posters": [
                {
                    "id": 33661,
                    "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,
                    "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 文档

海报 API 请求参数

调用示例

返回格式说明

响应示例 (完整结构)

在线测试