稿件观众操作

点赞

点赞视频(web端)

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

请求方式:POST

认证方式:仅可Cookie(SESSDATA)

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

正文参数( application/x-www-form-urlencoded ):

参数名类型内容必要性备注
aidnum稿件 avid必要(可选)avid 与 bvid 任选一个
bvidstr稿件 bvid必要(可选)avid 与 bvid 任选一个
likenum操作方式必要1:点赞
2:取消赞
csrfstrCSRF Token(位于 Cookie)必要

json回复:

根对象:

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

示例:

点赞视频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_keystrAPP 登录 TokenAPP 方式必要
aidnum稿件 avid必要
likenum操作方式必要0:点赞
1:取消赞

json回复:

根对象:

字段类型内容备注
codenum返回值0:成功
-101:账号未登录
-400:请求错误
-403: 账号异常
10003:不存在该稿件
messagestr错误信息默认为0
ttlnum1
dataobj数据本体

data对象:

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

示例:

点赞视频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_keystrAPP 登录 TokenAPP 方式必要
aidnum稿件 avid必要(可选)avid 与 bvid 任选一个
bvidstr稿件 bvid必要(可选)avid 与 bvid 任选一个

json回复:

根对象:

字段类型内容备注
codenum返回值0:成功
-400:请求错误
-101:账号未登录
messagestr错误信息默认为0
ttlnum1
datanum被点赞标志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_keystrAPP 登录 Token必要
aidnum视频 aid必要
dislikenum操作类型必要0:点踩
1:取消点踩

json回复:

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

示例:

点踩视频

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

参数名类型内容必要性备注
aidnum稿件 avid必要(可选)avid 与 bvid 任选一个
bvidstr稿件 bvid必要(可选)avid 与 bvid 任选一个
multiplynum投币数量必要上限为2
select_likenum是否附加点赞非必要0:不点赞
1:同时点赞
默认为0
csrfstrCSRF Token(位于 Cookie)必要

json回复:

根对象:

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

data 对象:

字段类型内容备注
likebool是否点赞成功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_keystrAPP 登录 TokenAPP 方式必要
aidnum稿件 avid必要
multiplynum投币数量必要上限为2
select_likenum附加点赞非必要0:不点赞
1:同时点赞
默认为0

json回复:

根对象:

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

data 对象:

字段类型内容备注
likebool是否点赞成功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_keystrAPP 登录 TokenAPP方式必要
aidnum稿件 avid必要(可选)avid 与 bvid 任选一个
bvidstr稿件 bvid必要(可选)avid 与 bvid 任选一个

json回复:

根对象:

字段类型内容备注
codenum返回值0:成功
-400:请求错误
-101:账号未登录
messagestr错误信息默认为0
ttlnum1
dataobj信息本体

data对象:

字段类型内容备注
multiplynum投币枚数未投币为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_keystrAPP 登录 TokenAPP 方式必要
ridnum稿件 avid必要
typenum必须为2必要
add_media_idsnums需要加入的收藏夹 mlid非必要同时添加多个,用,(%2C)分隔
del_media_idsnums需要取消的收藏夹 mlid非必要同时取消多个,用,(%2C)分隔
csrfstrCSRF Token(位于 Cookie)Cookie 方式必要

json回复:

根对象:

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

data对象:

字段类型内容备注
promptbool是否为未关注用户收藏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_keystrAPP 登录 TokenAPP 方式必要
aidnum 或 str稿件 avid 或稿件 bvid必要

json回复:

根对象:

字段类型内容备注
codenum返回值0:成功
-400:请求错误
-101:账号未登录
messagestr错误信息默认为0
ttlnum1
dataobj信息本体

data 对象:

字段类型内容备注
countnum1作用尚不明确
favouredbool是否收藏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 ):

参数名类型内容必要性备注
aidnum稿件 avid必要(可选)avid 与 bvid 任选一个
bvidstr稿件 bvid必要(可选)avid 与 bvid 任选一个
csrfstrCSRF Token(位于 Cookie)必要

json回复:

根对象:

字段类型内容备注
codenum返回值0:成功
-101:账号未登录
-111:csrf校验失败
-400:请求错误
10003:不存在该稿件
-403: 账号异常
messagestr错误信息默认为0
ttlnum1
dataobj信息本体

data对象:

字段类型内容备注
likebool是否点赞成功true:成功
false:失败
coinbool是否投币成功true:成功
false:失败
favbool是否收藏成功true:成功
false:失败
multiplynum投币枚数默认为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_keystrAPP 登录 TokenAPP 方式必要
aidnum稿件 avid必要

json回复:

根对象:

字段类型内容备注
codenum返回值0:成功
-101:账号未登录
-400:请求错误
10003:不存在该稿件
messagestr错误信息默认为0
ttlnum1
dataobj信息本体

data对象:

字段类型内容备注
likebool是否点赞成功true:成功
false:失败
coinbool是否投币成功true:成功
false:失败
favbool是否收藏成功true:成功
false:失败
multiplynum投币枚数默认为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 ):

参数名类型内容必要性备注
aidnum稿件 avid必要(可选)avid 与 bvid 任选一个
bvidstr稿件 bvid必要(可选)avid 与 bvid任 选一个
csrfstrCSRF Token(位于 Cookie)必要

json回复:

根对象:

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

示例:

分享视频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
}