搜索音乐

1. 接口名称

SearchMusic — 搜索音乐

2. 接口路径

POST /api/music/line2/search_music/

3. 接口描述

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

4. 作者

小影

5. 请求参数

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

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. 错误码

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

8. curl 示例

返回响应

🟢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"
            }
        ]
    }
}

1. 接口名称#

2. 接口路径#

3. 接口描述#

4. 作者#

5. 请求参数#

6. 响应格式#

7. 错误码#

8. curl 示例#

请求参数

请求示例代码

返回响应

1. 接口名称

2. 接口路径

3. 接口描述

4. 作者

5. 请求参数

6. 响应格式

7. 错误码

8. curl 示例