bilibili-API-collect/video/like_coin_fav.md

视频点赞&投币&收藏

本页所有操作均需登录（Cookie或APP）

操作

点赞视频（web端）

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

请求方式：POST

认证&鉴权方式：仅可Cookie

正文参数（ 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：请求错误 10003：不存在该稿件 65006：已赞过 65004：取消点赞失败
message	str	错误信息	默认为0
ttl	num	1	作用尚不明确

示例：

为视频av79677524/BV1uJ411r7hL点赞

avID方式：

curl 'http://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 'http://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
}

投币视频（web端）

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

请求方式：POST

认证&鉴权方式：仅可Cookie

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

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

json回复：

根对象：

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

data 对象：

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

示例：

为视频av90671873/BV1N7411A7wC投币2枚

avID方式：

curl 'http://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'

curl 'http://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
	}
}

收藏视频（暂不支持bvID）

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

请求方式：POST

需要验证referer为 .bilibili.com域名下

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

参数名	类型	内容	必要性	备注
rid	num	视频avID	必要
type	num	必须为2	必要
add_media_ids	nums	需要加入的收藏夹ID	非必要	同时添加多个，用,（%2C）分隔
del_media_ids	nums	需要取消的收藏夹ID	非必要	同时取消多个，用,（%2C）分隔
csrf	str	CSRF Token（位于cookie）	必要

json回复：

根对象：

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

data对象：

字段	类型	内容	备注
prompt	bool	false	作用尚不明确

示例：

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

curl 'http://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'

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

一键三连视频（web端）

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

请求方式：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：请求错误 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/BV1Wj411f79U一键三连

avID方式：

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

bvID方式：

curl 'http://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
	}
}

判断状态

视频是否被点赞

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

请求方式：GET

url参数：

参数名	类型	内容	必要性	备注
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 'http://api.bilibili.com/x/web-interface/archive/has/like'\
--data-urlencode 'aid=39330059'\
-b 'SESSDATA=xxx'

bvID方式：

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

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

视频是否被投币

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

请求方式：GET

url参数：

参数名	类型	内容	必要性	备注
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 'api.bilibili.com/x/web-interface/archive/coins'\
--data-urlencode 'aid=37896701'\
-b 'SESSDATA=xxx'

bvID方式：

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

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

视频是否被收藏

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

请求方式：GET

url参数：

参数名	类型	内容	必要性	备注
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 'http://api.bilibili.com/x/v2/fav/video/favoured'\
--data-urlencode 'aid=46281123'\
-b 'SESSDATA=xxx'

bvID方式：

curl -G 'http://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
	}
}