1. 线路2
小影API
  • 音乐
    • 线路1
      • 搜索音乐
      • 首页推荐
      • 获取歌手信息
      • 获取播放音乐信息
    • 线路2
      • 首页热门搜索
        POST
      • 搜索音乐
        POST
      • 获取音乐播放信息
        POST
  • 翻译
    • 线路1
      • 支持的语言列表
      • 文本翻译 (有道翻译 AI 引擎 - line1 版)
  • 文件上传
    • 线路1
      • 文件上传接口
      • 文件下载接口
  • 插件广场
    • 插件管理
      • 插件列表
      • 创建插件
      • 插件详情
      • 更新插件
      • 删除插件
    • 版本管理
      • 版本列表
      • 添加版本
      • 更新版本
      • 删除版本
    • 图片管理
      • 添加图片
      • 删除图片
    • 视频管理
      • 添加视频
      • 删除视频
  1. 线路2

搜索音乐

开发中
POST
/api/music/line2/search_music/

1. 接口名称#

SearchMusic — 搜索音乐

2. 接口路径#

POST /api/music/line2/search_music/

3. 接口描述#

搜索歌曲宝 (gequbao.com) 上的音乐,同时返回「大家都在搜」关键词。输入关键词后自动 URL 编码拼接搜索 URL,提取搜索结果列表和侧栏热门关键词。

4. 作者#

小影

5. 请求参数#

参数名类型必填说明
keywordstring是搜索关键词,如 你有没有真的爱过我

6. 响应格式#

{
    "code": 10000,
    "message": "成功",
    "data": {
        "keyword": "你有没有真的爱过我",
        "total": 10,
        "hot_keywords": [
            {"keyword": "岁月如笔写春秋", "url": "https://www.gequbao.com/s/岁月如笔写春秋"},
            {"keyword": "立春", "url": "https://www.gequbao.com/s/立春"}
        ],
        "results": [
            {
                "rank": 1,
                "title": "你有没有真的爱过我 - 谈柒柒",
                "artist": "谈柒柒",
                "song": "你有没有真的爱过我",
                "url": "https://www.gequbao.com/music/24625836",
                "music_id": "24625836"
            }
        ]
    }
}

7. 错误码#

codemessage说明
10000成功正常返回
20001参数缺失keyword 为空
40001外部 API 调用失败爬虫请求异常

8. curl 示例#


请求参数

Body 参数application/x-www-form-urlencoded必填

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location '/api/music/line2/search_music/' \
--data-urlencode 'keyword=七里香'

返回响应

🟢200成功
application/json
Bodyapplication/json

示例
{
    "code": 10000,
    "message": "成功",
    "data": {
        "keyword": "七里香",
        "total": 20,
        "hot_keywords": [
            {
                "keyword": "岁月如笔写春秋",
                "url": "https://www.gequbao.com/s/岁月如笔写春秋"
            }
        ],
        "results": [
            {
                "rank": 1,
                "title": "七里香 - 周杰伦",
                "artist": "周杰伦",
                "song": "七里香",
                "url": "https://www.gequbao.com/music/4194",
                "music_id": "4194"
            }
        ]
    }
}
修改于 2026-06-04 11:56:20
上一页
首页热门搜索
下一页
获取音乐播放信息
Built with