接口咨询 020-3886 5521

电影频道采集接口

电影频道采集接口按年份、地区、语言三个维度切分片库,单条记录带片长、上映年份、豆瓣编号与清晰度标记。接进来以后,站点上的“2024 年国产”“日韩”“修复版”这类筛选项可以直接由字段生成,不用再人工打标签。

街角影院门头上方的招牌与外立面

接口参数

接口版本MacCMS V10 标准,路径 /api/provide/vod/,支持 ac=list 与 ac=detail
输出格式JSON(默认)与 XML 两种,JSON 单页 20 条,XML 单页 20 条,可用 pg 参数翻页
单片库配额标准套餐 12 万条索引,扩容套餐 30 万条,按 detail 请求计次
字段覆盖43 项,含 vod_id、vod_name、vod_year、vod_area、vod_lang、vod_duration、douban_id
兼容性苹果CMS V10、MacCMS 衍生模板、自研 PHP 与 Python 采集器均可读
部署方式公网直连,不要求白名单;需要固定出口 IP 的可开专属入口
数据合规仅输出片名、简介、分类等元数据与播放地址,不托管视频文件
SLA 响应工作日 30 分钟内响应工单,接口可用性按季度出具监测记录
更新间隔新片入库后 15 分钟内可查,修复片源在 4 小时内替换地址

参数按 电影频道采集接口 的交付口径写,实际配额以控制台显示为准。

三个实际使用场合

影视站首页的年份与地区筛选

一个做港片专题的站点,需要把 1980 到 2025 年的片按十年一段分栏。用 vod_year 直接切片,一晚上能生成 5 个专题页;过去靠人工在 Excel 里筛,一个专题要两天。

新片预告位的自动填充

首页“本周上新”区块要求每天换 8 张海报。接口按 vod_time 倒序返回,取前 8 条写进模板,海报地址用的是 16:9 裁切后的封面,不会出现竖版图被拉扁的情况。

修复版片源的单独归档

老片修复版和原版同名,容易混。这类记录在 vod_remarks 里标“修复”,采集时按这个字段分流到独立分类,用户点进修复专区看到的就是 4K 版本。

选型建议

如果你的站点以电影为主,片量在 10 万条以上,优先选这一条而不是综合包。原因很实际:电影的分类维度比剧集多,年份、地区、语言三个字段必须齐全,综合包里这三项经常只填一个。片量低于 3 万条的小站,用综合包更划算,等片库长起来再单开电影口。

客户为什么选这一条,而不是隔壁那家

三条可验证的差异

  • 年份字段不是字符串区间:返回的是四位年份整数,1980 与 1980 年修复版能分开,做时间轴不用再正则清洗。
  • 封面按 16:9 输出:vod_pic 给的是 16:9 地址,另附竖版 original_pic,模板不用两套裁切逻辑。
  • 详情接口支持按 id 批量取:ac=detail&ids=1001,1002 一次最多 50 条,回填历史数据比逐条查快 6 倍左右。

交付周期与售后条款

阶段时间与内容
标准接入1 个工作日开通测试 key,含 500 次试调用
分类映射2 个工作日,交付 type_id 对照表
正式上线第 3 个工作日切正式配额,旧接口可并行 7 天

售后按季度结算,接口地址变更提前 7 天在控制台公告;因我方调整导致的字段缺失,48 小时内补齐或回滚到上一版;采集端自身逻辑问题提供字段级排查,不改对方代码。

这一类里的其他接口

相关现场记录:骨干光缆割接:跨省首帧从3.1秒、核心交换机换新:一台 48 口设。分类与字段口径见综合影视接口,完整字段说明在对接文档。

常被问到的问题

电影接口和综合接口能同时开吗

可以,两条入口共用一份配额,按总调用量计费,不会重复扣。

老片没有豆瓣编号怎么办

douban_id 为空时留空字符串,不留 null,避免部分采集器解析报错。

能按分类只拉某几类吗

能,传 t 参数指定 type_id,多个 id 用逗号分隔,最多 8 个。