Skip to content

Latest commit

 

History

History
845 lines (727 loc) · 35.8 KB

history.md

File metadata and controls

845 lines (727 loc) · 35.8 KB
Raw

历史记录

获取历史记录列表_web端

https://api.bilibili.com/x/web-interface/history/cursor

请求方式：GET

认证方式：Cookie (SESSDATA)

注：max、business、view_at参数用于历史记录列表的 IFS (无限滚动)，其用法类似链表的 next 指针

本接口也可以返回已失效稿件的信息

url参数：

参数名 类型 内容 必要性 备注
max num 历史记录截止目标 id 非必要 默认为 0
稿件：稿件 avid
剧集（番剧 / 影视）：剧集 ssid
直播：直播间 id
文集：文集 rlid
文章：文章 cvid
business str 历史记录截止目标业务类型 非必要 默认为空
archive：稿件
pgc：剧集（番剧 / 影视）
live：直播
article-list：文集
article：文章
view_at num 历史记录截止时间 非必要 时间戳
默认为 0
0 为当前时间
type str 历史记录分类筛选 非必要 all：全部类型（默认）
archive：稿件
live：直播
article：文章
ps num 每页项数 非必要 默认为 20，最大 30

json回复：

根对象：

字段 类型 内容 备注
code num 返回值 0：成功
-101：账号未登录
-400：请求错误
message str 错误信息 默认为 0
ttl num 1
data array 历史记录列表

data对象：

字段 类型 内容 备注
cursor obj 历史记录页面信息
tab array 历史记录筛选类型
list array 分段历史记录列表

data中的cursor对象：

字段 类型 内容 备注
max num 最后一项目标 id 见请求参数
view_at num 最后一项时间节点 时间戳
business str 最后一项业务类型 见请求参数
ps num 每页项数

data中的tab数组：

项 类型 内容 备注
0 obj 历史记录筛选类型 1
1 obj 历史记录筛选类型 2
2 obj 历史记录筛选类型 3

tab数组中的对象：

字段 类型 内容 备注
type str 类型
name str 类型名

data中的list数组：

项 类型 内容 备注
0 obj 历史记录 1
n obj 历史记录 (n+1) 按照查看顺序排列
…… obj

list数组中的对象：

字段 类型 内容 备注
title str 条目标题
long_title str 条目副标题
cover str 条目封面图 url 用于专栏以外的条目
covers 有效时：array
无效时：null		 条目封面图组 仅用于专栏
uri str 重定向 url 仅用于剧集和直播
history obj 条目详细信息
videos num 视频分 P 数目 仅用于稿件视频
author_name str UP 主昵称
author_face str UP 主头像 url
author_mid num UP 主 mid
view_at num 查看时间 时间戳
progress num 视频观看进度 单位为秒
用于稿件视频或剧集
badge str 角标文案 稿件视频 / 剧集 / 笔记
show_title str 分 P 标题 用于稿件视频或剧集
duration num 视频总时长 用于稿件视频或剧集
current str (?)
total num 总计分集数 仅用于剧集
new_desc str 最新一话 / 最新一 P 标识 用于稿件视频或剧集
is_finish num 是否已完结 仅用于剧集
0：未完结
1：已完结
is_fav num 是否收藏 0：未收藏
1：已收藏
kid num 条目目标 id 详细内容见参数
tag_name str 子分区名 用于稿件视频和直播
live_status num 直播状态 仅用于直播
0：未开播
1：已开播

list数组中的对象中的covers数组：

项 类型 内容 备注
0 str 封面图片 1
n str 封面图片 (n+1)
…… str ……

list数组中的对象中的history对象：

