获取视频、剧集管理全部数据
通过API接口直接获取视频管理、剧集管理的全部数据，包括M3U8等相关链接。
提示：接口可能会偶尔进行优化，如发现一些参数不生效，需更新到最新版使用。
获取视频列表和剧集列表的数据
#后面为转码设置的apikey，该接口会获取视频管理和剧集管理全部数据
Get /api/videolist?apikey=5c20cEga22FgG7f
#支持参数
page, search, time, category, type, status, published, limit, id
基础参数（可独立使用）
type：数据类型，只能传入tv和movie值
- movie：只输出视频管理的数据
- tv：只输出剧集管理的数据
- 不传则输出视频管理和剧集管理全部数据
page：页数，默认为第1页
limit：每页显示多少个数据，默认20
search：搜索关键词
- 不传type时：同时搜索视频管理的标题(originalname)和剧集管理的标题(title)
- type=movie时：仅搜索视频管理标题
- type=tv时：仅搜索剧集管理标题
category：分类提取
- 不传type时：同时提取视频管理和剧集管理的指定分类
- type=movie时：仅提取视频管理的分类
- type=tv时：仅提取剧集管理的分类
高级参数（必须结合type参数一起使用）
status：视频状态，仅限type=movie时使用
- 可传入：waiting、error、finished、intv
- 不传则默认提取所有数据
published：剧集状态，仅限type=tv时使用
- 可传入：published、waiting
- 不传则默认提取所有数据
time：提取最近多少小时的数据
- 填入数值即可，单位：小时
- 必须配合type使用
id：视频id或剧集id
- 传入视频管理的视频id时：输出该视频所有信息
- 传入剧集管理的剧集id时：输出视频管理中该剧集的所有单集视频
- 必须配合type使用
status详解
由于视频状态过多，这里会把部分状态合并到一个里面进行查询：
waiting：输出等待转码和待审核的视频
- 返回信息status字段为：waiting、审核
error：输出所有转码出错的视频
- 返回信息status字段为：秒切失败、错误：存在相同文件夹、应用重启中断、转码错误、error & failed、生成多音轨视频时出错！
finished：输出转码完成和已发布视频
- 返回信息status字段为：finished、转码完成
intv：输出转码完成并添加进剧集的视频
- 返回信息status字段为：intv
published详解
waiting：输出等待发布的剧集
- 返回信息published字段为：waiting
published：输出已经发布的剧集
- 返回信息published字段为：published
参数组合使用规则
✅ 允许的参数组合
1. 不传type（跨类型查询）
可使用参数：search、category、page、limit
示例：
/api/videolist?apikey=5c20cEga22FgG7f&search=教育
/api/videolist?apikey=5c20cEga22FgG7f&category=教育视频
/api/videolist?apikey=5c20cEga22FgG7f&search=数学&category=教育视频
2. type=movie（仅视频管理）
可使用参数：status、search、category、time、id，可任意组合
示例：
/api/videolist?apikey=5c20cEga22FgG7f&type=movie&status=finished
/api/videolist?apikey=5c20cEga22FgG7f&type=movie&status=finished&category=教育视频
/api/videolist?apikey=5c20cEga22FgG7f&type=movie&search=数学&category=教育视频&time=24
/api/videolist?apikey=5c20cEga22FgG7f&type=movie&id=视频ID
3. type=tv（仅剧集管理）
可使用参数：published、search、category、time、id，可任意组合
示例：
/api/videolist?apikey=5c20cEga22FgG7f&type=tv&published=published
/api/videolist?apikey=5c20cEga22FgG7f&type=tv&published=waiting&category=连续剧
/api/videolist?apikey=5c20cEga22FgG7f&type=tv&search=破冰&published=published&time=48
/api/videolist?apikey=5c20cEga22FgG7f&type=tv&id=剧集ID
❌ 不允许的参数组合
- type=movie + published（movie不支持published参数）
- type=tv + status（tv不支持status参数）
- 不传type + status（status必须配合type=movie使用）
- 不传type + published（published必须配合type=tv使用）
- 不传type + time（time必须配合type使用）
- 不传type + id（id必须配合type使用）
完整使用示例
# 示例1：获取所有数据（视频+剧集）
/api/videolist?apikey=5c20cEga22FgG7f
# 示例2：跨类型搜索"教育"关键词
/api/videolist?apikey=5c20cEga22FgG7f&search=教育
# 示例3：跨类型获取"教育视频"分类的所有内容
/api/videolist?apikey=5c20cEga22FgG7f&category=教育视频
# 示例4：跨类型搜索+分类提取
/api/videolist?apikey=5c20cEga22FgG7f&search=数学&category=教育视频
# 示例5：获取已完成的视频，教育分类，第2页
/api/videolist?apikey=5c20cEga22FgG7f&type=movie&status=finished&category=教育视频&page=2
# 示例6：获取已发布的剧集，最近24小时
/api/videolist?apikey=5c20cEga22FgG7f&type=tv&published=published&time=24
# 示例7：搜索包含"破冰"的已发布剧集
/api/videolist?apikey=5c20cEga22FgG7f&type=tv&search=破冰&published=published
# 示例8：获取指定剧集的所有单集
/api/videolist?apikey=5c20cEga22FgG7f&type=tv&id=剧集ID
# 示例9：获取指定视频的详细信息
/api/videolist?apikey=5c20cEga22FgG7f&type=movie&id=视频ID
# 示例10：每页显示50条数据
/api/videolist?apikey=5c20cEga22FgG7f&limit=50&page=1
# 示例11：获取转码错误的视频，最近12小时
/api/videolist?apikey=5c20cEga22FgG7f&type=movie&status=error&time=12
# 示例12：获取等待发布的剧集，连续剧分类
/api/videolist?apikey=5c20cEga22FgG7f&type=tv&published=waiting&category=连续剧
返回数据说明
- 每条数据包含datatype字段，用于区分数据类型：
· movie：电影视频
· singleEpisode：单集视频
· tv：剧集
- 不传type时的计数规则：
· movieCount：包含电影和单集的总数
· singleEpisodeCount：使用search或category时为0（已合并到movieCount）
· tvCount：剧集总数
- 所有结果按updateAt时间倒序排列（最新更新的在前）
视频管理返回信息示例
{
"code": 1,
"msg": "数据列表",
"page": 1,
"pagecount": 1,
"limit": 20,
"total": 2,
"movieCount": 1,
"singleEpisodeCount": 1,
"tvCount": 0,
"list": [
{
"_id": "6927dc33b57d659e211c7bca",
"director": [
"宫崎骏"
],
"writer": [
"宫崎骏"
],
"stars": [
"胡立成",
"彭昱畅",
"神木隆之介",
"入野自由",
"井柏然",
"夏木真理"
],
"country": [
"日本"
],
"tags": [
"剧情",
"动画",
"奇幻"
],
"screenshots": [
"/videos/202511/27/6927dc33b57d659e211c7bca/1.webp",
"/videos/202511/27/6927dc33b57d659e211c7bca/0.webp"
],
"status": "转码完成",
"originalname": "千与千寻",
"size": "68338293",
"m3u8paths": [
{
"_id": "6927dcf0142fdea1e55091ac",
"hd": 20000,
"path": "./public/videos/202511/27/6927dc33b57d659e211c7bca/20000/index.m3u8"
}
],
"updateAt": "2025-11-27T05:10:41.740Z",
"createAt": "2025-11-27T05:10:41.698Z",
"aka": "神隐少女(台) / 千与千寻的神隐 / Spirited Away / A Voyage of Chihiro / Sen to Chihiro no kamikakushi",
"banben": "HD",
"duration": "2分钟",
"enOriginalName": "",
"enSummary": "",
"language": "日语",
"originaltitle": "千と千尋の神隠し",
"poster": "/videos/202511/27/6927dc33b57d659e211c7bca/cover.jpg",
"poster2": {
"url": "/videos/202511/27/6927dc33b57d659e211c7bca/poster2.jpg",
"height": 867,
"width": 600
},
"rate": 9.4,
"summary": "千寻和爸爸妈妈一同驱车前往新家，在郊外的小路上不慎进入了神秘的隧道——他们去到了另外一个诡异世界—一个中世纪的小镇。远处飘来食物的香味，爸爸妈妈大快朵颐，孰料之后变成了猪！这时小镇上渐渐来了许多样子古...",
"tcOriginalName": "",
"tcSummary": "",
"year": 2001,
"moviepath": "/videos/202511/27/6927dc33b57d659e211c7bca",
"time": "00:02:11",
"previewvideo": "/videos/202511/27/6927dc33b57d659e211c7bca/preview.mp4",
"category": "日本动漫",
"totv": null,
"trym3u8": "/try/6927dc33b57d659e211c7bca.m3u8",
"datatype": "movie"
},
{
"_id": "6927dc33b57d659e211c7b58",
"director": [],
"writer": [],
"stars": [],
"country": [],
"tags": [],
"screenshots": [
"/videos/202511/27/6927dc33b57d659e211c7b58/1.webp",
"/videos/202511/27/6927dc33b57d659e211c7b58/0.webp"
],
"status": "intv",
"originalname": "七龙珠 01",
"size": "2479735",
"m3u8paths": [
{
"_id": "6927dc9a142fdea1e5508e31",
"hd": 20000,
"path": "./public/videos/202511/27/6927dc33b57d659e211c7b58/20000/index.m3u8"
}
],
"updateAt": "2025-11-27T05:09:03.898Z",
"createAt": "2025-11-27T05:07:38.905Z",
"moviepath": "/videos/202511/27/6927dc33b57d659e211c7b58",
"duration": "0分钟",
"time": "00:00:16",
"previewvideo": "/videos/202511/27/6927dc33b57d659e211c7b58/preview.mp4",
"poster": "/videos/202511/27/6927dc33b57d659e211c7b58/cover.webp",
"poster2": {
"url": "/videos/202511/27/6927dc33b57d659e211c7b58/poster2.webp",
"width": 600,
"height": 338
},
"totv": "6927dc25b57d659e211c7a8a",
"category": "日本动漫",
"trym3u8": "/try/6927dc33b57d659e211c7b58.m3u8",
"datatype": "singleEpisode"
}
],
"categoryStats": [
{
"categoryName": "All Videos",
"stats": {
"total": 2,
"waiting": 0,
"error": 0,
"finished": 1,
"intv": 1
}
},
{
"categoryName": "日本动漫",
"stats": {
"total": 2,
"waiting": 0,
"error": 0,
"finished": 1,
"intv": 1
}
},
{
"categoryName": "其它动漫",
"stats": {
"total": 0,
"waiting": 0,
"error": 0,
"finished": 0,
"intv": 0
}
}
]
}
剧集管理返回信息示例
{
"code": 1,
"msg": "数据列表",
"page": 1,
"pagecount": 1,
"limit": 20,
"total": 1,
"list": [
{
"_id": "6927dc25b57d659e211c7a8a",
"director": [
"冯友薇"
],
"writer": [
"鸟山明",
"冯友薇"
],
"stars": [
"柴田秀胜",
"野泽雅子",
"岛本须美",
"银河万丈",
"古川登志夫",
"千叶繁"
],
"country": [
"日本"
],
"tags": [
"喜剧",
"动画",
"奇幻",
"冒险"
],
"published": "waiting",
"title": "七龙珠",
"enTitle": "",
"tcTitle": "",
"originaltitle": "ドラゴンボール",
"aka": "龙珠 / Dragonball",
"year": 1986,
"duration": "25分钟",
"episodescount": "153",
"language": "日语",
"rate": 9.3,
"summary": "很久很久以前，曾流传着这样一个传说：世界各地散落着七颗龙珠，只要集齐这些珠子，就可召唤出神龙，而神龙可以帮助你实现任何一个愿望。住在深山中的小悟空本领高强，偶然的机会他随时尚少女布尔玛走出大山，四处...",
"enSummary": "",
"tcSummary": "",
"status": "lianzai",
"zhouqi": "",
"episodes": [
{
"_id": "6927dde2142fdea1e5509909",
"episode": "01",
"movieid": "6927dc33b57d659e211c7b58"
},
{
"_id": "6927dde2142fdea1e550990a",
"episode": "02",
"movieid": "6927ddc9142fdea1e550965c"
}
],
"updateAt": "2025-11-27T05:13:06.637Z",
"createAt": "2025-11-27T05:13:06.637Z",
"poster": "/poster/6927dc25b57d659e211c7a8a/poster.webp",
"poster2": {
"url": "/poster/6927dc25b57d659e211c7a8a/poster2.webp",
"height": 810,
"width": 540
},
"category": "日本动漫",
"datatype": "tv"
}
],
"categoryStats": [
{
"categoryName": "All Series",
"stats": {
"total": 1,
"published": 0,
"waiting": 1
}
},
{
"categoryName": "日本动漫",
"stats": {
"total": 1,
"published": 0,
"waiting": 1
}
},
{
"categoryName": "其它动漫",
"stats": {
"total": 0,
"published": 0,
"waiting": 0
}
}
]
}
注意m3u8paths里边的hd参数，320为240P、480为360P、640为480P、1138为640P、1280为720P、1920为1080P、2560为2K、20000为原画，path参数为M3U8路径，需自行移除./public后，拼接下域名就可以使用了。
关于剧集说明
剧集数据只会返回该剧集详情信息和所有单集的视频id，不会返回其M3U8链接，且episodes数组为集数信息，movieid为对应的视频id，然后可以通过以下方法获取单集的M3U8链接，如下：
1、获取单集的自适应M3U8链接，拼接格式：/movie/auto/ + 视频id + .m3u8
/movie/auto/679f0dd2ce4be83f7186d431.m3u8
2、获取某剧集里所有单集的视频详情信息，包括截图、分辨率M3U8链接等，id为该剧集id。
剧集里面的所有集数的详情信息获取接口：/api/videolist?apikey=5c20cEga22FgG7f&type=tv&id=681983c5a0934b5dad7b0ae7，获取后再通过对应的视频id入库
#接口返回信息如下：
{
"code": 1,
"msg": "数据列表",
"page": 1,
"pagecount": 1,
"limit": 20,
"total": 1,
"movieCount": 0,
"singleEpisodeCount": 1,
"tvCount": 1,
"tvDetail": {
"_id": "6927dc25b57d659e211c7a8a",
"count": 0,
"director": [
"冯友薇"
],
"writer": [
"鸟山明",
"冯友薇"
],
"stars": [
"柴田秀胜",
"野泽雅子",
"岛本须美",
"银河万丈",
"古川登志夫",
"千叶繁"
],
"syncMarks": [],
"country": [
"日本"
],
"tags": [
"喜剧",
"动画",
"奇幻",
"冒险"
],
"published": "waiting",
"title": "七龙珠",
"enTitle": "",
"tcTitle": "",
"originaltitle": "ドラゴンボール",
"aka": "龙珠 / Dragonball",
"year": 1986,
"duration": "25分钟",
"episodescount": "153",
"language": "日语",
"rate": 9.3,
"summary": "很久很久以前，曾流传着这样一个传说：世界各地散落着七颗龙珠，只要集齐这些珠子，就可召唤出神龙，而神龙可以帮助你实现任何一个愿望。住在深山中的小悟空本领高强，偶然的机会他随时尚少女布尔玛走出大山，四处...",
"enSummary": "",
"tcSummary": "",
"status": "lianzai",
"zhouqi": "",
"episodes": [
{
"_id": "6927dde2142fdea1e5509909",
"episode": "01",
"movieid": "6927dc33b57d659e211c7b58"
}
],
"updateAt": "2025-11-27T05:13:06.637Z",
"createAt": "2025-11-27T05:13:06.637Z",
"__v": 0,
"poster": "/poster/6927dc25b57d659e211c7a8a/poster.webp",
"poster2": {
"url": "/poster/6927dc25b57d659e211c7a8a/poster2.webp",
"height": 810,
"width": 540
},
"category": "日本动漫",
"datatype": "tv"
},
"list": [
{
"_id": "6927dc33b57d659e211c7b58",
"director": [],
"writer": [],
"stars": [],
"country": [],
"tags": [],
"screenshots": [
"/videos/202511/27/6927dc33b57d659e211c7b58/1.webp",
"/videos/202511/27/6927dc33b57d659e211c7b58/0.webp"
],
"status": "intv",
"originalname": "七龙珠 01",
"size": "2479735",
"m3u8paths": [
{
"_id": "6927dc9a142fdea1e5508e31",
"hd": 20000,
"path": "./public/videos/202511/27/6927dc33b57d659e211c7b58/20000/index.m3u8"
}
],
"updateAt": "2025-11-27T05:09:03.898Z",
"createAt": "2025-11-27T05:07:38.905Z",
"moviepath": "/videos/202511/27/6927dc33b57d659e211c7b58",
"duration": "0分钟",
"time": "00:00:16",
"previewvideo": "/videos/202511/27/6927dc33b57d659e211c7b58/preview.mp4",
"poster": "/videos/202511/27/6927dc33b57d659e211c7b58/cover.webp",
"poster2": {
"url": "/videos/202511/27/6927dc33b57d659e211c7b58/poster2.webp",
"width": 600,
"height": 338
},
"totv": "6927dc25b57d659e211c7a8a",
"category": "日本动漫",
"trym3u8": "/try/6927dc33b57d659e211c7b58.m3u8",
"datatype": "singleEpisode"
}
],
"categoryStats": []
}
自适应M3U8和分辨率M3U8都可以用，图方便就用自适应M3U8，有其他需求就用分辨率M3U8，不了解自适应M3U8的可参考 ⇒ 传送门。