小程序-云音乐
  1. 搜索
小程序-云音乐
  • 使用须知
  • 首页中心
    • 榜单
      • 获取所有榜单
      • 根据榜单的ID获取榜单
    • 歌单
      • 获取推荐歌单
      • 获取歌单中所有歌曲
      • 获取歌单详情
      • 获取歌单详情动态
      • 获取歌单分类
      • 获取热门歌单分类
      • 根据歌单分类获取歌单( 网友精选碟 )
      • 收藏/取消收藏歌单
    • 电台
      • 获取热门电台
      • 获取推荐电台
      • 获取电台今日优选电台
      • 获取电台分类
      • 根据分类id获取热门电台列表
      • 获取电台详情
      • 获取电台节目列表
      • 订阅电台
    • 搜索
      • 获取默认搜索关键词
        GET
      • 获取热搜列表(简略)
        GET
      • 获取热搜列表(详细)
        GET
      • 根据关键字进行搜索
        GET
      • 获取搜索建议
        GET
    • 获取轮播图
      GET
    • 获取每日推荐歌曲
      POST
  • 登录
    • 二维码登录
      • 二维码 key 生成
      • 根据key生成二维码
      • 检测二维码扫码状态
    • 游客登录
      GET
    • 退出登录
      GET
  • 个人中心
    • 获取用户信息
      • 根据id获取用户信息
      • 获取用户信息 , 歌单,收藏,mv, dj 数量
      • 获取账号信息
      • 获取用户等级信息
      • 获取登录状态
    • 歌单
      • 获取用户歌单
    • 最近播放
      • 最近播放-歌曲
      • 最近播放-视频
      • 最近播放-歌单
      • 最近播放-专辑
      • 最近播放-播客
      • 最近播放-声音
      • 将 mlog id 转为视频 id
    • 我的收藏
      • 获取收藏的专辑
      • 获取收藏的mv
      • 获取点赞过的视频
      • 获取我收藏的电台
    • 更新用户信息
      • 更新用户信息
      • 可更新头像
  • 视频中心
    • mv
      • 获取全部 mv
      • 获取推荐的mv
      • 获取 mv 数据
      • 获取 mv 点赞转发评论数数据
      • 获取 mv 播放地址
    • 视频
      • 获取推荐的视频
      • 获取全部视频列表
      • 获取视频详情
      • 获取视频点赞转发评论数数据
      • 获取视频播放地址
      • 获取视频标签列表
      • 获取视频标签/分类下的视频
  • 通用
    • 歌曲
      • 歌曲详情字段说明
      • 获取歌曲url
      • 喜欢音乐
      • 获取喜欢音乐列表
    • 歌词
      • 获取歌曲的歌词
      • 获取歌曲的逐字歌词
    • 评论
      • 获取资源评论
      • 获取楼层评论
      • 给评论点赞
      • 发送/删除评论
    • 收藏资源
      • 收藏视频
      • 收藏 MV
      • 收藏歌单
      • 收藏专辑
    • 歌单
      • 歌单添加或删除歌曲
      • 新建歌单
      • 删除歌单
    • 点赞资源(歌曲,歌单,MV,电台,视频)
      POST
    • 心动模式/智能播放
      POST
  1. 搜索

根据关键字进行搜索

开发中
GET
/search
调用此接口 , 传入搜索关键词可以搜索该音乐 / 专辑 / 歌手 / 歌单 / 用户 , 关键词可以多个 , 以空格隔开 , 如 " 周杰伦 搁浅 "( 不需要登录 ), 可通过 /song/url 接口传入歌曲 id 获取具体的播放链接
必选参数 : keywords : 关键词
可选参数 : limit : 返回数量 , 默认为 30 offset : 偏移数量,用于分页 , 如 : 如 :( 页数 -1)*30, 其中 30 为 limit 的值 , 默认为 0
type: 搜索类型;默认为 1 即单曲 , 取值意义 : 1: 单曲, 10: 专辑, 100: 歌手, 1000: 歌单, 1002: 用户, 1004: MV, 1006: 歌词, 1009: 电台, 1014: 视频, 1018:综合, 2000:声音(搜索声音返回字段格式会不一样)
接口地址 : /search 或者 /cloudsearch(更全)

请求参数

