🎬 获取影视详情

根据豆瓣ID获取影视作品的详细信息，包括豆瓣、IMDB、烂番茄评分及完整剧情。

GET https://api.wmdb.tv/movie/api

请求参数

参数名 类型 必填 说明 示例
id string 必填 豆瓣电影ID 36318037
forceUpdate boolean 选填 是否强制刷新数据（默认 false） true

关于 forceUpdate 参数

⚠️ 什么时候需要使用 forceUpdate=true？

  • 发现数据不完整或有误时
  • 电影信息发生变更（如海报更换、评分更新）
  • 海报图片损坏或无法显示时

请求示例

示例 1：正常获取（推荐）

GET https://api.wmdb.tv/movie/api?id=36318037

✅ 快速返回缓存数据，适合日常使用

示例 2：强制刷新数据

GET https://api.wmdb.tv/movie/api?id=36318037&forceUpdate=true

⚠️ 重新爬取所有数据，耗时较长，仅在数据有误时使用

响应示例

{
  "originalName": "唐朝诡事录之长安",
  "imdbVotes": 0,
  "imdbRating": "",
  "rottenRating": "",
  "rottenVotes": 0,
  "year": "2024",
  "imdbId": "tt34387186",
  "alias": "长安诡案",
  "doubanId": "36318037",
  "type": "TVSeries",
  "doubanRating": "7.2",
  "doubanVotes": 12458,
  "duration": 2700,
  "episodes": 24,
  "totalSeasons": 1,
  "dateReleased": "2024-12-01",
  "data": [
    {
      "poster": "https://img.wmdb.tv/movie/poster/xxx.jpg",
      "name": "唐朝诡事录之长安",
      "genre": "剧情/悬疑/古装",
      "description": "讲述了唐朝长安城内发生的一系列诡异案件...",
      "language": "汉语普通话",
      "country": "中国大陆",
      "lang": "Cn"
    }
  ],
  "writer": [{"data": [{"name": "王倦", "lang": "Cn"}]}],
  "actor": [
    {"data": [{"name": "杨旭文", "lang": "Cn"}]},
    {"data": [{"name": "杨志刚", "lang": "Cn"}]}
  ],
  "director": [{"data": [{"name": "白云默", "lang": "Cn"}]}]
}

🔍 搜索接口

根据关键词或主演姓名搜索影视作品，支持中英文模糊搜索、分页、年份过滤等功能。

GET https://api.wmdb.tv/api/v1/movie/search

请求参数

参数名 类型 必填 说明 示例
q string 二选一 搜索关键词（片名、原名、别名、简介），支持模糊匹配 英雄本色
actor string 二选一 主演姓名（支持中英文），支持模糊匹配 周润发
limit number 选填 每页返回数量（1-100，默认5） 10
skip number 选填 跳过的记录数（用于分页，默认0） 0
lang string 选填 返回语言（Cn 或 En，默认 Cn） Cn
year number 选填 年份过滤（精确匹配） 2002
⚠️ 注意：q 和 actor 参数至少需要提供一个。

模糊搜索说明

💡 搜索匹配规则（按优先级排序）：

  • 完全匹配（权重 100）：搜索词与片名完全一致
  • 前缀匹配（权重 80）：片名以搜索词开头，如搜"英雄"可匹配"英雄本色"
  • 包含匹配（权重 50）：片名包含搜索词，如搜"本色"可匹配"英雄本色"
  • 别名匹配（权重 20）：搜索词在电影别名中出现
  • 简介匹配（权重 10）：搜索词在电影简介中出现

示例：

  • 搜索 "英雄" 可以匹配：英雄本色、英雄、我的英雄学院
  • 搜索 "周润发" 可以匹配：周润发主演的所有电影
  • 搜索 "hero" 可以匹配：A Better Tomorrow（英雄本色的英文名）

请求示例

示例 1：按关键词模糊搜索

GET https://api.wmdb.tv/api/v1/movie/search?q=英雄&limit=10&lang=Cn

✅ 返回所有包含"英雄"的电影

示例 2：按主演模糊搜索

GET https://api.wmdb.tv/api/v1/movie/search?actor=周润发&limit=10

✅ 返回周润发参演的所有电影

示例 3：组合搜索（主演+关键词+年份）

GET https://api.wmdb.tv/api/v1/movie/search?q=英雄本色&actor=周润发&year=1986

✅ 返回1986年周润发主演的包含"英雄本色"的电影

示例 4：分页查询

第1页：GET https://api.wmdb.tv/api/v1/movie/search?q=英雄&limit=10&skip=0
第2页：GET https://api.wmdb.tv/api/v1/movie/search?q=英雄&limit=10&skip=10
第3页：GET https://api.wmdb.tv/api/v1/movie/search?q=英雄&limit=10&skip=20

响应示例

