# 视频点赞&投币&收藏&分享 ## 点赞 ### 点赞视频(web端) > https://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方式: ```shell 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方式: ```shell 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' ```
查看响应示例: ```json { "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:请求错误
10003:不存在该稿件 | | message | str | 错误信息 | 默认为0 | | ttl | num | 1 | | | data | obj | 数据本体 | | `data`对象: | 字段 | 类型 | 内容 | 备注 | | ----- | ---- | ------------ | ---- | | toast | str | 提示信息内容 | | **示例:** 点赞视频`av79677524` ```shell curl 'https://app.bilibili.com/x/v2/view/like' \ --data-urlencode 'access_key=xxx' \ --data-urlencode 'aid=79677524' \ --data-urlencode 'like=0' ```
查看响应示例: ```json { "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方式: ```shell curl -G 'https://api.bilibili.com/x/web-interface/archive/has/like' \ --data-urlencode 'aid=39330059' \ -b 'SESSDATA=xxx' ``` bvid方式: ```shell curl -G 'https://api.bilibili.com/x/web-interface/archive/has/like' \ --data-urlencode 'bvid=BV1Bt411z799' \ -b 'SESSDATA=xxx' ```
查看响应示例: ```json { "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 | | **示例:** 点踩视频 ```shell 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' ``` 取消点踩 ```shell 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) **正文参数( 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方式: ```shell 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方式: ```shell 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' ```
查看响应示例: ```json { "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枚 ```shell 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' ```
查看响应示例: ```json { "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方式: ```shell curl -G 'https://api.bilibili.com/x/web-interface/archive/coins' \ --data-urlencode 'aid=37896701' \ -b 'SESSDATA=xxx' ``` bvid方式: ```shell curl -G 'https://api.bilibili.com/x/web-interface/archive/coins' \ --data-urlencode 'bvid=BV18t411q7zz' \ -b 'SESSDATA=xxx' ```
查看响应示例: ```json { "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方式: ```shell 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方式: ```shell 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=' ```
查看响应示例: ```json { "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方式: ```shell curl -G 'https://api.bilibili.com/x/v2/fav/video/favoured' \ --data-urlencode 'aid=46281123' \ -b 'SESSDATA=xxx' ``` bvid方式: ```shell curl -G 'https://api.bilibili.com/x/v2/fav/video/favoured' \ --data-urlencode 'aid=BV1Bb411H7Dv' \ -b 'SESSDATA=xxx' ```
查看响应示例: ```json { "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) 同时点赞投币收藏视频,收藏于默认收藏夹中 **正文参数( 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方式: ```shell curl 'https://api.bilibili.com/x/web-interface/archive/like/triple' \ --data-urlencode 'aid=91003840' \ --data-urlencode 'csrf=xxx' \ -b 'SESSDATA=xxx' ``` bvid方式: ```shell curl 'https://api.bilibili.com/x/web-interface/archive/like/triple' \ --data-urlencode 'bvid=BV1Wj411f79U' \ --data-urlencode 'csrf=xxx' \ -b 'SESSDATA=xxx' ```
查看响应示例: ```json { "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`一键三连 ```shell curl 'https://app.bilibili.com/x/v2/view/like/triple' \ --data-urlencode 'access_key=xxx' \ --data-urlencode 'aid=91003840' ```
查看响应示例: ```json { "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` ```shell curl 'https://api.bilibili.com/x/web-interface/share/add' \ --data-urlencode 'csrf=xxx' \ --data-urlencode 'bvid=BV1oA411776z' ```
查看响应示例: ```json { "code":0, "message":"0", "ttl":1, "data":19 } ```