bilibili-API-collect/video/like_coin_fav.md

视频点赞&投币&收藏&分享

• 点赞
  • 点赞视频（web端）
  • 点赞视频（APP端）
  • 判断视频是否被点赞（双端）
• 投币
  • 投币视频（web端）
  • 投币视频（APP端）
  • 判断视频是否被投币（双端）
• 收藏
  • 收藏视频（双端）
  • 判断视频是否被收藏（双端）
• 一键三连
  • 一键三连视频（web端）
  • 一键三连视频（APP端）
• 分享
  • [分享视频 （Web端）](#分享视频 （Web端）)

---

点赞

点赞视频（web端）

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

请求方式：POST

认证方式：仅可Cookie（SESSDATA）

正文参数（ 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：不存在该稿件 65004：取消点赞失败 65006：重复点赞
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
}

点赞视频（APP端）

http://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：请求错误 10003：不存在该稿件
message	str	错误信息	默认为0
ttl	num	1
data	obj	数据本体

data对象：

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

示例：

点赞视频av79677524

curl 'http://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": "点赞收到！视频可能推荐哦"
    }
}

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

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

投币

投币视频（web端）

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

请求方式：POST

认证方式：仅可Cookie（SESSDATA）

正文参数（ 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：请求错误 10003：不存在该稿件 34002：不能给自己投币 34003：非法的投币数量 34004：投币间隔太短 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'

bvID方式：

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
	}
}

投币视频（APP端）

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

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

http://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 '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/medialist/gateway/coll/resource/deal

http://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	需要加入的收藏夹ID	非必要	同时添加多个，用,（%2C）分隔
del_media_ids	nums	需要取消的收藏夹ID	非必要	同时取消多个，用,（%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 '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'

APP方式：

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

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

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

一键三连

一键三连视频（web端）

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

请求方式：POST

认证方式：仅可Cookie（SESSDATA）

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

正文参数（ 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
	}
}

一键三连视频（APP端）

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

认证方式 csrf token

正文参数（ 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 'http://api.bilibili.com/x/web-interface/share/add' \
--data-urlencode 'csrf=xxx' \
--data-urlencode 'bvid=BV1oA411776z'

查看响应示例：

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