{
  "total": 1,
  "page": 1,
  "limit": 10,
  "skip": 0,
  "count": 1,
  "data": [
    {
      "originalName": "英雄本色",
      "imdbVotes": 20335,
      "imdbRating": "7.5",
      "rottenRating": "93",
      "rottenVotes": 14,
      "year": "1986",
      "imdbId": "tt0092263",
      "alias": "A Better Tomorrow / Gangland Boss",
      "doubanId": "1297574",
      "type": "Movie",
      "doubanRating": "8.7",
      "doubanVotes": 386762,
      "duration": 5700,
      "episodes": 0,
      "totalSeasons": 0,
      "dateReleased": "1986-08-02",
      "data": [
        {
          "poster": "https://img.wmdb.tv/movie/poster/xxx.jpg",
          "name": "英雄本色",
          "genre": "剧情/动作/犯罪",
          "description": "香港某个国际伪钞集团...",
          "language": "粤语,汉语普通话,英语",
          "country": "中国香港",
          "lang": "Cn"
        }
      ],
      "writer": [{"data": [{"name": "吴宇森", "lang": "Cn"}]}],
      "actor": [
        {"data": [{"name": "周润发", "lang": "Cn"}]},
        {"data": [{"name": "狄龙", "lang": "Cn"}]},
        {"data": [{"name": "张国荣", "lang": "Cn"}]}
      ],
      "director": [{"data": [{"name": "吴宇森", "lang": "Cn"}]}]
    }
  ]
}

📊 响应字段说明

顶层字段（仅搜索接口）

字段名 类型 说明
total number 符合条件的总记录数
page number 当前页码（从1开始）
limit number 每页返回的数量
skip number 跳过的记录数
count number 当前页实际返回的记录数
data array 电影数据数组

电影基础信息

字段名 类型 说明
originalName string 原片名（主要片名）
alias string 别名（多个别名用 / 分隔）
year string 上映年份
type string 类型：Movie（电影）或 TVSeries（电视剧）
duration number 时长（单位：秒）
episodes number 集数（仅电视剧，电影为0）
totalSeasons number 总季数（仅电视剧，电影为0）
dateReleased string 上映日期（格式：YYYY-MM-DD）
doubanId string 豆瓣电影ID
imdbId string IMDB ID（格式：tt开头）

评分信息

字段名 类型 说明
doubanRating string 豆瓣评分（0-10分，如 "8.7"）
doubanVotes number 豆瓣评分人数
imdbRating string IMDB评分（0-10分，如 "7.5"）
imdbVotes number IMDB评分人数
rottenRating string 烂番茄评分（0-100分，如 "93"）
rottenVotes number 烂番茄评分人数

多语言数据（data 数组）

每部电影包含多个语言版本的数据（通常包括中文和英文），每个对象包含以下字段：

字段名 类型 说明
name string 片名（对应语言版本的片名）
poster string 海报图片URL
genre string 类型标签（如：剧情/悬疑/古装，多个用/分隔）
description string 剧情简介（对应语言版本）
language string 影片使用的语言（如：汉语普通话、粤语）
country string 制片国家/地区（多个用逗号分隔）
lang string 当前数据的语言版本（Cn：中文，En：英文）

人员信息（writer / actor / director）

编剧、演员、导演数组，每个对象包含：

字段名 类型 说明
data array 人员的多语言数据数组
data[].name string 人员姓名（对应语言版本）
data[].lang string 姓名语言版本（Cn：中文，En：英文）

数据结构示例

{
  // 基础信息
  "originalName": "英雄本色",
  "alias": "A Better Tomorrow / Gangland Boss",
  "year": "1986",
  "type": "Movie",
  
  // 时长信息
  "duration": 5700,          // 95分钟 = 5700秒
  "episodes": 0,             // 电影无集数
  "totalSeasons": 0,         // 电影无季数
  
  // ID信息
  "doubanId": "1297574",
  "imdbId": "tt0092263",
  
  // 评分信息
  "doubanRating": "8.7",
  "doubanVotes": 386762,
  "imdbRating": "7.5",
  "imdbVotes": 20335,
  "rottenRating": "93",
  "rottenVotes": 14,
  
  // 多语言数据（中文版本）
  "data": [
    {
      "name": "英雄本色",
      "poster": "https://img.wmdb.tv/movie/poster/xxx.jpg",
      "genre": "剧情/动作/犯罪",
      "description": "香港某个国际伪钞集团...",
      "language": "粤语,汉语普通话,英语",
      "country": "中国香港",
      "lang": "Cn"
    }
  ],
  
  // 人员信息
  "director": [
    {"data": [{"name": "吴宇森", "lang": "Cn"}]}
  ],
  "writer": [
    {"data": [{"name": "吴宇森", "lang": "Cn"}]}
  ],
  "actor": [
    {"data": [{"name": "周润发", "lang": "Cn"}]},
    {"data": [{"name": "狄龙", "lang": "Cn"}]},
    {"data": [{"name": "张国荣", "lang": "Cn"}]}
  ]
}