電影

電影聚合服務:提供影視的分類、列表、詳情、選集與播放地址(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 累計調用 509 次

分類列表

獲取可用分類(主分類 / 子分類 / 專題)。

  • 用於搭建站點導航:main 為主分類,sub 為連續劇的子分類,返回的 id 都可直接傳給「列表」接口的 type_id。
GET /api/movies/movie_555/filters 累計調用 20981 次

篩選條件

獲取某分類可用的篩選條件:子分類、地區、題材、語言、年份、排序。

必填:分類 ID(見「分類列表」接口),如 1=電影 2=連續劇。

  • 返回 data.sub_types(子分類,value 回傳給 type_id)與 data.groups。
  • data.groups 含地區 / 題材 / 語言 / 年份 / 排序五組,value 回傳給「列表」接口的同名參數。
  • 各分類的可用值不同(例如動漫有「日本 / 歐美」,綜藝有「真人秀 / 脫口秀」),年份還會隨站點上新自動增加,建議由本接口動態渲染篩選欄,不要在客戶端寫死。
GET /api/movies/movie_555/home 累計調用 252 次

首頁聚合

獲取首頁聚合數據:輪播圖與各推薦區塊(本周/本月最佳、各榜單等)。

  • 一次返回首頁全部推薦區塊,便於直接渲染站點首頁。
GET /api/movies/movie_555/list 累計調用 112266 次

分類列表

按分類獲取影片列表,支持分頁、排序與年份 / 地區 / 題材 / 語言組合篩選。

必填:分類 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 累計調用 479944 次

影片詳情

獲取影片詳情:簡介、導演/演員等元數據、播放源與選集列表。

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

  • 返回 data.sources(播放源),每個源含 episodes(選集),選集裡的 sid/nid 用於「播放地址」接口。
  • 影片不存在時返回 40001。
GET /api/movies/movie_555/play 累計調用 1625131 次

播放地址

獲取指定播放源/集數的 m3u8 播放地址。

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

必填:集數序號,取自選集 episodes[].nid(電影通常為 1)。

  • 返回 data.m3u8 為可播放地址;該地址帶時效,已做較短緩存(默認 30 分鐘)。
  • 源站地址直出,不做代理轉發。
  • sid / nid 越界或源站無有效地址時返回 40001。
  • 頁面下方提供在線播放器:請求成功後自動加載播放,也可粘貼任意 m3u8 地址測試。
在線播放測試 hls.js / mp4 發送上方請求成功後自動加載播放;也可直接粘貼任意播放地址(m3u8 / mp4)測試。
小影API · 通用 API 聚合服務