字段 类型 内容 备注
oid num 目标id 稿件视频&剧集（当business=archive或business=pgc时）：稿件avid
直播（当business=live时）：直播间id
文章（当business=article时）：文章cvid
文集（当business=article-list时）：文集rlid
epid num 剧集epid 仅用于剧集
bvid str 稿件bvid 仅用于稿件视频
page num 观看到的视频分P数 仅用于稿件视频
cid num 观看到的对象id 稿件视频&剧集（当business=archive或business=pgc时）：视频cid
文集（当business=article-list时）：文章cvid
part str 观看到的视频分 P 标题 仅用于稿件视频
business str 业务类型 见请求参数
dt num 记录查看的平台代码 1 3 5 7：手机端
2：web端
4 6：pad端
33：TV端
0：其他

示例：

获取当前时间截止的5条历史记录

curl -G 'https://api.bilibili.com/x/web-interface/history/cursor' \
--data-urlencode 'ps=5' \
-b 'SESSDATA=xxx'
查看响应示例： 
{
    "code": 0,
    "message": "0",
    "ttl": 1,
    "data": {
        "cursor": {
            "max": 26193,
            "view_at": 1592985807,
            "business": "pgc",
            "ps": 5
        },
        "tab": [
            {
                "type": "archive",
                "name": "视频"
            },
            {
                "type": "live",
                "name": "直播"
            },
            {
                "type": "article",
                "name": "专栏"
            }
        ],
        "list": [
            {
                "title": "韩国漫画如何出海掘金？一年出口额2.8亿元",
                "long_title": "",
                "cover": "",
                "covers": [
                    "https://i0.hdslb.com/bfs/article/b170c6fd7429ae205d6cb935e1d431710d82609d.jpg"
                ],
                "uri": "",
                "history": {
                    "oid": 6470274,
                    "epid": 0,
                    "bvid": "",
                    "page": 0,
                    "cid": 0,
                    "part": "",
                    "business": "article",
                    "dt": 2
                },
                "videos": 0,
                "author_name": "三文娱",
                "author_face": "http://i1.hdslb.com/bfs/face/98566839756a8e3de6e183109984b032de6ff2d9.jpg",
                "author_mid": 34772409,
                "view_at": 1593000539,
                "progress": 0,
                "badge": "专栏",
                "show_title": "",
                "duration": 0,
                "current": "",
                "total": 0,
                "new_desc": "",
                "is_finish": 0,
                "is_fav": 0,
                "kid": 6470274,
                "tag_name": "",
                "live_status": 0
            },
            {
                "title": "从国际空间站俯瞰地球，静谧蓝星守护者",
                "long_title": "",
                "cover": "http://i0.hdslb.com/bfs/live/new_room_cover/f07d8a0c7c5655f81cf1586903a121f2680cf3bc.jpg",
                "covers": null,
                "uri": "https://live.bilibili.com/14047",
                "history": {
                    "oid": 14047,
                    "epid": 0,
                    "bvid": "",
                    "page": 0,
                    "cid": 0,
                    "part": "",
                    "business": "live",
                    "dt": 2
                },
                "videos": 0,
                "author_name": "Zelo-Balance",
                "author_face": "http://i1.hdslb.com/bfs/face/7303b3032d1e13ca7c788cd9c30d4430f8ffd1ea.jpg",
                "author_mid": 19193,
                "view_at": 1592999822,
                "progress": 0,
                "badge": "直播中",
                "show_title": "",
                "duration": 0,
                "current": "",
                "total": 0,
                "new_desc": "",
                "is_finish": 0,
                "is_fav": 0,
                "kid": 14047,
                "tag_name": "户外",
                "live_status": 1
            },
            {
                "title": "许巍 《蓝莲花》吉他Cover，这回你们不用截图抓我了吧",
                "long_title": "",
                "cover": "http://i2.hdslb.com/bfs/archive/0225b1f1a790393097ceebb51e89796be806d6bc.jpg",
                "covers": null,
                "uri": "",
                "history": {
                    "oid": 883617049,
                    "epid": 0,
                    "bvid": "BV1sK4y147ob",
                    "page": 1,
                    "cid": 205017957,
                    "part": "许巍 《蓝莲花》 Cover_1",
                    "business": "archive",
                    "dt": 2
                },
                "videos": 1,
                "author_name": "硬核拆解",
                "author_face": "http://i1.hdslb.com/bfs/face/4e131c9609299303cdde882792fc62b9f99cdcde.jpg",
                "author_mid": 427494870,
                "view_at": 1592999572,
                "progress": 13,
                "badge": "",
                "show_title": "",
                "duration": 91,
                "current": "",
                "total": 0,
                "new_desc": "",
                "is_finish": 0,
                "is_fav": 0,
                "kid": 883617049,
                "tag_name": "演奏",
                "live_status": 0
            },
            {
                "title": "从清楚与混沌之分看Vtuber形象塑造",
                "long_title": "",
                "cover": "",
                "covers": [
                    "https://i0.hdslb.com/bfs/article/5ddb94dd1890c639622717c7083fb2917b4aa475.jpg"
                ],
                "uri": "",
                "history": {
                    "oid": 268656,
                    "epid": 0,
                    "bvid": "",
                    "page": 0,
                    "cid": 6233590,
                    "part": "",
                    "business": "article-list",
                    "dt": 2
                },
                "videos": 0,
                "author_name": "普天一光",
                "author_face": "http://i2.hdslb.com/bfs/face/3702810bdac3d5103d684e61dc5bc8492a74f904.jpg",
                "author_mid": 6614889,
                "view_at": 1592998686,
                "progress": 0,
                "badge": "专栏",
                "show_title": "",
                "duration": 0,
                "current": "",
                "total": 0,
                "new_desc": "",
                "is_finish": 0,
                "is_fav": 0,
                "kid": 268656,
                "tag_name": "",
                "live_status": 0
            },
            {
                "title": "百妖谱",
                "long_title": "庆忌（下）",
                "cover": "http://i0.hdslb.com/bfs/archive/695a4566d05620a24c51d6eb935fa4767d673b45.jpg",
                "covers": null,
                "uri": "https://www.bilibili.com/bangumi/play/ss26193",
                "history": {
                    "oid": 370908663,
                    "epid": 326789,
                    "bvid": "",
                    "page": 0,
                    "cid": 199204975,
                    "part": "",
                    "business": "pgc",
                    "dt": 3
                },
                "videos": 0,
                "author_name": "",
                "author_face": "",
                "author_mid": 0,
                "view_at": 1592985807,
                "progress": 533,
                "badge": "国创",
                "show_title": "第8话 庆忌（下）",
                "duration": 1402,
                "current": "",
                "total": 12,
                "new_desc": "更新至第10话",
                "is_finish": 0,
                "is_fav": 0,
                "kid": 26193,
                "tag_name": "",
                "live_status": 0
            }
        ]
    }
}

