搜索Q音歌单

正式环境

https://api.kg.qq.com

POST

/karaoke/oper/v2/search_qy_songlist

搜索Q音歌单列表，通过关键词搜索Q音平台的歌单。
支持按默认排序、最近更新、播放最多排序。
返回歌单基本信息，包括歌单ID、名称、封面、播放量、歌曲数、标签等。
diss_status字段标识歌单品质：400为优质歌单，410为精品歌单。

歌单歌曲列表，通过综合歌单接口查询https://s.apifox.cn/apidoc/docs-site/951819/80018235e0
playlist_type传qy_playlist。

请求参数

Header 参数

Body 参数application/json

示例

{
    "word": "周杰伦",
    "page_num": 15,
    "num_per_page": 3,
    "sort_type": 0,
    "highlight": 1,
    "nqc_flag": 0
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://api.kg.qq.com/karaoke/oper/v2/search_qy_songlist' \
--header 'X-Open-Access-Token: ' \
--header 'X-Open-Access-Token: ' \
--header 'X-Open-ID: ' \
--header 'X-Open-ID: ' \
--header 'X-Open-App-ID: ' \
--header 'X-Open-App-ID: ' \
--header 'Device-ID: ' \
--header 'Device-ID;' \
--header 'Content-Type: application/json' \
--data '{
    "word": "周杰伦",
    "page_num": 15,
    "num_per_page": 3,
    "sort_type": 0,
    "highlight": 1,
    "nqc_flag": 0
}'

返回响应

🟢200

application/json

Bodyapplication/json

示例

{
    "code": 0,
    "sub_code": 0,
    "msg": "请求成功",
    "data": {
        "total_num": 1520,
        "has_more": true,
        "list": [
            {
                "dissid": "8027178974",
                "dissname": "周杰伦经典歌曲合集",
                "logo": "https://y.gtimg.cn/music/photo_new/T009R500x500M000003abc123.jpg",
                "diss_status": 400,
                "listennum_long": 56789012,
                "listennum_str": "5678.9万",
                "songnum": 50,
                "type": 0,
                "description": "收录周杰伦历年经典歌曲",
                "hotness_desc": "热门歌单",
                "tag_list": [
                    "华语",
                    "流行",
                    "经典"
                ]
            },
            {
                "dissid": "7123456789",
                "dissname": "杰伦的歌适合深夜听",
                "logo": "https://y.gtimg.cn/music/photo_new/T009R500x500M000004def456.jpg",
                "diss_status": 410,
                "listennum_long": 12345678,
                "listennum_str": "1234.6万",
                "songnum": 30,
                "type": 0,
                "description": "适合夜晚安静聆听的周杰伦歌曲",
                "hotness_desc": "",
                "tag_list": [
                    "华语",
                    "安静",
                    "夜晚"
                ]
            }
        ]
    }
}

修改于 2026-05-06 09:21:58

（新）排行榜 Copy

用户信息查询