mirror of https://github.com/SocialSisterYi/bilibili-API-collect.git synced 2024-12-27 13:00:29 +08:00

* 修复某些表格全角&半角符号不分 (#838)

* Update precious_videos.md

* Update manage.md

* 修复部分视频无法投币,点赞，收藏问题，增加鉴权参数

* 修改【稿件观众操作】APIDoc

---------

Co-authored-by: LaMerChiang <catlair@qq.com>
Co-authored-by: djeozhang <djeozhang@tencent.com>
Co-authored-by: SocialSisterYi <1440239038@qq.com>

2023-12-22 16:07:37 +08:00

28 KiB

Raw Blame History

稿件观众操作

点赞视频（web端）

https://api.bilibili.com/x/web-interface/archive/like

请求方式：POST

认证方式：仅可Cookie（SESSDATA）

需验证 Cookie 中buvid3字段存在且正常, 否则将导致触发风控

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

参数名	类型	内容	必要性	备注
aid	num	稿件 avid	必要（可选）	avid 与 bvid 任选一个
bvid	str	稿件 bvid	必要（可选）	avid 与 bvid 任选一个
like	num	操作方式	必要	1：点赞 2：取消赞
csrf	str	CSRF Token（位于 Cookie）	必要

json回复：

根对象：

字段	类型	内容	备注
code	num	返回值	0：成功 -101：账号未登录 -111：csrf校验失败 -400：请求错误 -403: 账号异常 10003：不存在该稿件 65004：取消点赞失败 65006：重复点赞
message	str	错误信息	默认为0
ttl	num	1

示例：

点赞视频av79677524/BV1uJ411r7hL

avid方式：

curl 'https://api.bilibili.com/x/web-interface/archive/like' \
--data-urlencode 'aid=79677524' \
--data-urlencode 'like=1' \
--data-urlencode 'csrf=xxx' \
-b 'SESSDATA=xxx'

bvid方式：

curl 'https://api.bilibili.com/x/web-interface/archive/like' \
--data-urlencode 'bvid=BV1uJ411r7hL' \
--data-urlencode 'like=1' \
--data-urlencode 'csrf=xxx' \
-b 'SESSDATA=xxx'

查看响应示例：

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

点赞视频（APP端）

https://app.bilibili.com/x/v2/view/like

请求方式：POST

认证方式：仅可APP

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

参数名	类型	内容	必要性	备注
access_key	str	APP 登录 Token	APP 方式必要
aid	num	稿件 avid	必要
like	num	操作方式	必要	0：点赞 1：取消赞

json回复：

根对象：

字段	类型	内容	备注
code	num	返回值	0：成功 -101：账号未登录 -400：请求错误 -403: 账号异常 10003：不存在该稿件
message	str	错误信息	默认为0
ttl	num	1
data	obj	数据本体

data对象：

字段	类型	内容	备注
toast	str	提示信息内容

示例：

点赞视频av79677524

curl 'https://app.bilibili.com/x/v2/view/like' \
--data-urlencode 'access_key=xxx' \
--data-urlencode 'aid=79677524' \
--data-urlencode 'like=0'

查看响应示例：

{
    "code": 0,
    "message": "0",
    "ttl": 1,
    "data": {
        "toast": "点赞收到！视频可能推荐哦"
    }
}

判断视频是否被点赞（双端）

https://api.bilibili.com/x/web-interface/archive/has/like

请求方式：GET

认证方式：APP或Cookie（SESSDATA）

url参数：

参数名	类型	内容	必要性	备注
access_key	str	APP 登录 Token	APP 方式必要
aid	num	稿件 avid	必要（可选）	avid 与 bvid 任选一个
bvid	str	稿件 bvid	必要（可选）	avid 与 bvid 任选一个

json回复：

根对象：

字段	类型	内容	备注
code	num	返回值	0：成功 -400：请求错误 -101：账号未登录
message	str	错误信息	默认为0
ttl	num	1
data	num	被点赞标志	0：未点赞 1：已点赞

示例：

视频av39330059/BV1Bt411z799的状态为已点赞

avid方式：

curl -G 'https://api.bilibili.com/x/web-interface/archive/has/like' \
--data-urlencode 'aid=39330059' \
-b 'SESSDATA=xxx'

bvid方式：

curl -G 'https://api.bilibili.com/x/web-interface/archive/has/like' \
--data-urlencode 'bvid=BV1Bt411z799' \
-b 'SESSDATA=xxx'

查看响应示例：

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

点踩

点踩视频（App端）

https://app.biliapi.net/x/v2/view/dislike

请求方式：POST

认证方式：仅可App

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

参数名	类型	内容	必要性	备注
access_key	str	APP 登录 Token	必要
aid	num	视频 aid	必要
dislike	num	操作类型	必要	0：点踩 1：取消点踩

json回复：

字段	类型	内容	备注
code	num	返回值	0：成功 -101：账号未登录 -400：请求错误 -404：啥都木有 65005：取消踩失败未点踩过 65007：已踩过
message	str	错误信息	默认为0
ttl	num	1

示例：

点踩视频

curl -L -X POST 'https://app.biliapi.net/x/v2/view/dislike' \
-H 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'access_key=xxx' \
--data-urlencode 'aid=xxx' \
--data-urlencode 'dislike=0'

取消点踩

curl -L -X POST 'https://app.biliapi.net/x/v2/view/dislike' \
-H 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'access_key=xxx' \
--data-urlencode 'aid=xxx' \
--data-urlencode 'dislike=1'

投币

投币视频（web端）

https://api.bilibili.com/x/web-interface/coin/add

请求方式：POST

认证方式：仅可Cookie（SESSDATA）

需验证 Cookie 中buvid3字段存在且正常, 否则将导致触发风控

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

参数名	类型	内容	必要性	备注
aid	num	稿件 avid	必要（可选）	avid 与 bvid 任选一个
bvid	str	稿件 bvid	必要（可选）	avid 与 bvid 任选一个
multiply	num	投币数量	必要	上限为2
select_like	num	是否附加点赞	非必要	0：不点赞 1：同时点赞默认为0
csrf	str	CSRF Token（位于 Cookie）	必要

json回复：

根对象：

字段	类型	内容	备注
code	num	返回值	0：成功 -101：账号未登录 -102：账号被封停 -104：硬币不足 -111：csrf校验失败 -400：请求错误 -403: 账号异常 10003：不存在该稿件 34002：不能给自己投币 34003：非法的投币数量 34004：投币间隔太短 34005：超过投币上限
message	str	错误信息	默认为0
ttl	num	1
data	obj	信息本体

data 对象：

字段	类型	内容	备注
like	bool	是否点赞成功	true：成功 false：失败已赞过则附加点赞失败

示例：

为视频av90671873/BV1N7411A7wC投币2枚

avid方式：

curl 'https://api.bilibili.com/x/web-interface/coin/add' \
--data-urlencode 'aid=90671873' \
--data-urlencode 'select_like=1' \
--data-urlencode 'multiply=2' \
--data-urlencode 'csrf=xxx' \
-b 'SESSDATA=xxx'

bvid方式：

curl 'https://api.bilibili.com/x/web-interface/coin/add' \
--data-urlencode 'bvid=BV1N7411A7wC' \
--data-urlencode 'select_like=1' \
--data-urlencode 'multiply=2' \
--data-urlencode 'csrf=xxx' \
-b 'SESSDATA=xxx'

查看响应示例：

{
	"code": 0,
	"message": "0",
	"ttl": 1,
	"data": {
		"like": true
	}
}

投币视频（APP端）

https://app.bilibili.com/x/v2/view/coin/add

请求方式：POST

认证方式：仅可APP

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

参数名	类型	内容	必要性	备注
access_key	str	APP 登录 Token	APP 方式必要
aid	num	稿件 avid	必要
multiply	num	投币数量	必要	上限为2
select_like	num	附加点赞	非必要	0：不点赞 1：同时点赞默认为0

json回复：

根对象：

字段	类型	内容	备注
code	num	返回值	0：成功 -101：账号未登录 -102：账号被封停 -104：硬币不足 -400：请求错误 10003：不存在该稿件 34002：不能给自己投币 34003：非法的投币数量 34004：投币间隔太短 34005：超过投币上限
message	str	错误信息	默认为0
ttl	num	1
data	obj	信息本体

data 对象：

字段	类型	内容	备注
like	bool	是否点赞成功	true：成功 false：失败已赞过则附加点赞失败

为视频av90671873投币2枚

curl 'https://app.bilibili.com/x/v2/view/coin/add' \
--data-urlencode 'access_key=xxx' \
--data-urlencode 'aid=90671873' \
--data-urlencode 'select_like=1' \
--data-urlencode 'multiply=2'

查看响应示例：

{
	"code": 0,
	"message": "0",
	"ttl": 1,
	"data": {
		"like": true
	}
}

判断视频是否被投币（双端）

https://api.bilibili.com/x/web-interface/archive/coins

请求方式：GET

认证方式：APP或Cookie（SESSDATA）

url参数：

参数名	类型	内容	必要性	备注
access_key	str	APP 登录 Token	APP方式必要
aid	num	稿件 avid	必要（可选）	avid 与 bvid 任选一个
bvid	str	稿件 bvid	必要（可选）	avid 与 bvid 任选一个

json回复：

根对象：

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

data对象：

字段	类型	内容	备注
multiply	num	投币枚数	未投币为0

示例：

视频av37896701/BV18t411q7zz的投币数为2枚

avid方式：

curl -G 'https://api.bilibili.com/x/web-interface/archive/coins' \
--data-urlencode 'aid=37896701' \
-b 'SESSDATA=xxx'

bvid方式：

curl -G 'https://api.bilibili.com/x/web-interface/archive/coins' \
--data-urlencode 'bvid=BV18t411q7zz' \
-b 'SESSDATA=xxx'

查看响应示例：

{
	"code": 0,
	"message": "0",
	"ttl": 1,
	"data": {
		"multiply": 2
	}
}

收藏视频（双端）

https://api.bilibili.com/medialist/gateway/coll/resource/deal

https://api.bilibili.com/x/v3/fav/resource/deal

请求方式：POST

认证方式：APP或Cookie（SESSDATA）

鉴权方式：Cookie方式时需要验证referer为 .bilibili.com域名下

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

参数名	类型	内容	必要性	备注
access_key	str	APP 登录 Token	APP 方式必要
rid	num	稿件 avid	必要
type	num	必须为2	必要
add_media_ids	nums	需要加入的收藏夹 mlid	非必要	同时添加多个，用`,`（%2C）分隔
del_media_ids	nums	需要取消的收藏夹 mlid	非必要	同时取消多个，用`,`（%2C）分隔
csrf	str	CSRF Token（位于 Cookie）	Cookie 方式必要

json回复：

根对象：

字段	类型	内容	备注
code	num	返回值	0：成功 -101：账号未登录 -111：csrf校验失败 -400：请求错误 -403：访问权限不足 10003：不存在该稿件 11201：已经收藏过了 11202：已经取消收藏了 11203：达到收藏上限 72010017：参数错误
message	str	错误信息	正确为success
data	obj	信息本体

data对象：

字段	类型	内容	备注
prompt	bool	是否为未关注用户收藏	false：否 true：是

示例：

将视频av49166435添加到收藏夹49166435中

Cookie方式：

curl 'https://api.bilibili.com/medialist/gateway/coll/resource/deal' \
--data-urlencode 'rid=90671873' \
--data-urlencode 'type=2' \
--data-urlencode 'add_media_ids=49166435' \
--data-urlencode 'del_media_ids=' \
--data-urlencode 'csrf=xxx' \
-b 'SESSDATA=xxx' \
-e 'https://www.bilibili.com'

APP方式：

curl 'https://api.bilibili.com/medialist/gateway/coll/resource/deal' \
--data-urlencode 'access_key=xxx' \
--data-urlencode 'rid=90671873' \
--data-urlencode 'type=2' \
--data-urlencode 'add_media_ids=49166435' \
--data-urlencode 'del_media_ids='

查看响应示例：

{
	"code": 0,
	"data": {
		"prompt": false
	},
	"message": "success"
}

判断视频是否被收藏（双端）

https://api.bilibili.com/x/v2/fav/video/favoured

请求方式：GET

认证方式：APP或Cookie（SESSDATA）

url参数：

参数名	类型	内容	必要性	备注
access_key	str	APP 登录 Token	APP 方式必要
aid	num 或 str	稿件 avid 或稿件 bvid	必要

json回复：

根对象：

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

data 对象：

字段	类型	内容	备注
count	num	1	作用尚不明确
favoured	bool	是否收藏	true：已收藏 false：未收藏

示例：

视频av46281123/BV1Bb411H7Dv的状态为已收藏

avid方式：

curl -G 'https://api.bilibili.com/x/v2/fav/video/favoured' \
--data-urlencode 'aid=46281123' \
-b 'SESSDATA=xxx'

bvid方式：

curl -G 'https://api.bilibili.com/x/v2/fav/video/favoured' \
--data-urlencode 'aid=BV1Bb411H7Dv' \
-b 'SESSDATA=xxx'

查看响应示例：

{
	"code": 0,
	"message": "0",
	"ttl": 1,
	"data": {
		"count": 1,
		"favoured": true
	}
}

一键三连

一键三连视频（web端）

https://api.bilibili.com/x/web-interface/archive/like/triple

请求方式：POST

认证方式：仅可Cookie（SESSDATA）

同时点赞投币收藏视频，收藏于默认收藏夹中

需验证 Cookie 中buvid3字段存在且正常, 否则将导致触发风控

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

参数名	类型	内容	必要性	备注
aid	num	稿件 avid	必要（可选）	avid 与 bvid 任选一个
bvid	str	稿件 bvid	必要（可选）	avid 与 bvid 任选一个
csrf	str	CSRF Token（位于 Cookie）	必要

json回复：

根对象：

字段	类型	内容	备注
code	num	返回值	0：成功 -101：账号未登录 -111：csrf校验失败 -400：请求错误 10003：不存在该稿件 -403: 账号异常
message	str	错误信息	默认为0
ttl	num	1
data	obj	信息本体

data对象：

字段	类型	内容	备注
like	bool	是否点赞成功	true：成功 false：失败
coin	bool	是否投币成功	true：成功 false：失败
fav	bool	是否收藏成功	true：成功 false：失败
multiply	num	投币枚数	默认为2

示例：

将视频av91003840/BV1Wj411f79U一键三连

avid方式：

curl 'https://api.bilibili.com/x/web-interface/archive/like/triple' \
--data-urlencode 'aid=91003840' \
--data-urlencode 'csrf=xxx' \
-b 'SESSDATA=xxx'

bvid方式：

curl 'https://api.bilibili.com/x/web-interface/archive/like/triple' \
--data-urlencode 'bvid=BV1Wj411f79U' \
--data-urlencode 'csrf=xxx' \
-b 'SESSDATA=xxx'

查看响应示例：

{
	"code": 0,
	"message": "0",
	"ttl": 1,
	"data": {
		"like": true,
		"coin": true,
		"fav": true,
		"multiply": 2
	}
}

一键三连视频（APP端）

https://app.bilibili.com/x/v2/view/like/triple

请求方式：POST

认证方式：仅可APP

同时点赞投币收藏视频，收藏于默认收藏夹中

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

参数名	类型	内容	必要性	备注
access_key	str	APP 登录 Token	APP 方式必要
aid	num	稿件 avid	必要

json回复：

根对象：

字段	类型	内容	备注
code	num	返回值	0：成功 -101：账号未登录 -400：请求错误 10003：不存在该稿件
message	str	错误信息	默认为0
ttl	num	1
data	obj	信息本体

data对象：

字段	类型	内容	备注
like	bool	是否点赞成功	true：成功 false：失败
coin	bool	是否投币成功	true：成功 false：失败
fav	bool	是否收藏成功	true：成功 false：失败
multiply	num	投币枚数	默认为2

示例：

将视频av91003840一键三连

curl 'https://app.bilibili.com/x/v2/view/like/triple' \
--data-urlencode 'access_key=xxx' \
--data-urlencode 'aid=91003840'

查看响应示例：

{
	"code": 0,
	"message": "0",
	"ttl": 1,
	"data": {
		"like": true,
		"coin": true,
		"fav": true,
		"multiply": 2
	}
}

分享视频（Web端）

https://api.bilibili.com/x/web-interface/share/add

请求方式：POST

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

参数名	类型	内容	必要性	备注
aid	num	稿件 avid	必要（可选）	avid 与 bvid 任选一个
bvid	str	稿件 bvid	必要（可选）	avid 与 bvid任选一个
csrf	str	CSRF Token（位于 Cookie）	必要

json回复：

根对象：

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

示例：

分享视频BV1oA411776z

curl 'https://api.bilibili.com/x/web-interface/share/add' \
--data-urlencode 'csrf=xxx' \
--data-urlencode 'bvid=BV1oA411776z'

查看响应示例：

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

28 KiB Raw Blame History Unescape Escape

稿件观众操作

点赞

点赞视频（web端）

点赞视频（APP端）

判断视频是否被点赞（双端）

点踩

点踩视频（App端）

投币

投币视频（web端）

投币视频（APP端）

判断视频是否被投币（双端）

收藏

收藏视频（双端）

判断视频是否被收藏（双端）

一键三连

一键三连视频（web端）

一键三连视频（APP端）

分享

分享视频 （Web端）

28 KiB

Raw Blame History

分享视频（Web端）