Unified Movie API

One API for all movie data. Aggregated ratings. Streaming availability. Trailers. Credits.

原始信息汇总

Unified Movie API 数据集概述

基本信息

• API名称：Unified Movie API
• 数据源：聚合了TMDb和OMDb的数据
• 主要功能：提供电影信息、统一评分、流媒体播放数据、预告片及演职人员信息

核心特性

• 统一数据源：整合TMDb和OMDb，无需管理多个API密钥或处理不同响应格式
• 统一评分：在单一响应中提供TMDb、IMDb、Rotten Tomatoes和Metacritic的评分，以及一个0-100的加权平均分
• 实时流媒体数据：提供40多个国家的流媒体（Netflix、Disney+、HBO Max等）、租赁和购买选项
• 视频预告片：提供可直接嵌入的官方预告片和剪辑的YouTube/Vimeo URL
• 清洁的JSON格式：所有端点采用一致的响应结构
• 人员数据：包含演员/导演简介及完整作品列表

端点列表

搜索与发现

• GET /v1/movies/search?query=matrix — 按标题搜索
• GET /v1/movies/discover?genres=28&minRating=70 — 使用筛选器浏览
• GET /v1/movies/trending?timeWindow=day — 当前流行趋势
• GET /v1/movies/popular — 最受欢迎的电影
• GET /v1/movies/top-rated — 评分最高的电影
• GET /v1/movies/upcoming — 即将上映的电影
• GET /v1/movies/now-playing — 正在影院上映的电影

详细信息

• GET /v1/movies/{id} — 完整的电影详情
• GET /v1/movies/{id}/recommendations — 类似电影推荐
• GET /v1/person/{id} — 演员/导演信息

通用参数

• page (整数) — 页码 (1-500)
• region (字符串) — ISO国家代码 (如 US, GB, CA)
• language (字符串) — ISO语言代码 (如 en, es, fr)

发现筛选器

• genres — 流派ID，逗号分隔 (例如 28,12)
• yearFrom — 起始发行年份 (例如 2020)
• yearTo — 结束发行年份 (例如 2024)
• minRating — 最低评分 0-100 (例如 70)
• providers — 提供商ID，逗号分隔 (例如 Netflix=8, Disney+=337)
• sortBy — 排序依据：popularity, releaseDate, rating, title

流派ID映射

• 28 = 动作
• 12 = 冒险
• 16 = 动画
• 35 = 喜剧
• 80 = 犯罪
• 18 = 剧情
• 14 = 奇幻
• 27 = 恐怖
• 10749 = 爱情
• 878 = 科幻
• 53 = 惊悚
• 10752 = 战争
• 37 = 西部
• 99 = 纪录片

提供商ID映射

• 8 = Netflix
• 9 = Prime Video
• 15 = Hulu
• 337 = Disney+
• 350 = Apple TV+
• 384 = HBO Max
• 387 = Peacock
• 531 = Paramount+

响应格式

所有响应均采用包含 success、data 和 meta 字段的一致结构。

成功响应

包含请求的数据和可选的分页信息。

错误响应

包含带有 code、message 和 statusCode 的错误对象。

错误代码

• VALIDATION_ERROR (400) — 参数无效
• NOT_FOUND (404) — 资源未找到
• RATE_LIMITED (429) — 请求过多
• UPSTREAM_ERROR (502) — 源API错误

速率限制

检查响应头以获取速率限制信息：

• X-RateLimit-Limit — 每个周期允许的请求数
• X-RateLimit-Remaining — 剩余请求数
• X-RateLimit-Reset — 重置时间戳

缓存策略

• 电影/人员详情 — 24小时
• 推荐 — 6小时
• 流行、最高评分 — 1-6小时
• 趋势 — 15分钟

使用案例

• 流媒体应用 — 显示任何电影的观看地点
• 电影评论 — 展示来自多个来源的聚合评分
• 推荐系统 — 构建“类似电影”功能
• 娱乐新闻 — 跟踪趋势和即将上映的影片
• 观看列表应用 — 构建个人电影追踪器

支持

如有问题或疑问，请通过RapidAPI消息联系我们。

搜集汇总

背景与挑战

背景概述

该数据集提供统一的电影API接口，整合了电影评分、流媒体平台信息、预告片及演职员表等综合数据服务。