牛牛资源网（别名：牛牛资源、牛牛采集接口）在公开档案中被归入综合型影视采集接口，资源覆盖电影、电视剧、动漫、综艺、小说、体育等类别，输出以m3u8切片为主。本词条围绕其接口地址格式、参数含义、配置要点与常见问题做档案式整理，并附选型注意事项；文中接口地址一律为格式示例，不代表真实可请求地址。
基本信息
| 词条名 | 牛牛资源网 |
|---|---|
| 别名变体 | 牛牛资源、牛牛采集接口 |
| 接口类型 | 通用VOD采集接口（公开档案支持程序标注为"其他程序"） |
| 数据格式 | 通用VOD接口输出，常见JSON结构，字段细节以资源方文档为准 |
| 常见资源形态 | m3u8切片 |
| 适用CMS | 苹果CMS V10等支持通用接口规范的程序均可接入 |
| 更新频率评价 | 以热播剧集跟进为主要节奏，实际更新量以采集观察为准 |
| 资源清晰度评价 | 官方宣传强调高画质，实际清晰度混合，建议抽样播放核验后再全量入库 |
接口地址格式
接入牛牛资源网时，建议从参数最小集开始验证：先用ac=list请求一页列表，确认返回的影片字段完整；再用ac=detail配合ids取单条详情，核对播放地址与简介是否符合预期；确认无误后再引入h参数做增量窗口、t参数做分类过滤。接口基础路径形态为 http://你的域名/api.php/provide/vod/，以下示例仅演示请求写法，实际接入以资源方提供的地址为准。
http://你的域名/api.php/provide/vod/?ac=listhttp://你的域名/api.php/provide/vod/?ac=detail&ids=1http://你的域名/api.php/provide/vod/?h=24参数表
| 参数名 | 含义 | 示例值 |
|---|---|---|
| ac | 动作类型，list与detail分别对应列表和详情 | ac=list |
| pg | 分页页码，控制拉取列表的第几页 | pg=1 |
| h | 时间范围筛选，单位为小时，用于增量采集 | h=12 |
| t | 分类编号，限定返回某一分类的数据 | t=2 |
| wd | 关键词搜索，按片名在接口内检索 | wd=剧集 |
| ids | 影片编号，可一次传多个，用英文逗号分隔 | ids=8,15 |
| at | 输出格式，取xml时切换为XML返回 | at=xml |
配置要点
- 小批量试采先行：首轮只采一个分类的一两页数据，检查标题、封面、简介、播放地址四个关键字段是否正常，再决定是否放开全量采集。
- 去重判断：同一剧集可能在不同分类下重复出现，入库时结合影片编号与标题做去重，避免库内产生重复条目。
- 播放器绑定：m3u8切片资源需绑定对应播放器；前台播放异常时，按苹果CMS播放器问题排查手册：黑屏、卡顿、不自动连播中的思路逐项排查。
- 定时任务错峰：把增量采集安排在低峰时段执行，h参数窗口与任务间隔相匹配，避免窗口重叠导致同一批数据被重复拉取。
- 保留配置备份：采集规则与分类映射完成后导出备份，站点迁移或程序重装时可以快速恢复原有采集链路。
常见问题
为什么首轮全量采集速度偏慢？
库内数据量、服务器带宽与接口响应速度共同决定采集耗时。可以把全量任务按分类拆成多轮执行，优先采集热度较高的分类，其余分类交给定时任务逐步补齐，避免单轮任务过重导致超时。
同一部剧出现两条记录，如何避免？
多因不同批次或不同分类重复采集所致。在采集设置中开启按标题或按编号去重，新增采集来源时注意与既有来源的内容覆盖范围错开，减少重复入库的概率。
简介字段混入排版代码，要不要处理？
部分接口返回的简介带有原始排版标记，入库前可开启内容过滤或用批量替换清理；若不影响前台展示可暂缓处理，但建议统一风格，保证详情页阅读体验一致。
相关词条
当前实链
以下接口地址经本站实测校验（2026-10-03），可直接复制到 CMS 后台资源库配置中使用。
接口地址（XML 数据格式）：
https://api.niuniuzy.me/api.php/provide/vod/from/nnm3u8/at/xml实测状态：接口正常返回且数据结构完整。采集类站点接口域名可能随时间调整，若地址失效请以资源站公告为准。