获取视频观看历史记录_web端旧版

https://api.bilibili.com/x/v2/history

请求方式：GET

认证方式：Cookie (SESSDATA)

本接口也可以返回已失效稿件的信息

url参数：

参数名 类型 内容 必要性 备注
pn num 页码 非必要 默认为1
ps num 每页项数 非必要

json回复：

根对象：

字段 类型 内容 备注
code num 返回值 0：成功
-101：账号未登录
-400：请求错误
message str 错误信息 默认为0
ttl num 1
data array 历史记录列表

data数组：

项 类型 内容 备注
0 obj 历史观看1
n obj 历史观看(n+1) 按照观看顺序排列
项数为总计观看视频数
…… obj …… ……

data数组中的对象：

字段 类型 内容 备注
aid num 稿件avid
videos num 视频分P总数 默认为1
tid num 分区tid
tname str 子分区名称
copyright num 是否转载 1：原创
2：转载
pic str 视频封面图片url
title str 稿件标题
pubdate num 稿件发布时间 时间戳
ctime num 用户提交稿件的时间 时间戳
desc str 视频简介
state num 视频状态 略，见获取视频详细信息（web端）中的state备注
attribute（仅做历史性保留） num 稿件属性位配置 本字段已被删除
略，见获取视频详细信息（web端）中的attribute备注
duration num 视频总计持续时长（所有分P） 单位为秒
rights obj 视频属性标志 略，见获取视频详细信息（web端）中的rights对象
owner obj 视频UP主信息 略，见获取视频详细信息（web端）中的owner对象
stat obj 视频状态数 略，见获取视频详细信息（web端）中的stat对象
dynamic str 视频同步发布的的动态的文字内容 无为空
cid num 视频1P cid
dimension obj 视频1P分辨率 略，见获取视频详细信息（web端）中的dimension对象
bangumi obj 番剧/影视信息 非番剧/影视无此项
cheese obj 课程信息 非课程无此项
favorite bool 是否已收藏 true：已收藏
false：未收藏
type num 视频属性 3：普通视频
4：剧集
10：课程
sub_type num 附视频属性 0：普通视频
1：番剧
2：电影
3：纪录片
4：国创
5：电视剧
7：综艺
device num 观看平台代码 1 3 5 7：手机端
2：web端
4 6：pad端
33：TV端
0：其他
page obj 最后观看的分P信息
count num 分P数 非投稿视频无此项
progress num 观看进度 单位为秒
view_at num 观看时间 时间戳
kid num 稿件avid
business str 视频类型标识 archive：用户投稿视频
pgc：番剧/影视
cheese：课程
redirect_link str 重定向url
bvid str 稿件bvid

