采集站教程 2026-08-22 · 10分钟

采集站VOD数据字段深度解析：JSON接口字段含义与自定义映射配置


采集站VOD数据字段深度解析



采集站通过JSON接口返回的VOD（Video On Demand）数据包含大量字段，理解这些字段的含义对于影视站开发和数据映射至关重要。本文将深度解析VOD数据结构，帮助你更好地对接采集站接口。

VOD数据结构概览



一个典型的采集站JSON接口返回数据包含以下层级：

```json
{
"code": 1,
"msg": "数据列表",
"page": 1,
"pagecount": 100,
"limit": "20",
"total": 2000,
"list": [VOD对象数组]
}
```

其中 `list` 数组中的每个VOD对象包含一部影视资源的完整信息。

核心字段详解



#### 基础信息字段

| 字段名 | 类型 | 说明 | 示例值 |
|--------|------|------|--------|
| vod_id | int | 资源唯一ID | 12345 |
| vod_name | string | 影片名称 | "流浪地球3" |
| type_id | int | 分类ID | 1 |
| type_name | string | 分类名称 | "科幻片" |
| vod_pic | string | 封面图片URL | "https://..." |
| vod_remarks | string | 备注/集数 | "HD国语" |
| vod_year | string | 上映年份 | "2026" |
| vod_area | string | 地区 | "中国大陆" |
| vod_lang | string | 语言 | "国语" |
| vod_actor | string | 演员 | "吴京,刘德华" |
| vod_director | string | 导演 | "郭帆" |
| vod_content | string | 简介 | "..." |

#### 播放信息字段

| 字段名 | 类型 | 说明 | 重要性 |
|--------|------|------|--------|
| vod_play_from | string | 播放器标识 | ⭐⭐⭐⭐⭐ |
| vod_play_server | string | 解析服务地址 | ⭐⭐⭐⭐ |
| vod_play_note | string | 播放备注 | ⭐⭐⭐ |
| vod_play_url | string | 播放地址列表 | ⭐⭐⭐⭐⭐ |

vod_play_url 是最核心的字段，格式为：
```
第1集$https://example.com/playlist.m3u8#第2集$https://example.com/playlist2.m3u8
```
多个播放源用 `$$$` 分隔，每集用 `#` 分隔，集数和地址用 `$` 分隔。

#### 评分与状态字段

| 字段名 | 类型 | 说明 | 用途 |
|--------|------|------|------|
| vod_score | float | 评分 | 展示评分星级 |
| vod_score_all | int | 总评分人数 | 评分可信度 |
| vod_hits | int | 总点击量 | 热度排序 |
| vod_hits_day | int | 日点击量 | 实时热度 |
| vod_hits_week | int | 周点击量 | 周榜排序 |
| vod_hits_month | int | 月点击量 | 月榜排序 |
| vod_up | int | 顶数 | 互动功能 |
| vod_isend | int | 是否完结 | 0=连载 1=完结 |

#### 时间字段

| 字段名 | 说明 | 格式 |
|--------|------|------|
| vod_addtime | 添加时间 | Unix时间戳 |
| vod_time | 更新时间 | Unix时间戳 |
| vod_refurbish | 刷新时间 | Unix时间戳 |
| vod_pubdate | 发布日期 | YYYY-mm-dd |
| vod_releasedate | 上映日期 | YYYY-mm-dd |

自定义字段映射



不同采集站的字段名可能略有差异，苹果CMS支持自定义字段映射：

  • 进入后台 → 采集 → 自定义资源库

  • 编辑采集站配置 → 字段映射

  • 将采集站字段映射到CMS标准字段


    • 常见映射配置：
    ```
    vod_name ← title // 部分采集站用title代替vod_name
    vod_pic ← cover // 封面字段名差异
    vod_play_url ← play_url // 播放地址字段名差异
    vod_remarks ← state // 备注字段名差异
    ```

    数据清洗与处理



    采集到VOD数据后，建议进行以下清洗处理：

  • 空值过滤：移除 vod_name 或 vod_play_url 为空的记录

  • 去重处理：按 vod_name + vod_year 去重，避免重复影片

  • 图片本地化：将 vod_pic 下载到本地，避免图片外链失效

  • 简介清洗：去除 vod_content 中的HTML标签和广告信息

  • 分类标准化：将 type_name 映射到你站点的标准分类


    • 多源数据合并



    当同时对接多个采集站时，需要处理多源数据合并：

  • 主键选择：以 vod_name + vod_year 作为唯一标识

  • 冲突解决：优先保留主采集站的数据，补充采集站填充缺失字段

  • 播放源合并：将多个采集站的播放地址合并为多个播放线路

  • 评分聚合：多个来源的评分取加权平均


    • 总结



    深入理解采集站VOD数据字段是影视站开发的基础。通过合理的字段映射和数据清洗，可以确保采集到的影视资源数据完整、准确、规范。资源组(ziyuanzu.com)收录了77+个资源站，每个采集站的接口格式和字段说明都有详细文档，帮助你快速完成数据对接。


    ---

    > 本文由 资源组(ziyuanzu.com) 原创整理发布，转载请注明出处。资源组持续收录和评测各类优质影视资源站与采集站，为影视站长提供最专业的资源站导航、采集站评测与视频源监控服务。
    ← 返回知识库