Query 参数
keywords
string 
可选
示例值:
海阔天空
type
string 
可选
示例值:
1
limit 
string 
可选
示例值:
30
offset 
string 
可选
示例值:
0

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request GET 'http://127.0.0.1:3000/search?keywords=海阔天空&type=1&limit =30 &offset =0'

返回响应

🟢200成功
application/json
Body
result
object 
必需
songs
array [object {15}] 
必需
hasMore
boolean 
必需
songCount
integer 
必需
code
integer 
必需
示例
{
    "result": {
        "songs": [
            {
                "id": 1357374736,
                "name": "海阔天空",
                "artists": [
                    {
                        "id": 11127,
                        "name": "Beyond",
                        "picUrl": null,
                        "alias": [],
                        "albumSize": 0,
                        "picId": 0,
                        "fansGroup": null,
                        "img1v1Url": "https://p2.music.126.net/6y-UleORITEDbvrOLV0Q8A==/5639395138885805.jpg",
                        "img1v1": 0,
                        "trans": null
                    }
                ],
                "album": {
                    "id": 78372154,
                    "name": "华纳超极品音色系列",
                    "artist": {
                        "id": 0,
                        "name": "",
                        "picUrl": null,
                        "alias": [],
                        "albumSize": 0,
                        "picId": 0,
                        "fansGroup": null,
                        "img1v1Url": "https://p2.music.126.net/6y-UleORITEDbvrOLV0Q8A==/5639395138885805.jpg",
                        "img1v1": 0,
                        "trans": null
                    },
                    "publishTime": 820425600000,
                    "size": 14,
                    "copyrightId": 7002,
                    "status": 1,
                    "picId": 109951163984007060,
                    "mark": 0
                },
                "duration": 239506,
                "copyrightId": 7002,
                "status": 0,
                "alias": [],
                "rtype": 0,
                "ftype": 0,
                "mvid": 0,
                "fee": 8,
                "rUrl": null,
                "mark": 8192
            },
            {
                "id": 1357375695,
                "name": "海阔天空",
                "artists": [
                    {
                        "id": 11127,
                        "name": "Beyond",
                        "picUrl": null,
                        "alias": [],
                        "albumSize": 0,
                        "picId": 0,
                        "fansGroup": null,
                        "img1v1Url": "https://p2.music.126.net/6y-UleORITEDbvrOLV0Q8A==/5639395138885805.jpg",
                        "img1v1": 0,
                        "trans": null
                    }
                ],
                "album": {
                    "id": 78372827,
                    "name": "华纳廿三周年纪念精选系列 - Beyond",
                    "artist": {
                        "id": 0,
                        "name": "",
                        "picUrl": null,
                        "alias": [],
                        "albumSize": 0,
                        "picId": 0,
                        "fansGroup": null,
                        "img1v1Url": "https://p2.music.126.net/6y-UleORITEDbvrOLV0Q8A==/5639395138885805.jpg",
                        "img1v1": 0,
                        "trans": null
                    },
                    "publishTime": 999273600000,
                    "size": 15,
                    "copyrightId": 7002,
                    "status": 1,
                    "picId": 109951163984013010,
                    "mark": 0
                },
                "duration": 239506,
                "copyrightId": 7002,
                "status": 0,
                "alias": [],
                "rtype": 0,
                "ftype": 0,
                "mvid": 5501497,
                "fee": 1,
                "rUrl": null,
                "mark": 8192
            },
            {
                "id": 469391964,
                "name": "海阔天空",
                "artists": [
                    {
                        "id": 11127,
                        "name": "Beyond",
                        "picUrl": null,
                        "alias": [],
                        "albumSize": 0,
                        "picId": 0,
                        "fansGroup": null,
                        "img1v1Url": "https://p2.music.126.net/6y-UleORITEDbvrOLV0Q8A==/5639395138885805.jpg",
                        "img1v1": 0,
                        "trans": null
                    }
                ],
                "album": {
                    "id": 35336928,
                    "name": "超越BEYOND精选",
                    "artist": {
                        "id": 0,
                        "name": "",
                        "picUrl": null,
                        "alias": [],
                        "albumSize": 0,
                        "picId": 0,
                        "fansGroup": null,
                        "img1v1Url": "https://p2.music.126.net/6y-UleORITEDbvrOLV0Q8A==/5639395138885805.jpg",
                        "img1v1": 0,
         
上一页
获取热搜列表(详细)
下一页
获取搜索建议
Built with