bilibili-API-collect/video/report.md

视频观看数据上报

• 上报观看进度（双端）
• 上报视频播放心跳（web端）

---

上报观看进度（双端）

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

请求方式：POST

认证方式：APP或Cookie（SESSDATA）

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

参数名	类型	内容	必要性	备注
access_key	str	APP登录Token	APP方式必要
aid	num	稿件avid	必要
cid	num	视频cid	必要	用于识别分P
progress	num	观看进度	非必要	单位为秒 默认为0
platform	str	平台标识	非必要	可为android
csrf	str	CSRF Token（位于cookie）	Cookie方式必要

json回复：

根对象：

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

示例：

记录视频av13662970（cid=126654047）的观看记录位于1248秒

Cookie方式：

curl 'https://api.bilibili.com/x/v2/history/report' \
--data-urlencode 'aid=13662970' \
--data-urlencode 'cid=126654047' \
--data-urlencode 'progress=1248' \
--data-urlencode 'platform=android' \
--data-urlencode 'csrf=xxx' \
-b 'SESSDATA=xxx'

APP方式：

curl 'https://api.bilibili.com/x/v2/history/report' \
--data-urlencode 'access_key=xxx' \
--data-urlencode 'aid=13662970' \
--data-urlencode 'cid=126654047' \
--data-urlencode 'progress=1248' \
--data-urlencode 'platform=android'

查看响应示例：

{
    "code": 0,
    "message": "0",
    "ttl": 1
}

上报视频播放心跳（web端）

https://api.bilibili.com/x/click-interface/web/heartbeat

请求方式：POST

认证方式：仅可Cookie（SESSDATA）

默认间隔15秒一次

亦可记录播放历史

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

参数名	类型	内容	必要性	备注
aid	num	稿件avid	必要（可选）	avid与bvid任选一个
bvid	str	稿件bvid	必要（可选）	avid与bvid任选一个
cid	num	视频cid	非必要	用于识别分P
epid	num	番剧epid	非必要
sid	num	番剧ssid	非必要
mid	num	当前用户mid	非必要
played_time	num	视频播放进度	非必要	单位为秒 默认为0
realtime	num	总计播放时间	非必要	单位为秒
start_ts	num	开始播放时刻	非必要	时间戳
type	num	视频类型	非必要	3：投稿视频 4：剧集 10：课程
sub_type	num	剧集副类型	非必要	当type=4时本参数有效 1：番剧 2：电影 3：纪录片 4：国创 5：电视剧 7：综艺
dt	num	2	非必要
play_type	num	播放动作	非必要	0：播放中 1：开始播放 2：暂停 3：继续播放
csrf	str	CSRF Token（位于cookie）	非必要

json回复：

根对象：

字段	类型	内容	备注
code	num	返回值	0：成功 -400：请求错误
message	str	错误信息	默认为0
ttl	num	1

示例：

上报一次视频av2/BV1xx411c7mD的心跳数据

curl 'api.bilibili.com/x/click-interface/web/heartbeat' \
--data-urlencode 'aid=2' \
--data-urlencode 'bvid=BV1xx411c7mD' \
--data-urlencode 'cid=62131' \
--data-urlencode 'played_time=60' \
--data-urlencode 'realtime=60' \
--data-urlencode 'start_ts=1592720840' \
--data-urlencode 'type=3' \
--data-urlencode 'dt=2' \
--data-urlencode 'play_type=0' \
--data-urlencode 'csrf=xxx' \
-b 'SESSDATA=xxx'

查看响应示例：

{
    "code": 0,
    "message": "0",
    "ttl": 1
}