update: 新增播客声音搜索 #1814, bump to 4.13.3

CHANGELOG.MD

@@ -1,4 +1,7 @@
 # 更新日志
+### 4.13.3 | 2023.10.10
+- 添加播客声音搜索接口 #1814
+
 ### 4.13.2 | 2023.09.25
 - 修改wiki相关接口
 

README.MD

@@ -396,6 +396,16 @@ banner({ type:0 }).then(res=>{
 258. 验证接口-二维码检测
 259. 听歌识曲
 260. 根据nickname获取userid接口
+261. 播客声音列表
+262. 专辑简要百科信息
+263. 歌曲简要百科信息
+264. 歌手简要百科信息
+265. mv简要百科信息
+266. 搜索歌手
+267. 用户贡献内容
+268. 用户贡献条目、积分、云贝数量
+269. 年度听歌报告
+270. 播客声音搜索
 
 ## 更新日志
 

docs/README.md

@@ -285,6 +285,7 @@
 267. 用户贡献内容
 268. 用户贡献条目、积分、云贝数量
 269. 年度听歌报告
+270. 播客声音搜索
 
 ## 安装
 
@@ -4210,6 +4211,46 @@ ONLINE 已发布
 
 `offset`: 偏移数量 , 用于分页 , 如 :( 评论页数 -1)\*200, 其中 200 为 limit 的值
 
+### 播客声音搜索
+说明: 可以搜索播客里的声音
+
+**接口地址:** `/voicelist/list/search`
+
+**可选参数**  
+
+- 状态（非必填）：
+    - `displayStatus: null`（默认）：返回所有状态的声音
+    - `displayStatus: "ONLINE"`：已发布的声音
+    - `displayStatus: "AUDITING"`：审核中的声音
+    - `displayStatus: "ONLY_SELF_SEE"`：尽自己可见的声音
+    - `displayStatus: "SCHEDULE_PUBLISH"`：定时发布的声音
+    - `displayStatus: "TRANSCODE_FAILED"`：上传失败的声音
+    - `displayStatus: "PUBLISHING"`：发布中的声音
+    - `displayStatus: "FAILED"`：发布失败的声音
+
+- `limit: 20`：每次返回的声音数量（最多200个）
+
+- 搜索关键词：
+    - `name: null`：返回所有的声音
+    - `name: [关键词]`：返回包含指定关键词的声音文件
+
+- `offset: 0`：偏移量，用于分页，默认为0，表示从第一个声音开始获取
+
+- 博客：
+    - `radioId: null`：返回所有电台的声音
+    - `radioId: [播客id]`：返回特定播客的声音
+
+- 是否公开：
+    - `type: null`：返回所有类型的声音
+    - `type: "PUBLIC"`：返回公开的声音
+    - `type: "PRIVATE"`：返回隐私的声音
+
+- 是否付费：
+    - `voiceFeeType: null`（默认）：返回所有类型的声音
+    - `voiceFeeType: -1`：返回所有类型的声音
+    - `voiceFeeType: 0`：返回免费的声音
+    - `voiceFeeType: 1`：返回收费的声音
+
 ### 播客声音详情
 
 说明: 获取播客里的声音详情

interface.d.ts

@@ -1795,3 +1795,15 @@ export function get_userids(
     nicknames: string
   } & RequestBaseConfig,
 ): Promise<Response>
+
+export function voicelist_list_search(
+  params: {
+    limit?: string | number
+    offset?: string | number
+    name?: string
+    displayStatus?: string
+    type?: string
+    voiceFeeType?: string | number
+    radioId?: string
+  } & RequestBaseConfig,
+): Promise<Response>

module/voicelist_list_search.js

@@ -0,0 +1,23 @@
+//声音搜索
+module.exports = (query, request) => {
+  const data = {
+    limit: query.limit || '200',
+    offset: query.offset || '0',
+    name: query.name || null,
+    displayStatus: query.displayStatus || null,
+    type: query.type || null,
+    voiceFeeType: query.voiceFeeType || null,
+    radioId: query.voiceListId,
+  }
+  return request(
+    'POST',
+    'https://interface.music.163.com/api/voice/workbench/voice/list',
+    data,
+    {
+      crypto: 'weapi',
+      cookie: query.cookie,
+      proxy: query.proxy,
+      realIP: query.realIP,
+    },
+  )
+}

package.json

@@ -1,6 +1,6 @@
 {
   "name": "NeteaseCloudMusicApi",
-  "version": "4.13.2",
+  "version": "4.13.3",
   "description": "网易云音乐 NodeJS 版 API",
   "scripts": {
     "start": "node app.js",