data数组中的对象bangumi对象：

字段 类型 内容 备注
cover str 番剧封面图片url
ep_id num 番剧epid
episode_status num ？？？
follow num 0 作用尚不明确
long_title str 单集标题
season obj 剧集信息
title str 集数

bangumi中的season对象：

字段 类型 内容 备注
is_finish num 是否完结 0：连载中
1：完结
newest_ep_id num 最细一话epid
newest_ep_index str 最细一话集数
season_id num 番剧ssid
season_status num ？？？
season_type num ？？？
title str 番剧标题
total_count num 总集数

data数组中的对象cheese对象：

字段 类型 内容 备注
cover str 课程封面图片url
long_title str 完整标题
number str 本集数
season_id num 课程ssid
update_info str 总集数

示例：

查询当前视频历史记录列表

curl -G 'https://api.bilibili.com/x/v2/history' \
--data-urlencode 'ps=5' \
--data-urlencode 'pn=1' \
-b 'SESSDATA=xxx'
查看响应示例： 
{
    "code": 0,
    "message": "0",
    "ttl": 1,
    "data": [
        {
            "aid": 96523832,
            "videos": 1,
            "tid": 33,
            "tname": "连载动画",
            "copyright": 2,
            "pic": "http://i0.hdslb.com/bfs/archive/dfc29be381565ee041a0ec9cfc7a32f8a63f76cd.jpg",
            "title": "【1月】异度侵入 ID:INVADED 12【独家正版】",
            "pubdate": 1584289800,
            "ctime": 1584289800,
            "desc": "#12",
            "state": 0,
            "attribute": 338688,
            "duration": 1481,
            "redirect_url": "https://www.bilibili.com/bangumi/play/ep307457",
            "rights": {
                "bp": 0,
                "elec": 0,
                "download": 0,
                "movie": 0,
                "pay": 1,
                "hd5": 1,
                "no_reprint": 0,
                "autoplay": 0,
                "ugc_pay": 0,
                "is_cooperation": 0,
                "ugc_pay_preview": 0,
                "no_background": 0
            },
            "owner": {
                "mid": 928123,
                "name": "哔哩哔哩番剧",
                "face": "http://i1.hdslb.com/bfs/face/7a8412cbacb9fd18f40ddbbf0ad183e45afc1365.jpg"
            },
            "stat": {
                "aid": 96523832,
                "view": 4772927,
                "danmaku": 108890,
                "reply": 48584,
                "favorite": 46,
                "coin": 61768,
                "share": 290,
                "now_rank": 0,
                "his_rank": 0,
                "like": 1241,
                "dislike": 0
            },
            "dynamic": "",
            "cid": 164789275,
            "dimension": {
                "width": 1920,
                "height": 1080,
                "rotate": 0
            },
            "favorite": false,
            "type": 4,
            "sub_type": 1,
            "device": 3,
            "page": {
                "cid": 164789275,
                "page": 1,
                "from": "vupload",
                "part": "ID_INVADED_112.encoded",
                "duration": 1481,
                "vid": "",
                "weblink": "",
                "dimension": {
                    "width": 1920,
                    "height": 1080,
                    "rotate": 0
                }
            },
            "bangumi": {
                "ep_id": 307457,
                "title": "12",
                "long_title": "CHANNELED",
                "episode_status": 13,
                "follow": 0,
                "cover": "http://i0.hdslb.com/bfs/archive/dfc29be381565ee041a0ec9cfc7a32f8a63f76cd.jpg",
                "season": {
                    "season_id": 29310,
                    "title": "异度侵入 ID:INVADED",
                    "season_status": 13,
                    "is_finish": 1,
                    "total_count": 13,
                    "newest_ep_id": 307774,
                    "newest_ep_index": "13",
                    "season_type": 1
                }
            },
            "progress": 277,
            "view_at": 1588831600,
            "kid": 29310,
            "business": "pgc",
            "redirect_link": "https://www.bilibili.com/bangumi/play/ep307457",
            "bvid": "BV1K7411f7uu"
        },
        {
            "aid": 497899395,
            "videos": 1,
            "tid": 189,
            "tname": "电脑装机",
            "copyright": 1,
            "pic": "http://i0.hdslb.com/bfs/archive/fd4e0893b234ee729cf15198065eced98367ebfe.jpg",
            "title": "600元的2007款iMac，如今过时了吗？",
            "pubdate": 1587727345,
            "ctime": 1587708111,
            "desc": "苹果东西是真的保值，酷睿2现在都还能卖的这么贵。第一次使用4K画质进行拍摄，应该比以前清楚一些。如有问题请在评论区指出，谢谢！",
            "state": 0,
            "attribute": 16768,
            "duration": 389,
            "mission_id": 13106,
            "rights": {
                "bp": 0,
                "elec": 0,
                "download": 0,
                "movie": 0,
                "pay": 0,
                "hd5": 1,
                "no_reprint": 1,
                "autoplay": 1,
                "ugc_pay": 0,
                "is_cooperation": 0,
                "ugc_pay_preview": 0,
                "no_background": 0
            },
            "owner": {
                "mid": 3391089,
                "name": "数字云糕Official",
                "face": "http://i2.hdslb.com/bfs/face/238dfbca5dda5de2d5ba95ee4e99804714e2b5e2.jpg"
            },
            "stat": {
                "aid": 497899395,
                "view": 23325,
                "danmaku": 92,
                "reply": 115,
                "favorite": 195,
                "coin": 132,
                "share": 23,
                "now_rank": 0,
                "his_rank": 0,
                "like": 555,
                "dislike": 0
            },
            "dynamic": "#IMAC##APPLE##MAC# 苹果东西是真的保值，酷睿2现在都还能卖的这么贵。第一次使用4K画质进行拍摄，应该比以前清楚一些。",
            "cid": 182570131,
            "dimension": {
                "width": 1920,
                "height": 1080,
                "rotate": 0
            },
            "favorite": false,
            "type": 3,
            "sub_type": 0,
            "device": 3,
            "page": {
                "cid": 182570131,
                "page": 1,
                "from": "vupload",
                "part": "iMac",
                "duration": 389,
                "vid": "",
                "weblink": "",
                "dimension": {
                    "width": 1920,
                    "height": 1080,
                    "rotate": 0
                }
            },
            "count": 1,
            "progress": -1,
            "view_at": 1588828357,
            "kid": 497899395,
            "business": "archive",
            "redirect_link": "https://www.bilibili.com/video/av497899395",
            "bvid": "BV1NK41157EF"
        }
    ]
}

