电影

电影聚合服务:提供影视的分类、列表、详情、选集与播放地址(m3u8)能力,按「列表 → 详情 → 播放」流程即可搭建完整影视站。

/api/movies/

服务说明

电影服务聚合影视站数据,提供分类、筛选条件、首页推荐、列表、详情、选集与播放地址(m3u8)等完整链路,按「分类 → 列表 → 详情 → 播放地址」的顺序即可搭起一个影视站,搜索接口则支持按片名关键词查片。

关键 ID 有固定的传递顺序:分类接口返回的 id 传给列表接口的 type_id,列表中的 id 传给详情接口的 vod_id,详情中的 sid / nid 再传给播放接口取地址,串起来就是一条完整的播放流程。

数据类信息(片名、简介、集数等)缓存时间较长;播放地址(m3u8)因为带时效只做较短缓存,请勿在客户端长期缓存播放地址。本服务需项目签名。

555电影

555电影(5dy4.vip) 需签名

实时爬取源站并缓存。数据类(片名/详情/集数)缓存较久,播放地址(m3u8)缓存较短以便及时刷新。

GET /api/movies/movie_555/categories 累计调用 497 次

分类列表

获取可用分类(主分类 / 子分类 / 专题)。

  • 用于搭建站点导航:main 为主分类,sub 为连续剧的子分类,返回的 id 都可直接传给「列表」接口的 type_id。
GET /api/movies/movie_555/filters 累计调用 20967 次

筛选条件

获取某分类可用的筛选条件:子分类、地区、题材、语言、年份、排序。

必填:分类 ID(见「分类列表」接口),如 1=电影 2=连续剧。

  • 返回 data.sub_types(子分类,value 回传给 type_id)与 data.groups。
  • data.groups 含地区 / 题材 / 语言 / 年份 / 排序五组,value 回传给「列表」接口的同名参数。
  • 各分类的可用值不同(例如动漫有「日本 / 欧美」,综艺有「真人秀 / 脱口秀」),年份还会随站点上新自动增加,建议由本接口动态渲染筛选栏,不要在客户端写死。
GET /api/movies/movie_555/home 累计调用 249 次

首页聚合

获取首页聚合数据:轮播图与各推荐区块(本周/本月最佳、各榜单等)。

  • 一次返回首页全部推荐区块,便于直接渲染站点首页。
GET /api/movies/movie_555/list 累计调用 110721 次

分类列表

按分类获取影片列表,支持分页、排序与年份 / 地区 / 题材 / 语言组合筛选。

必填:分类 ID,1=电影 2=连续剧 3=综艺纪录 4=动漫 124=福利 126=擦边短剧(子分类见「分类列表」接口的 sub)。

可选:页码,从 1 开始,默认 1。

可选:排序方式 time/hits/score。

可选:按年份筛选,如 2026(取值见「筛选条件」接口的 year 组)。

可选:按地区筛选,如 大陆(取值见「筛选条件」接口的 area 组)。

可选:按题材筛选,如 动作(取值见「筛选条件」接口的 genre 组)。

可选:按语言筛选,如 国语(取值见「筛选条件」接口的 lang 组)。

  • 返回 data.items(影片列表)与 data.pagination(分页信息)。
  • 地区 / 题材 / 语言 / 年份 / 排序可任意组合,源站按交集返回;组合后没有匹配影片时 data.items 为空数组,不会报错。
GET /api/movies/movie_555/detail 累计调用 475047 次

影片详情

获取影片详情:简介、导演/演员等元数据、播放源与选集列表。

必填:影片 ID(取自列表/搜索结果中的 id)。

  • 返回 data.sources(播放源),每个源含 episodes(选集),选集里的 sid/nid 用于「播放地址」接口。
  • 影片不存在时返回 40001。
GET /api/movies/movie_555/play 累计调用 1609372 次

播放地址

获取指定播放源/集数的 m3u8 播放地址。

必填:播放源序号,取自详情接口 sources[].sid。

必填:集数序号,取自选集 episodes[].nid(电影通常为 1)。

  • 返回 data.m3u8 为可播放地址;该地址带时效,已做较短缓存(默认 30 分钟)。
  • 源站地址直出,不做代理转发。
  • sid / nid 越界或源站无有效地址时返回 40001。
  • 页面下方提供在线播放器:请求成功后自动加载播放,也可粘贴任意 m3u8 地址测试。
在线播放测试 hls.js / mp4 发送上方请求成功后自动加载播放;也可直接粘贴任意播放地址(m3u8 / mp4)测试。
小影API · 通用 API 聚合服务