import{_ as e,c as r,a as p,b as s,d as l,e as t,w as o,r as D,o as d}from"./app-Dgsdh8A6.js";const c={};function i(u,n){const a=D("RouteLink");return d(),r("div",null,[n[78]||(n[78]=p(`

历史记录

获取历史记录列表_web端

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

请求方式:GET

认证方式:Cookie (SESSDATA)

注:maxbusinessview_at参数用于历史记录列表的 IFS (无限滚动),其用法类似链表的 next 指针

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

url参数:

参数名类型内容必要性备注
maxnum历史记录截止目标 id非必要默认为 0
稿件:稿件 avid
剧集(番剧 / 影视):剧集 ssid
直播:直播间 id
文集:文集 rlid
文章:文章 cvid
businessstr历史记录截止目标业务类型非必要默认为空
archive:稿件
pgc:剧集(番剧 / 影视)
live:直播
article-list:文集
article:文章
view_atnum历史记录截止时间非必要时间戳
默认为 0
0 为当前时间
typestr历史记录分类筛选非必要all:全部类型(默认)
archive:稿件
live:直播
article:文章
psnum每页项数非必要默认为 20,最大 30

json回复:

根对象:

字段类型内容备注
codenum返回值0:成功
-101:账号未登录
-400:请求错误
messagestr错误信息默认为 0
ttlnum1
dataarray历史记录列表

data对象:

字段类型内容备注
cursorobj历史记录页面信息
tabarray历史记录筛选类型
listarray分段历史记录列表

data中的cursor对象:

字段类型内容备注
maxnum最后一项目标 id见请求参数
view_atnum最后一项时间节点时间戳
businessstr最后一项业务类型见请求参数
psnum每页项数

data中的tab数组:

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

tab数组中的对象:

字段类型内容备注
typestr类型
namestr类型名

data中的list数组:

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

list数组中的对象:

字段类型内容备注
titlestr条目标题
long_titlestr条目副标题
coverstr条目封面图 url用于专栏以外的条目
covers有效时:array
无效时:null
条目封面图组仅用于专栏
uristr重定向 url仅用于剧集和直播
historyobj条目详细信息
videosnum视频分 P 数目仅用于稿件视频
author_namestrUP 主昵称
author_facestrUP 主头像 url
author_midnumUP 主 mid
view_atnum查看时间时间戳
progressnum视频观看进度单位为秒
用于稿件视频或剧集
badgestr角标文案稿件视频 / 剧集 / 笔记
show_titlestr分 P 标题用于稿件视频或剧集
durationnum视频总时长用于稿件视频或剧集
currentstr(?)
totalnum总计分集数仅用于剧集
new_descstr最新一话 / 最新一 P 标识用于稿件视频或剧集
is_finishnum是否已完结仅用于剧集
0:未完结
1:已完结
is_favnum是否收藏0:未收藏
1:已收藏
kidnum条目目标 id详细内容见参数
tag_namestr子分区名用于稿件视频和直播
live_statusnum直播状态仅用于直播
0:未开播
1:已开播

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

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

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

字段类型内容备注
oidnum目标id稿件视频&剧集(当business=archivebusiness=pgc时):稿件avid
直播(当business=live时):直播间id
文章(当business=article时):文章cvid
文集(当business=article-list时):文集rlid
epidnum剧集epid仅用于剧集
bvidstr稿件bvid仅用于稿件视频
pagenum观看到的视频分P数仅用于稿件视频
cidnum观看到的对象id稿件视频&剧集(当business=archivebusiness=pgc时):视频cid
文集(当business=article-list时):文章cvid
partstr观看到的视频分 P 标题仅用于稿件视频
businessstr业务类型见请求参数
dtnum记录查看的平台代码1 3 5 7:手机端
2:web端
4 6:pad端
9: 智能音箱/游戏机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参数:

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

json回复:

根对象:

字段类型内容备注
codenum返回值0:成功
-101:账号未登录
-400:请求错误
messagestr错误信息默认为0
ttlnum1
dataarray历史记录列表

data数组:

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

data数组中的对象:

`,45)),s("table",null,[n[77]||(n[77]=s("thead",null,[s("tr",null,[s("th",null,"字段"),s("th",null,"类型"),s("th",null,"内容"),s("th",null,"备注")])],-1)),s("tbody",null,[n[50]||(n[50]=s("tr",null,[s("td",null,"aid"),s("td",null,"num"),s("td",null,"稿件avid"),s("td")],-1)),n[51]||(n[51]=s("tr",null,[s("td",null,"videos"),s("td",null,"num"),s("td",null,"视频分P总数"),s("td",null,"默认为1")],-1)),n[52]||(n[52]=s("tr",null,[s("td",null,"tid"),s("td",null,"num"),s("td",null,"分区tid"),s("td")],-1)),n[53]||(n[53]=s("tr",null,[s("td",null,"tname"),s("td",null,"str"),s("td",null,"子分区名称"),s("td")],-1)),n[54]||(n[54]=s("tr",null,[s("td",null,"copyright"),s("td",null,"num"),s("td",null,"是否转载"),s("td",null,[l("1:原创"),s("br"),l("2:转载"),s("br"),l("3:未填写")])],-1)),n[55]||(n[55]=s("tr",null,[s("td",null,"pic"),s("td",null,"str"),s("td",null,"视频封面图片url"),s("td")],-1)),n[56]||(n[56]=s("tr",null,[s("td",null,"title"),s("td",null,"str"),s("td",null,"稿件标题"),s("td")],-1)),n[57]||(n[57]=s("tr",null,[s("td",null,"pubdate"),s("td",null,"num"),s("td",null,"稿件发布时间"),s("td",null,"时间戳")],-1)),n[58]||(n[58]=s("tr",null,[s("td",null,"ctime"),s("td",null,"num"),s("td",null,"用户提交稿件的时间"),s("td",null,"时间戳")],-1)),n[59]||(n[59]=s("tr",null,[s("td",null,"desc"),s("td",null,"str"),s("td",null,"视频简介"),s("td")],-1)),s("tr",null,[n[5]||(n[5]=s("td",null,"state",-1)),n[6]||(n[6]=s("td",null,"num",-1)),n[7]||(n[7]=s("td",null,"视频状态",-1)),s("td",null,[n[1]||(n[1]=l("略,见")),t(a,{to:"/docs/video/info.html#%E8%8E%B7%E5%8F%96%E8%A7%86%E9%A2%91%E8%AF%A6%E7%BB%86%E4%BF%A1%E6%81%AF%EF%BC%88web%E7%AB%AF%EF%BC%89"},{default:o(()=>n[0]||(n[0]=[l("获取视频详细信息(web端)")])),_:1,__:[0]}),n[2]||(n[2]=l("中的")),n[3]||(n[3]=s("code",null,"state",-1)),n[4]||(n[4]=l("备注"))])]),s("tr",null,[n[15]||(n[15]=s("td",null,[s("s",null,"attribute"),l("(仅做历史性保留)")],-1)),n[16]||(n[16]=s("td",null,[s("s",null,"num")],-1)),n[17]||(n[17]=s("td",null,[s("s",null,"稿件属性位配置")],-1)),s("td",null,[n[13]||(n[13]=l("本字段已被删除")),n[14]||(n[14]=s("br",null,null,-1)),s("s",null,[n[9]||(n[9]=l("略,见")),t(a,{to:"/docs/video/info.html#%E8%8E%B7%E5%8F%96%E8%A7%86%E9%A2%91%E8%AF%A6%E7%BB%86%E4%BF%A1%E6%81%AF%EF%BC%88web%E7%AB%AF%EF%BC%89"},{default:o(()=>n[8]||(n[8]=[l("获取视频详细信息(web端)")])),_:1,__:[8]}),n[10]||(n[10]=l("中的")),n[11]||(n[11]=s("code",null,"attribute",-1)),n[12]||(n[12]=l("备注"))])])]),n[60]||(n[60]=s("tr",null,[s("td",null,"duration"),s("td",null,"num"),s("td",null,"视频总计持续时长(所有分P)"),s("td",null,"单位为秒")],-1)),s("tr",null,[n[23]||(n[23]=s("td",null,"rights",-1)),n[24]||(n[24]=s("td",null,"obj",-1)),n[25]||(n[25]=s("td",null,"视频属性标志",-1)),s("td",null,[n[19]||(n[19]=l("略,见")),t(a,{to:"/docs/video/info.html#%E8%8E%B7%E5%8F%96%E8%A7%86%E9%A2%91%E8%AF%A6%E7%BB%86%E4%BF%A1%E6%81%AF%EF%BC%88web%E7%AB%AF%EF%BC%89"},{default:o(()=>n[18]||(n[18]=[l("获取视频详细信息(web端)")])),_:1,__:[18]}),n[20]||(n[20]=l("中的")),n[21]||(n[21]=s("code",null,"rights",-1)),n[22]||(n[22]=l("对象"))])]),s("tr",null,[n[31]||(n[31]=s("td",null,"owner",-1)),n[32]||(n[32]=s("td",null,"obj",-1)),n[33]||(n[33]=s("td",null,"视频UP主信息",-1)),s("td",null,[n[27]||(n[27]=l("略,见")),t(a,{to:"/docs/video/info.html#%E8%8E%B7%E5%8F%96%E8%A7%86%E9%A2%91%E8%AF%A6%E7%BB%86%E4%BF%A1%E6%81%AF%EF%BC%88web%E7%AB%AF%EF%BC%89"},{default:o(()=>n[26]||(n[26]=[l("获取视频详细信息(web端)")])),_:1,__:[26]}),n[28]||(n[28]=l("中的")),n[29]||(n[29]=s("code",null,"owner",-1)),n[30]||(n[30]=l("对象"))])]),s("tr",null,[n[39]||(n[39]=s("td",null,"stat",-1)),n[40]||(n[40]=s("td",null,"obj",-1)),n[41]||(n[41]=s("td",null,"视频状态数",-1)),s("td",null,[n[35]||(n[35]=l("略,见")),t(a,{to:"/docs/video/info.html#%E8%8E%B7%E5%8F%96%E8%A7%86%E9%A2%91%E8%AF%A6%E7%BB%86%E4%BF%A1%E6%81%AF%EF%BC%88web%E7%AB%AF%EF%BC%89"},{default:o(()=>n[34]||(n[34]=[l("获取视频详细信息(web端)")])),_:1,__:[34]}),n[36]||(n[36]=l("中的")),n[37]||(n[37]=s("code",null,"stat",-1)),n[38]||(n[38]=l("对象"))])]),n[61]||(n[61]=s("tr",null,[s("td",null,"dynamic"),s("td",null,"str"),s("td",null,"视频同步发布的的动态的文字内容"),s("td",null,"无为空")],-1)),n[62]||(n[62]=s("tr",null,[s("td",null,"cid"),s("td",null,"num"),s("td",null,"视频1P cid"),s("td")],-1)),s("tr",null,[n[47]||(n[47]=s("td",null,"dimension",-1)),n[48]||(n[48]=s("td",null,"obj",-1)),n[49]||(n[49]=s("td",null,"视频1P分辨率",-1)),s("td",null,[n[43]||(n[43]=l("略,见")),t(a,{to:"/docs/video/info.html#%E8%8E%B7%E5%8F%96%E8%A7%86%E9%A2%91%E8%AF%A6%E7%BB%86%E4%BF%A1%E6%81%AF%EF%BC%88web%E7%AB%AF%EF%BC%89"},{default:o(()=>n[42]||(n[42]=[l("获取视频详细信息(web端)")])),_:1,__:[42]}),n[44]||(n[44]=l("中的")),n[45]||(n[45]=s("code",null,"dimension",-1)),n[46]||(n[46]=l("对象"))])]),n[63]||(n[63]=s("tr",null,[s("td",null,"bangumi"),s("td",null,"obj"),s("td",null,"番剧/影视信息"),s("td",null,"非番剧/影视无此项")],-1)),n[64]||(n[64]=s("tr",null,[s("td",null,"cheese"),s("td",null,"obj"),s("td",null,"课程信息"),s("td",null,"非课程无此项")],-1)),n[65]||(n[65]=s("tr",null,[s("td",null,"favorite"),s("td",null,"bool"),s("td",null,"是否已收藏"),s("td",null,[l("true:已收藏"),s("br"),l("false:未收藏")])],-1)),n[66]||(n[66]=s("tr",null,[s("td",null,"type"),s("td",null,"num"),s("td",null,"视频属性"),s("td",null,[l("3:普通视频"),s("br"),l("4:剧集"),s("br"),l("10:课程")])],-1)),n[67]||(n[67]=s("tr",null,[s("td",null,"sub_type"),s("td",null,"num"),s("td",null,"附视频属性"),s("td",null,[l("0:普通视频"),s("br"),l("1:番剧"),s("br"),l("2:电影"),s("br"),l("3:纪录片"),s("br"),l("4:国创"),s("br"),l("5:电视剧"),s("br"),l("7:综艺")])],-1)),n[68]||(n[68]=s("tr",null,[s("td",null,"device"),s("td",null,"num"),s("td",null,"观看平台代码"),s("td",null,[l("1 3 5 7:手机端"),s("br"),l("2:web端"),s("br"),l("4 6:pad端"),s("br"),l("33:TV端"),s("br"),l("0:其他")])],-1)),n[69]||(n[69]=s("tr",null,[s("td",null,"page"),s("td",null,"obj"),s("td",null,"最后观看的分P信息"),s("td")],-1)),n[70]||(n[70]=s("tr",null,[s("td",null,"count"),s("td",null,"num"),s("td",null,"分P数"),s("td",null,"非投稿视频无此项")],-1)),n[71]||(n[71]=s("tr",null,[s("td",null,"progress"),s("td",null,"num"),s("td",null,"观看进度"),s("td",null,"单位为秒")],-1)),n[72]||(n[72]=s("tr",null,[s("td",null,"view_at"),s("td",null,"num"),s("td",null,"观看时间"),s("td",null,"时间戳")],-1)),n[73]||(n[73]=s("tr",null,[s("td",null,"kid"),s("td",null,"num"),s("td",null,"稿件avid"),s("td")],-1)),n[74]||(n[74]=s("tr",null,[s("td",null,"business"),s("td",null,"str"),s("td",null,"视频类型标识"),s("td",null,[l("archive:用户投稿视频"),s("br"),l("pgc:番剧/影视"),s("br"),l("cheese:课程")])],-1)),n[75]||(n[75]=s("tr",null,[s("td",null,"redirect_link"),s("td",null,"str"),s("td",null,"重定向url"),s("td")],-1)),n[76]||(n[76]=s("tr",null,[s("td",null,"bvid"),s("td",null,"str"),s("td",null,"稿件bvid"),s("td")],-1))])]),n[79]||(n[79]=p(`

data数组中的对象bangumi对象:

字段类型内容备注
coverstr番剧封面图片url
ep_idnum番剧epid
episode_statusnum???
follownum0作用尚不明确
long_titlestr单集标题
seasonobj剧集信息
titlestr集数

bangumi中的season对象:

字段类型内容备注
is_finishnum是否完结0:连载中
1:完结
newest_ep_idnum最细一话epid
newest_ep_indexstr最细一话集数
season_idnum番剧ssid
season_statusnum???
season_typenum???
titlestr番剧标题
total_countnum总集数

data数组中的对象cheese对象:

字段类型内容备注
coverstr课程封面图片url
long_titlestr完整标题
numberstr本集数
season_idnum课程ssid
update_infostr总集数

示例:

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

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 ):

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

json回复:

根对象:

字段类型内容备注
codenum返回值0:成功
-101:账号未登录
-111:csrf校验失败
-400:请求错误
messagestr错误信息默认为0
ttlnum1

示例:

删除视频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 ):

参数名类型内容必要性备注
csrfstrCSRF Token(位于cookie)必要

json回复:

根对象:

字段类型内容备注
codenum返回值0:成功
-101:账号未登录
-111:csrf校验失败
messagestr错误信息默认为0
ttlnum1

示例:

清空历史记录

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 ):

参数名类型内容必要性备注
switchbool停用开关非必要true:停用
false:正常
默认为false
csrfstrCSRF Token(位于cookie)必要

json回复:

根对象:

字段类型内容备注
codenum返回值0:成功
-101:账号未登录
-111:csrf校验失败
messagestr错误信息默认为0
ttlnum1

示例:

停用历史记录功能

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回复:

根对象:

字段类型内容备注
codenum返回值0:成功
-101:账号未登录
messagestr错误信息默认为0
ttlnum1
databool停用状态true:停用
false:正常

示例:

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

curl 'https://api.bilibili.com/x/v2/history/shadow' \\
-b 'SESSDATA=xxx'
查看响应示例:
{
    "code": 0,
    "message": "0",
    "ttl": 1,
    "data": false
}
`,61))])}const C=e(c,[["render",i]]),v=JSON.parse('{"path":"/docs/historytoview/history.html","title":"历史记录","lang":"zh-CN","frontmatter":{},"git":{"updatedTime":1768157682000,"contributors":[{"name":"SocialSisterYi","username":"SocialSisterYi","email":"1440239038@qq.com","commits":2,"url":"https://github.com/SocialSisterYi"},{"name":"LaMerChiang","username":"LaMerChiang","email":"catlair@qq.com","commits":1,"url":"https://github.com/LaMerChiang"},{"name":"wuziqian211","username":"wuziqian211","email":"65224318+wuziqian211@users.noreply.github.com","commits":2,"url":"https://github.com/wuziqian211"},{"name":"SessionHu","username":"SessionHu","email":"102411014+SessionHu@users.noreply.github.com","commits":2,"url":"https://github.com/SessionHu"},{"name":"sheep-realms","username":"sheep-realms","email":"38580457+sheep-realms@users.noreply.github.com","commits":1,"url":"https://github.com/sheep-realms"}],"changelog":[{"hash":"bae574a1a944554956e627026bd5107d2e8a3d13","time":1768157682000,"email":"38580457+sheep-realms@users.noreply.github.com","author":"Sheep-realms","message":"更改一些视频相关字段的描述 (#1432)"},{"hash":"f6dc16f833b167bdf9c3e55a747983f21aae9431","time":1745165237000,"email":"102411014+SessionHu@users.noreply.github.com","author":"SessionHu","message":"chore: move docs/history&toview to docs/historytoview"},{"hash":"2a8fbd2eabcf7657c6ccf262dbbb3122298b1b39","time":1744422196000,"email":"102411014+SessionHu@users.noreply.github.com","author":"SessionHu","message":"feat: history dt 9"},{"hash":"41d73f1a20d856ffc5468243fbf17e5a35dc1a92","time":1726838526000,"email":"65224318+wuziqian211@users.noreply.github.com","author":"晨叶梦春","message":"feat: 添加消息中心接口相关说明 (#983)"},{"hash":"d04d4193be98bdf8c91addc6ef807385ac09831c","time":1710270147000,"email":"65224318+wuziqian211@users.noreply.github.com","author":"wuziqian211","message":"update"},{"hash":"92b30f354ab21b97fe52357161fd04e2ca687c97","time":1693842068000,"email":"catlair@qq.com","author":"LaMerChiang","message":"fix: 修正文档中存在的错误路径,标签和目录 (#806)"},{"hash":"f6760f4be38d5b592d396b211e48c666286524de","time":1677124138000,"email":"1440239038@qq.com","author":"SocialSisterYi","message":"🔨remove header index"},{"hash":"7d89ece2ac46425810647c4ac92acf5f3721cb68","time":1676998806000,"email":"1440239038@qq.com","author":"SocialSisterYi","message":"🚀调整项目结构"}]},"filePathRelative":"docs/historytoview/history.md"}');export{C as comp,v as data};