删除历史记录

https://api.bilibili.com/x/v2/history/delete

请求方式：POST

认证方式：Cookie (SESSDATA)

正文参数（ application/x-www-form-urlencoded ）：

参数名 类型 内容 必要性 备注
kid str 删除的目标记录，格式为{业务类型}_{目标id}详见备注 必要 视频：archive_{稿件avid}
直播：live_{直播间id}
专栏：article_{专栏cvid}
剧集：pgc_{剧集ssid}
文集：article-list_{文集rlid}
csrf str CSRF Token（位于cookie） 必要

json回复：

根对象：

字段 类型 内容 备注
code num 返回值 0：成功
-101：账号未登录
-111：csrf校验失败
-400：请求错误
message str 错误信息 默认为0
ttl num 1

示例：

删除视频av540580868的观看历史记录

curl 'https://api.bilibili.com/x/v2/history/delete' \
--data-urlencode 'kid=archive_540580868' \
--data-urlencode 'csrf=xxx' \
-b 'SESSDATA=xxx'
查看响应示例： 
{
    "code": 0,
    "message": "0",
    "ttl": 1
}

清空历史记录

https://api.bilibili.com/x/v2/history/clear

请求方式：POST

认证方式：Cookie (SESSDATA)

正文参数（ application/x-www-form-urlencoded ）：

