全球影视剧多语言数据库API系统/World Movie Database Multi-language API System

🎬 获取影视详情

根据豆瓣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）：搜索词在电影别名中出现

示例：

搜索 "英雄" 可以匹配：英雄本色、英雄、我的英雄学院
搜索 "周润发" 可以匹配：周润发主演的所有电影
搜索 "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": 707,
  "page": 2,
  "limit": 10,
  "skip": 10,
  "count": 10,
  "totalPages": 71,
  "hasMore": true,
  "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	当前页实际返回的记录数
totalPages	number	总页数（total ÷ limit 向上取整）
hasMore	boolean	是否还有下一页（skip + limit < total）
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：英文）

完整数据结构示例

{
  // ===== 分页信息（仅搜索接口） =====
  "total": 707,              // 总共707条记录
  "page": 2,                 // 当前第2页
  "limit": 10,               // 每页10条
  "skip": 10,                // 跳过10条（第1页）
  "count": 10,               // 当前页返回10条
  "totalPages": 71,          // 总共71页
  "hasMore": true,           // 还有下一页
  
  // ===== 电影数据 =====
  "data": [{
    // 基础信息
    "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"}]}
    ]
  }]
}

全球影视剧多语言数据库API系统

提供豆瓣、IMDB、烂番茄等多平台影视数据聚合查询

🎬 获取影视详情

请求参数

关于 forceupdate 参数

请求示例

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

示例 2：强制刷新数据

响应示例

🔍 搜索接口

请求参数

模糊搜索说明

请求示例

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

示例 2：按主演模糊搜索

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

示例 4：分页查询

响应示例

📊 响应字段说明

顶层字段（仅搜索接口）

电影基础信息

评分信息

多语言数据（data 数组）

人员信息（writer / actor / director）

完整数据结构示例