# 剧集基本信息
- [剧集基本信息（mdID方式）](#剧集基本信息（mdID方式）)
- [获取剧集明细（web端）（ssID/epID方式）](#获取剧集明细（web端）（ssID/epID方式）)
---
## 剧集基本信息（mdID方式）
> http://api.bilibili.com/pgc/review/user
*请求方式：GET*
鉴权方式：Cookie（SESSDATA）或APP
**url参数：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| -------- | ---- | -------- | ------ | ---- |
| media_id | str | 剧集mdID | 必要 | |
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------- |
| code | num | 返回值 | 0：成功
-400：请求错误
-404：错误 |
| message | str | 错误信息 | 默认为success |
| result | obj | 信息本体 | |
`result`对象：
| 字段 | 类型 | 内容 | 备注 |
| ------ | ---- | ------------ | ---------------- |
| media | obj | 剧集信息 | |
| review | obj | 用户操作信息 | 仅登录时存在此项 |
`result`中的`media`对象：
| 字段 | 类型 | 内容 | 备注 |
| --------- | ----- | -------------- | -------------------------- |
| areas | array | 地区 | |
| cover | str | 封面图片url | |
| media_id | num | 剧集mdID | |
| new_ep | obj | 最新一话信息 | |
| rating | obj | 评分信息 | |
| season_id | int | 剧集ssID | |
| share_url | url | 剧集详情页连接 | |
| title | str | 标题 | |
| type_name | str | 剧集类型 | `番剧`、`国创`、`电影`等等 |
`media`中的`areas`数组：
| 项 | 类型 | 内容 | 备注 |
| ---- | ---- | --------------- | ---- |
| 0 | obj | 地区信息1 | |
| n | obj | 地区信息（n+1） | |
| …… | obj | …… | |
`areas`数组中的对象：
| 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | ------------ | ------------------------------------------------------------ |
| id | num | 所属地区编号 | 1：中国大陆
2：日本
3：美国
4：英国
6：中国香港
8：韩国
9：法国
10：泰国
13：西班牙
15：德国
35：意大利
39：新西兰
43：澳大利亚 |
| name | str | 所属地区名称 | |
`media`中的`new_ep`对象：
| 字段 | 类型 | 内容 | 备注 |
| ---------- | ---- | ---------------- | -------------------------- |
| id | int | 最新一话的epID | |
| index | str | 最新一话名称 | |
| index_show | str | 最新一话显示名称 | eg. `第1话`、`更新至第4话` |
`media`中的`rating`对象：
| 字段 | 类型 | 内容 | 备注 |
| ----- | ---- | ------------ | ---- |
| count | num | 总计评分人数 | |
| score | num | 评分 | |
`result`中的`review`对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | ---- | ------------ |
| is_coin | num | 0 | 作用尚不明确 |
| is_open | num | 1 | 作用尚不明确 |
**示例：**
查询剧集`md28220978`的基本信息
```shell
curl -G 'http://api.bilibili.com/pgc/review/user' \
--data-urlencode 'media_id=28220978' \
-b 'SESSDATA=xxx'
```
查看响应示例：
```json
{
"code": 0,
"message": "success",
"result": {
"media": {
"areas": [
{
"id": 2,
"name": "日本"
}
],
"cover": "http://i0.hdslb.com/bfs/bangumi/8aa0bfce050c72c6626b63d3093a88527c251026.jpg",
"media_id": 28220978,
"new_ep": {
"id": 21278,
"index": "14",
"index_show": "全14话"
},
"rating": {
"count": 53376,
"score": 9.9
},
"season_id": 1172,
"share_url": "https://www.bilibili.com/bangumi/media/md28220978",
"title": "轻音少女 第一季",
"type_name": "番剧"
},
"review": {
"is_coin": 0,
"is_open": 1
}
}
}
```
## 获取剧集明细（web端）（ssID/epID方式）
> http://api.bilibili.com/pgc/view/web/season
*请求方式：GET*
**url参数：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| --------- | ---- | -------- | ------------ | ------------------------ |
| season_id | num | 番剧ssID | 必要（可选） | season_id与ep_id任选其一 |
| ep_id | num | 剧集epID | 必要（可选） | season_id与ep_id任选其一 |
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ----------------------- |
| code | num | 返回值 | 0：成功
-404：错误 |
| message | str | 错误信息 | 默认为success |
| ttl | num | 1 | 作用尚不明确 |
| result | obj | 信息本体 | |
`result`对象：
| 字段 | 类型 | 内容 | 备注 |
| --------------- | ------ | -------------------------- | ------------------------------------------ |
| activity | obj | 参与的活动 | |
| alias | str | 空 | 作用尚不明确 |
| bkg_cover | str | 网页背景图片url | 无则为空 |
| cover | str | 剧集封面图片url | |
| episodes | array | 正片剧集列表 | |
| evaluate | str | 简介 | |
| jp_title | str | 空 | 作用尚不明确 |
| link | str | 简介页面url | |
| media_id | num | 剧集mdID | |
| mode | num | 2 | 作用尚不明确 |
| new_ep | obj | 更新信息 | |
| payment | obj | 会员&付费信息 | 若无相关内容则无此项 |
| positive | obj | | |
| publish | obj | 发布信息 | |
| rating | obj | 评分信息 | 若无相关内容则无此项 |
| record | str | 备案号 | 无则为空 |
| rights | obj | 属性标志信息 | |
| season_id | num | 番剧ssID | |
| season_title | str | 剧集标题 | |
| seasons | array | 同系列所以季信息 | |
| section | array | 花絮、PV、番外等非正片内容 | 若无相关内容则无此项 |
| series | obj | 系列信息 | |
| share_copy | str | 《{标题}》+{备注} | |
| share_sub_title | str | 备注 | |
| share_url | str | 番剧播放页面url | |
| show | obj | 网页全屏标志 | |
| square_cover | str | 方形封面图片url | |
| stat | obj | 状态数 | |
| status | num | | |
| subtitle | str | 剧集副标题 | |
| title | str | 剧集标题 | |
| total | num | 总计正片集数 | 未完结：大多为-1
已完结：正整数 |
| type | num | 剧集类型 | 1：番剧
2：电影
3：纪录片
4：国创
5：电视剧
7：综艺 |
| up_info | obj | UP主信息 | 若无相关内容则无此项 |
`result`中的`activity`对象：
| 字段 | 类型 | 内容 | 备注 |
| ----------- | ---- | -------- | ------------ |
| head_bg_url | str | 空 | 作用尚不明确 |
| id | num | 活动id | |
| title | str | 活动标题 | |
`result`中的`episodes`数组：
| 项 | 类型 | 内容 | 备注 |
| ---- | ---- | --------------- | ------------ |
| 0 | obj | 正片第1集 | |
| n | obj | 正片第（n+1）集 | 按照顺序排列 |
| …… | obj | | |
`episodes`数组中的对象：
| 字段 | 类型 | 内容 | 备注 |
| ------------ | ---- | --------------------------------- | -------------------- |
| aid | num | 单集稿件avID | |
| badge | str | 标签文字 | 例如`会员`、`限免`等 |
| badge_info | obj | | |
| badge_type | num | | |
| bvid | str | 单集稿件bvID | |
| cid | num | 视频CID | |
| cover | str | 单集封面url | |
| dimension | obj | 分辨率信息 | |
| from | str | | |
| id | num | 单集epID | |
| link | str | 单集网页url | |
| long_title | str | 单集完整标题 | |
| pub_time | num | 发布时间 | 时间戳 |
| pv | num | 0 | 作用尚不明确 |
| release_date | str | 空 | 作用尚不明确 |
| rights | obj | | |
| share_copy | str | 《{标题}》+第n话+｛单集完整标题｝ | |
| share_url | str | 单集网页url | |
| short_link | str | 单集网页url短链接 | |
| status | num | | |
| subtitle | str | 单集副标题 | 观看次数文字 |
| title | str | 单集标题 | |
| vid | str | 单集vID | vupload_+{CID} |
`result`中的`new_ep`对象：
| 字段 | 类型 | 内容 | 备注 |
| ------ | ---- | ------------ | ---------------- |
| desc | str | 更新备注 | |
| id | num | 最新一话epID | |
| is_new | num | 是否最新发布 | 0：否
1：是 |
| title | str | 最新一话标题 | |
`result`中的`payment`对象：
| 字段 | 类型 | 内容 | 备注 |
| ------------------- | ---- | ---- | ---- |
| discount | num | | |
| pay_type | obj | | |
| price | str | | |
| promotion | str | | |
| tip | str | | |
| vip_discount | num | | |
| vip_first_promotion | str | | |
| vip_promotion | str | | |
`result`中的`positive`对象：
| 字段 | 类型 | 内容 | 备注 |
| ----- | ---- | ---- | ---- |
| id | num | | |
| title | str | | |
`result`中的`publish`对象：
| 字段 | 类型 | 内容 | 备注 |
| --------------- | ---- | ---------------- | ------------------------ |
| is_finish | num | 完结状态 | 0：未完结
1：已完结 |
| is_started | num | 是否发布 | 0：未发布
1：已发布 |
| pub_time | str | 发布时间 | YYYY-MM-DDD hh:mm:ss |
| pub_time_show | str | 发布时间文字介绍 | |
| unknow_pub_date | num | 0 | 作用尚不明确 |
| weekday | num | 0 | 作用尚不明确 |
`result`中的`rating`对象：
| 字段 | 类型 | 内容 | 备注 |
| ----- | ---- | ------------ | ---- |
| count | num | 总计评分人数 | |
| score | num | 评分 | |
`result`中的`rights`对象：
| 字段 | 类型 | 内容 | 备注 |
| ----------------- | ---- | -------- | ------------------------------- |
| allow_bp | num | | |
| allow_bp_rank | num | | |
| allow_download | num | | |
| allow_review | num | | |
| area_limit | num | | |
| ban_area_show | num | | |
| can_watch | num | | |
| copyright | str | 版权标志 | bilibili：授权
dujia：独家 |
| forbid_pre | num | | |
| is_cover_show | num | | |
| is_preview | num | | |
| only_vip_download | num | | |
| resource | str | | |
| watch_platform | num | | |
`result`中的`seasons`数组：
| 项 | 类型 | 内容 | 备注 |
| ---- | ---- | ----------------- | ------------ |
| 0 | obj | 同系列剧集1 | |
| n | obj | 同系列剧集（n+1） | 按照顺序排列 |
| …… | obj | | |
`seasons`数组中的对象：
| 字段 | 类型 | 内容 | 备注 |
| ------------ | ---- | ---- | ---- |
| badge | str | | |
| badge_info | obj | | |
| badge_type | num | | |
| cover | str | | |
| media_id | str | | |
| new_ep | num | | |
| season_id | obj | | |
| season_title | num | | |
| season_type | str | | |
| stat | obj | | |
`result`中的`section`数组：
| 项 | 类型 | 内容 | 备注 |
| ---- | ---- | ----------------- | ------------ |
| 0 | obj | 其他内容块1 | |
| n | obj | 其他内容块（n+1） | 按照顺序排列 |
| …… | obj | | |
`section`数组中的对象：
| 字段 | 类型 | 内容 | 备注 |
| ---------- | ----- | -------- | ---- |
| episode_id | num | 0 | |
| episodes | array | 板块内容 | |
| id | num | 板块ID？ | |
| title | str | 板块标题 | |
| type | num | ？ | |
`result`中的`series`对象：
| 字段 | 类型 | 内容 | 备注 |
| ------------ | ---- | ------ | ---- |
| series_id | num | 系列ID | |
| series_title | str | 系列名 | |
`result`中的`show`对象：
| 字段 | 类型 | 内容 | 备注 |
| ----------- | ---- | -------- | -------------------- |
| wide_screen | num | 是否全屏 | 0：正常
1：全屏 |
`result`中的`stat`对象：
| 字段 | 类型 | 内容 | 备注 |
| --------- | ---- | ------ | ---- |
| coins | num | 投币数 | |
| danmakus | num | 弹幕数 | |
| favorites | num | 收藏数 | |
| likes | num | 点赞数 | |
| reply | num | 评论数 | |
| share | num | 分享数 | |
| views | num | 播放数 | |
`result`中的`up_info`对象：
| 字段 | 类型 | 内容 | 备注 |
| ----------- | ---- | ----------- | ---- |
| avatar | str | 头像图片url | |
| follower | num | 粉丝数 | |
| is_follow | num | 0 | |
| mid | num | UP主UID | |
| pendant | obj | | |
| theme_type | num | 0 | |
| uname | str | UP主昵称 | |
| verify_type | num | | |
| vip_status | num | | |
| vip_type | num | | |
##