参数名 类型 内容 必要性 备注
csrf str CSRF Token（位于cookie） 必要

json回复：

根对象：

字段 类型 内容 备注
code num 返回值 0：成功
-101：账号未登录
-111：csrf校验失败
message str 错误信息 默认为0
ttl num 1

示例：

清空历史记录

curl 'https://api.bilibili.com/x/v2/history/clear' \
--data-urlencode 'csrf=xxx' \
-b 'SESSDATA=xxx'
查看响应示例： 
{
    "code": 0,
    "message": "0",
    "ttl": 1
}

停用历史记录

https://api.bilibili.com/x/v2/history/shadow/set

请求方式：POST

认证方式：Cookie (SESSDATA)

该操作不会影响原有历史记录

正文参数（ application/x-www-form-urlencoded ）：

参数名 类型 内容 必要性 备注
switch bool 停用开关 非必要 true：停用
false：正常
默认为false
csrf str CSRF Token（位于cookie） 必要

json回复：

根对象：

字段 类型 内容 备注
code num 返回值 0：成功
-101：账号未登录
-111：csrf校验失败
message str 错误信息 默认为0
ttl num 1

示例：

停用历史记录功能

curl 'https://api.bilibili.com/x/v2/history/shadow/set' \
--data-urlencode 'switch=true' \
--data-urlencode 'csrf=xxx' \
-b 'SESSDATA=xxx'
查看响应示例： 
{
    "code": 0,
    "message": "0",
    "ttl": 1
}

查询历史记录停用状态

https://api.bilibili.com/x/v2/history/shadow

请求方式：GET

认证方式：Cookie (SESSDATA)

json回复：

根对象：

字段 类型 内容 备注
code num 返回值 0：成功
-101：账号未登录
message str 错误信息 默认为0
ttl num 1
data bool 停用状态 true：停用
false：正常

示例：

当前状态为未停用视频历史记录

curl 'https://api.bilibili.com/x/v2/history/shadow' \
-b 'SESSDATA=xxx'
查看响应示例： 
{
    "code": 0,
    "message": "0",
    "ttl": 1,
    "data": false
}